Feature · Activity
Monitors
See if your sites are up and if the main path works after each change.
How it works
Two kinds
- Watch a site opens one address at the interval you select. The check passes when the site answers with the expected status. You can also name text that must be on the page.
- Check the main path runs a short list of steps in order, for example open the home page, then open the sign-in page. A failed step stops the run and the page shows which step failed.
Read the page
Monitors shows the monitors that are down first. Each monitor shows its state, how long it has been in that state, the uptime for 24 hours, 7 days and 30 days, and the last checks.
A monitor goes down after the number of failed checks in a row that you set. One passing check brings it back up.
Run a check
A check runs on its interval. Select Run now to run one at once. A main-path check can also run after each release that your organization records.
What a check can reach
A check opens public addresses only. It sends no password, cookie or key. It cannot reach a private network.
Who can do what
Owners and admins create, change, pause and delete monitors. Members can read them. An organization can have 25 monitors. Results are kept for 31 days.
In Activity
When a monitor goes down or recovers, the change appears in Activity under Checks.
From the help article Monitors, checked against the product on .
What you can do
The operations this feature's screens call. Each one is POST /api/<name>, and the badge says who may call it.
AdmindeleteMonitorMonitors: delete a monitor and its results. The audit events stay.
Types:
{ id: string }returns{ deleted: true }
AdminrunMonitorNowMonitors: queue one check now. Not queued when one is already queued or running.
Types:
{ id: string }returns{ queued: boolean }
MembergetMonitorMonitors: one monitor with uptime and its recent results, newest first.
Types:
{ id: string }returnsMonitorDetail
AdminupdateMonitorMonitors: change a monitor. A new target or expectation starts its status over.
Types:
UpdateMonitorRequestreturns{ monitor: Monitor }
AdmincreateMonitorMonitors: watch a URL (uptime) or check a basic path of HTTP steps on one site. Public addresses only.
Types:
CreateMonitorRequestreturns{ monitor: Monitor }