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 3 regions: US, Europe, and Asia. We use majority voting · 2 of 3 regions must report a failure before an incident is created. This eliminates false positives from regional network issues.
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. There’s also a dedicated SSL certificate page for viewing cert details and a free SSL checker tool.
Monitors transition through five states: up → confirming → down → recovering → up. When a check fails, the monitor enters ‘confirming’ and waits for majority voting across regions before declaring an incident. This prevents false alerts from transient issues.
You can set a configurable response time threshold per monitor. When the response time exceeds your threshold, you’ll receive an alert. Configure this on each monitor’s settings page.
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 majority voting confirms the outage across 2 of 3 regions) and when it recovers. Recovery alerts include the total downtime duration.
The alert activity log shows every alert that was sent, failed, or skipped. Find it in Settings > Alert Activity. Each entry includes the timestamp, channel, monitor name, event type, and delivery status.
When an incident is created or resolved, subscribers to affected status pages are automatically notified via cron-based email delivery. Notifications are batched and sent reliably.
Go to Settings and click ‘Add to Slack’. You’ll authorize PingGuard in your workspace and choose a channel. All incident alerts (down + recovery) automatically post there with rich formatting. You can also use /pingguard check <url> to quickly test any URL from Slack.
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.
On Dev (1 domain) and Pro (unlimited) plans, you can point your own domain to your status page. Create a CNAME record pointing your domain to cname.vercel-dns.com, then add the domain in your status page settings. Vercel auto-SSL handles the certificate automatically.
Uptime badges are embeddable SVG images showing the real-time uptime percentage of your status page. Use the badge URL from your status page settings and embed it in your README, docs, or any webpage. Format: /api/badges/[status-page-slug].svg
Yes. Each status page has an editable title, header note (shown above monitors), and footer note (shown at the bottom). Use these to add context, links, or branding.
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.
Free Tools
A free tool at /check that lets anyone test if a website is up or down. Enter any URL and get an instant result with status code, response time, and SSL info. No account required. Rate limited to prevent abuse.
A dedicated SSL page where you can check any domain’s certificate details including issuer, subject, expiry date, and chain. Useful for quick manual checks before setting up monitoring.
Enter any domain and we scan for all monitorable endpoints — health checks, APIs, auth routes, payment endpoints, and pages. Available from the dashboard and during monitor setup.
Weekly Reports
Every Monday at 8am, Dev and Pro plan users receive an email summary covering uptime percentages, incident counts, and response time trends for all monitors over the past week.
Weekly reports are sent automatically to all Dev and Pro plan users. They provide a concise overview of your infrastructure health.
Security
All API endpoints and public tools are rate limited to prevent abuse. Limits vary by endpoint and plan. Rate limit headers are included in responses.
We validate and sanitize all URLs to prevent SSRF attacks and block requests to internal networks, private IPs, and potentially malicious targets.
Plan limits are enforced on all endpoints. When you exceed a limit (monitors, status pages, etc.), you’ll see a clear upgrade prompt. Existing resources continue running — we never pause your monitoring.