Alerts

Rules that decide when a notification fires. Default: any DOWN check fires immediately. Tune the threshold to absorb single-check flakiness.

When alerts fire

Without any custom alert, a monitor opens a DowntimeEvent on the first DOWN check and notifications fire immediately. Add a THRESHOLD alert to require N consecutive DOWN checks before alerting — useful for noisy networks where one in 50 HTTP probes randomly times out.

INCIDENT vs THRESHOLD

  • INCIDENT — fire on the open of every DowntimeEvent (the default).
  • THRESHOLD — fire only after threshold consecutive DOWN checks.

Use it via the API

curl https://monitorah.com/api/v1/alerts \
  -X POST \
  -H "Authorization: Bearer mon_live_…" \
  -H "Content-Type: application/json" \
  -d '{"monitorId":"mon_abc","type":"THRESHOLD","threshold":3}'

Full reference for this endpoint →