Documentation
Everything you need to know about PingRadar — from setup to advanced features.
Getting Started
1. Create an Account
Sign up at /register with your email or use Google/GitHub OAuth. You'll get 20 free monitors with 5-minute check intervals.
2. Add Your First Monitor
Go to Monitors > Add Monitor and choose from 18 protocol types: HTTP, SSL, TCP, UDP, WebSocket, gRPC, SMTP, IMAP, POP3, FTP, DNS, DNSBL, Ping, Heartbeat, PageSpeed, Keyword, SafeBrowsing, or Domain (WHOIS).
3. Set Up Alerts
Navigate to Notifications and add alert channels: Email, Slack, Telegram, Discord, or Webhooks. Create alert rules to link monitors with channels.
4. Create a Status Page
Go to Status Pages to create a public status page for your users. Add monitors, customize branding, and share the URL.
Monitor Types
HTTP/HTTPS
Monitor website uptime, response codes, response time, and keyword matching. Supports GET, POST, PUT, DELETE methods with custom headers and body.
SSL Certificate
Track SSL certificate expiry with alerts at 30, 14, 7, and 1 day before expiry. Validates certificate chain and detects fingerprint changes.
DNS Records
Monitor A, AAAA, MX, CNAME, TXT, and NS records. Get alerted when records change or expected values don't match.
Domain (WHOIS)
Track domain registration expiry via WHOIS/RDAP. Renewal reminders at 60, 30, 14, and 7 days.
TCP / UDP
Monitor any TCP or UDP port: databases (5432, 3306), Redis (6379), custom services. Includes response time tracking.
WebSocket (WS/WSS)
Connect to WebSocket endpoints, optionally send a message and validate the response.
gRPC
Standard gRPC Health Check protocol. Supports TLS and insecure connections.
SMTP / IMAP / POP3
Monitor email servers with TLS support. Checks connection, banner response, and EHLO/CAPABILITY commands.
FTP
Monitor FTP servers. Checks connection and banner response (220 OK). Supports FTPS.
Heartbeat / Cron
Receive pings from your cron jobs and scheduled tasks. Alert if a heartbeat is missed beyond the grace period. Use: curl -X POST https://api.pingradar.online/api/v1/heartbeat/YOUR_TOKEN
Ping (ICMP)
Classic ICMP ping to check host availability. Reports response time and packet loss.
DNSBL
Check if your IP is on DNS blacklists (Spamhaus, Barracuda, SpamCop, SORBS). Alerts if your IP gets listed.
PageSpeed
Measure page load time including TTFB. Set a degraded threshold to alert on slow pages.
Keyword
Monitor page content for keyword presence or absence. Alert if expected text disappears or unwanted text appears.
SafeBrowsing
Check if your URL is flagged as malicious or blocked by browsers.
Alerting & On-Call
Notification Channels
Supported channels: Email, Slack (webhook), Telegram (bot), Discord (webhook), and custom Webhooks. Configure in Settings > Notifications.
Alert Rules
Create rules that link monitors to channels. Trigger on: monitor_down, monitor_up, ssl_expiry, domain_expiry, dns_change, slow_response.
On-Call Scheduling
Set up rotation schedules (daily or weekly) with team members. The system automatically rotates who's on call.
Escalation Policies
Define multi-step escalation: if the first responder doesn't acknowledge within N minutes, alert the next person. Stops on ACK or resolution.
Incident Acknowledgement
When alerted, click 'Acknowledge' to confirm you're working on it. This stops the escalation chain and logs who acknowledged when.
Status Pages
Public Status Pages
Create beautiful public status pages showing your monitors' status, active incidents, and uptime history.
Subscribers
Visitors can subscribe to your status page with their email. They'll be notified automatically when incidents are created or resolved.
Customization
Pro plans: add custom CSS/JS, hide PingRadar branding, add SEO meta tags, and use custom head tags.
Custom Domains
Pro/Business plans: point a CNAME to our servers and serve your status page on your own domain (e.g., status.yourcompany.com).
Password Protection
Protect sensitive status pages with a password. Rate-limited to prevent brute force.
QR Codes & Badges
Generate QR codes for easy sharing and SVG uptime badges for embedding in READMEs or dashboards.
SLA Reports
Uptime Percentage
Real uptime calculation from TimescaleDB check history. Available for 24h, 7d, 30d, or custom date ranges.
Response Time Percentiles
P50, P95, P99 response times computed from raw data. Plus avg, min, max for complete picture.
Hourly Breakdown
Hour-by-hour view of uptime, down time, and response time. Identify patterns and recurring issues.
CSV Export
Export SLA reports to CSV for stakeholder reporting or further analysis.
API & Integrations
REST API
Full REST API with 100+ endpoints. Interactive docs at /docs (Swagger) and /redoc. Authenticate with Bearer tokens or scoped API keys.
API Keys
Create scoped API keys (read-only or read-write) in Settings > API Keys. Use prefix 'pr_live_...' in the Authorization header.
MCP Server
Native MCP (Model Context Protocol) server for AI IDE integration. Manage monitors from Claude Code, Cursor, or Windsurf. 7 tools: list/get/create monitors, list incidents, get uptime stats, pause monitors, get dashboard.
Webhooks
Send real-time events to your endpoints. Supported events: monitor_down, monitor_up, incident_created, incident_resolved. Auto-retry up to 5 times with delivery history.
Email Digests
Weekly or monthly email summaries of your monitoring status. Configure in Settings > Digest.
Plans & Billing
Free Plan
20 monitors, 5-min intervals, 18 protocols, 1 status page, 3 alert channels, 30-day retention. No credit card required.
Starter ($13/mo)
50 monitors, 1-min intervals, 3 status pages, 10 channels, API access, maintenance windows, 90-day retention, 3 team members.
Pro ($29/mo)
200 monitors, 1-min intervals, 10 status pages, SLA reports, custom CSS/JS/domain, 1-year retention, 10 team members.
Business ($79/mo)
500 monitors, 30-sec intervals, 50 status pages, unlimited team, priority support, 2-year retention.
Need help? Contact us at support@pingradar.online