Uptime monitoring
Every uptime monitor in SiteQwality follows the same lifecycle: configure → run on schedule → emit results → trigger notifications on state change. What differs is what the monitor checks.
| Check type | What it checks | Use for |
|---|---|---|
| HTTP | A URL responds with the expected status, body, and latency | Websites, APIs, webhook receivers |
| SSL/TLS | A certificate’s expiry, chain, and validity | Anything served over HTTPS |
| DNS | A domain resolves to expected records | Apex/subdomain availability |
| Cron heartbeat | A scheduled job pinged on time | Backups, ETL, batch jobs |
| Browser | A full Playwright script passes in a real Chromium | Login flows, checkout, multi-page journeys |
Picking the right check
Section titled “Picking the right check”- You have a URL that should be
200 OK. Use HTTP checks. You can also opt-in to a paired TLS check (cert expiry) and DNS check (resolver health) on the same monitor. - You only care about cert expiry, not whether the site is up. Use SSL/TLS checks. Otherwise, just enable the TLS sub-check on your HTTP monitor.
- You only care about DNS, not HTTP. Use DNS checks — useful for apex domains where there’s no HTTP server.
- You have a cron job that should run every N minutes. Use a cron heartbeat — your job pings SiteQwality at the end of each successful run; SiteQwality alerts when it doesn’t.
- You need to validate a multi-step user flow. Use browser checks — write a Playwright script, SiteQwality runs it on schedule and captures a HAR + video on failure.
Cross-cutting concerns
Section titled “Cross-cutting concerns”Regions
Section titled “Regions”By default checks run from aws-us-east-1. Multi-region is paid; available regions:
aws-us-east-1— N. Virginiaaws-us-east-2— Ohioaws-us-west-1— N. Californiaaws-eu-west-2— London
Set min_healthy_regions to control how many regions must report healthy before the monitor’s overall status is considered healthy. Set it equal to the region count for unanimity, or to 1 to tolerate any single-region blip.
Schedules
Section titled “Schedules”| Check type | Minimum interval (free) | Minimum interval (paid) |
|---|---|---|
| HTTP | 60 s | 30 s |
| Cron heartbeat | n/a | n/a — driven by your job’s ping cadence |
| Browser | 5 min | 5 min |
| TLS, DNS (paired with HTTP) | inherits HTTP | inherits HTTP |
Every monitor accepts a tags: string[] field. Use tags consistently — service:api, env:prod, team:platform — and you can:
- Match maintenance windows to silence by tag.
- Filter dashboards and alerts by tag.
- Roll up uptime by service or environment.
Services (logical grouping)
Section titled “Services (logical grouping)”Beyond tags, you can attach a monitor to a service (service_id). Services are higher-level groupings — see Services in the dashboard.
See also
Section titled “See also” HTTP checks The most common monitor — request a URL, assert on the response.
SSL/TLS checks Track cert expiry on its own or paired with HTTP.
DNS checks Verify resolver answers for any record type.
Cron checks Receive heartbeats from your scheduled jobs.
Browser checks Real Chromium running your Playwright script.