Documentation
Help Center
Everything you need to know about PingGuard.
Getting Started
Go to Dashboard > Add Monitor, paste any URL, choose your method (GET/POST/HEAD), set the check interval, and pick your alert channels.
Enter a domain in Dashboard > Discover and we’ll scan for all monitorable endpoints automatically: health checks, APIs, auth routes, payment endpoints, and pages.
Depends on your plan: Free (5 min), Dev (1 min), Pro (30 seconds). The pinger runs continuously and respects your configured interval per monitor.
GET, POST, and HEAD. GET is the default and works for most endpoints. Use HEAD for lightweight checks or POST when your endpoint requires it.
Monitoring
Each URL you monitor counts as one monitor against your plan limit. A single domain can have multiple monitors (e.g., homepage, API, health check).
Checks run from multiple geographic regions to reduce false positives. If one region reports an issue but others don’t, we won’t trigger an alert.
Yes. On the monitor detail page, click Pause to temporarily stop checks without deleting the monitor or its history. Click Resume to restart.
For HTTPS monitors on Dev and Pro plans, we extract the TLS certificate details including expiry date, issuer, and subject. You’ll get alerts before your cert expires.
Alerts
Email (always on, via Resend) and Webhooks (generic HTTP POST to any URL, available on Dev and Pro plans).
We POST a JSON payload to your configured URL with event type, monitor details, status code, response time, error message, and timestamp. An X-PingGuard-Event header is included for routing.
Yes. Go to Settings > Alert Channels and click the Test button next to any configured channel. A test alert will be sent immediately.
Alerts are sent when a monitor goes down (after the consecutive failure threshold is met) and when it recovers. Recovery alerts include the total downtime duration.
Status Pages
Create a status page in Dashboard > Status Pages, select which monitors to include, and share the /status/your-slug URL with your users.
A branded dark-themed page with per-monitor uptime bars (up to 90 days based on your plan), current status, and a date-grouped incident timeline.
Yes. Each status page has a Subscribe button where visitors enter their email. They’ll receive branded notifications when incidents are created or resolved.
Free: 1, Dev: 3, Pro: unlimited. Each status page can include any number of your monitors.
Incidents
When a monitor fails the configured number of consecutive checks (default: 2), an incident is created automatically with the error details.
When a previously-down monitor returns a successful check, the incident is automatically resolved with the duration calculated, and a recovery alert is sent.
Incidents are resolved automatically when the monitor recovers. The system tracks the full timeline from detection to resolution.
Plans & Billing
Free: 5 monitors, 5 min intervals, email only, 1 status page. Dev ($9/mo): 50 monitors, 1 min, email + webhooks, 3 status pages. Pro ($19/mo): 200 monitors, 30s, all features + API.
You’ll see an upgrade prompt when creating monitors. Existing monitors continue running. The API returns a 403 with a clear message about which limit was hit.
On Dev and Pro plans, you can add monitors beyond your plan limit in blocks of 10 for $3/month each.
Yes. Both Dev and Pro plans include a 14-day free trial with full access. No credit card required.
API
API access is available on the Pro plan. Generate an API key from Settings > API Keys. Keys are prefixed with pg_live_ and hashed with SHA-256.
Create and manage monitors, query status and uptime data, list incidents, and manage status pages. Full REST API with JSON responses.
Pro plan: 1,000 requests per hour. Rate limit headers are included in every response so you can track usage.