Cloud Auto-Sync & Archiving
Automatically offload encrypted daily performance telemetry, Core Web Vitals datasets, and SLA audit summaries directly into your personal cloud storage.
Zero-Knowledge AES-256-GCM Cryptography
Your credentials are never stored in plaintext
When you connect your Google Drive, Dropbox, or AWS S3 bucket, Pingzo encrypts all OAuth access tokens, refresh keys, and IAM secret keys at the application level using AES-256-GCM (Galois/Counter Mode). Each record is encrypted with a unique, cryptographically random 16-byte Initialization Vector (IV) and protected with an authentication tag before it touches the database.
1. Google Drive Integration (2-Minute Setup)
Directly stream daily CSVs to a dedicated Google Drive folder
Pingzo requests the restricted .../auth/drive.file scope. This grants Pingzo permission only to files and folders created by Pingzo (e.g. your Pingzo Backups folder). Pingzo has zero access to your personal documents, spreadsheets, or existing Google Drive files.
Step-by-Step Instructions:
- Open the Google OAuth 2.0 Playground .
- In the left panel under Step 1: Select & authorize APIs, scroll down to Drive API v3.
- Check the box for
https://www.googleapis.com/auth/drive.file. - Click the blue Authorize APIs button at the bottom of the left column, and sign in with your Google account.
- Under Step 2: Exchange authorization code for tokens, click Exchange authorization code for tokens.
- Copy the
access_tokenvalue (or the entire JSON block), return to your Pingzo Dashboard, paste it into the token field, and click Save & Encrypt Credentials.
Once connected, click Test Sync Now. Pingzo will immediately verify authorization, automatically create a Pingzo Backupsfolder in your Google Drive if it doesn't exist, and upload your first live CSV report in under 3 seconds.
2. Dropbox Integration
Archive telemetry directly to your scoped Dropbox App folder
Step-by-Step Instructions:
- Visit the Dropbox App Console .
- Click Create App and select:
- API: Scoped access
- Type of access: App folder (isolated sandbox directory)
- Name your app: e.g.
Pingzo Telemetry Backups
- In the Permissions tab, check
files.content.writeandfiles.content.read, then click Submit. - In the Settings tab, scroll down to OAuth 2: Generated access token and click Generate.
- Copy the generated token (
sl.u...) and paste it into Pingzo under Connect Dropbox.
3. AWS S3 & S3-Compatible Storage
Stream datasets to AWS S3, Cloudflare R2, MinIO, or Wasabi
Minimal Least-Privilege IAM Policy:
Attach the following IAM JSON policy to your dedicated backup user or role:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject"
],
"Resource": "arn:aws:s3:::your-bucket-name/*"
}
]
}Cloudflare R2 Setup:
In the Cloudflare Dashboard, go to R2 > Manage R2 API Tokens. Set Endpoint URL to:https://<ACCOUNT_ID>.r2.cloudflarestorage.com
MinIO & Wasabi:
Provide your custom host endpoint URL in the Endpoint field (e.g. https://s3.wasabisys.com) along with your API access and secret keys.
Exported Dataset Schema Breakdown
Every export is generated with standardized RFC-4180 compliant CSV formatting named pingzo_telemetry_export_YYYY-MM-DD.csv:
| Column Name | Type | Description |
|---|---|---|
| Monitor ID | String | Unique system identifier for the monitor check. |
| Name & Target | String / URL | Friendly monitor label and host/IP address. |
| Type & Port | String / Int | Protocol type (http, port_tcp, port_udp, ping) and socket port. |
| Status & Interval | Enum / Min | Live health status (up, down, degraded) and check frequency in minutes. |
| Keyword Rule | String | HTML / API payload keyword assertion rule (contains / not contains). |
| Blacklist Status | Enum | Anti-spam DNSBL listing status (clean or listed). |
| SSL Expires | Date (ISO) | Certificate expiration date or N/A for non-TLS targets. |
| Total Incidents | Integer | Cumulative downtime incident count recorded during the period. |
Frequently Asked Questions & Troubleshooting
Why did I receive a 401 UNAUTHENTICATED error on test sync?
Google Drive and Dropbox OAuth access tokens expire over time. If you receive a 401 error, simply click the Trash icon to disconnect the integration, generate a fresh token from the OAuth Playground or App Console, and reconnect.
What time does the automated nightly sync execute?
Automated daily offloading runs at 03:00 UTC every night. Weekly backups execute every Sunday at 03:00 UTC.
Can I export a manual CSV without connecting a cloud provider?
Yes! Click the Export Live CSV Snapshot button at the top of the Cloud Auto-Sync dashboard tab to immediately download your workspace telemetry dataset directly to your local computer.