Skip to content
statance
MenuClose

Monitors

Uptime monitor types (HTTP, keyword, JSON, TCP, DNS, SSL, domain expiry, heartbeat), configuration fields, regions and how down is decided.

Monitors check things from outside your infrastructure, from Cloudflare’s network.

Common fields

FieldDescription
nameDisplay name.
typehttp, keyword, json, tcp, dns, ssl, domain or heartbeat.
targetURL, host:port or hostname depending on type. Generated for heartbeats.
interval_secHow often to check. Minimum: Free 300s, Pro 60s, Business 60s.
timeout_msRequest timeout, default 10000.
regionsArray of region IDs (below). Limited by plan.
channel_idsRecipients to notify.
configType-specific options.

Types

http

Requests a URL and checks the status code.

  • config.method — GET (default), HEAD, POST, PUT or OPTIONS in the dashboard; the API accepts any method
  • config.headers — object of request headers
  • config.body — request body string
  • config.expected_status — "200-399" (default), or e.g. "200", "200-299"
  • config.follow_redirects — default true

keyword

An HTTP check that also searches the response body.

  • config.keyword — exact, case-sensitive text
  • config.keyword_mode — "contains" (default; fails if missing) or "absent" (fails if present)

json

An HTTP check that parses the response as JSON and compares a value.

  • config.json_path — dot path, e.g. "status.db" or "checks.0.ok"
  • config.json_expected — value to compare (as a string)

tcp

Opens a TCP connection to target in host:port form and measures connect time.

dns

Resolves target via DNS-over-HTTPS.

  • config.record_type — A (default), AAAA, CNAME, MX, TXT, NS
  • config.expected — optional; fails unless an answer contains this string

ssl

Checks the TLS certificate on target: a hostname (port 443 by default) or host:port, e.g. mail.example.com:993.

  • config.days_warning — fail when fewer days remain (default 14)

domain

Domain expiry: reads the registration for target (a domain, e.g. example.com) from RDAP, falling back to classic WHOIS on port 43 for registries without RDAP. Checked every 6 hours — shorter intervals are raised to 6 hours. Available on every plan.

  • config.days_warning — fail when fewer days remain before the registration expires (default 30)

heartbeat

Passive: your job pings Statance. See Heartbeats.

Regions

IDRegion
wnamUS West
enamUS East
weurWestern Europe
eeurEastern Europe
apacAsia Pacific
ocOceania

When is a monitor down?

With several regions, a monitor is marked down when a majority of its regions fail in the same round. With one region, a failed check is retried once automatically before it counts. When the monitor goes down an incident opens and recipients are notified; when it recovers, the incident is resolved and a recovery alert is sent.

Example

curl -X POST https://api.statance.com/v1/monitors \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Marketing site","type":"keyword","target":"https://example.com",
       "interval_sec":60,"regions":["enam","weur","apac"],
       "config":{"keyword":"Sign up","keyword_mode":"contains"}}'

Next: Investigate →