Monitoring

Monitors

Creating, configuring, pausing, and deleting the URLs PingPane watches.

A monitor is one URL that PingPane checks on a schedule. Everything else in the product — alerts, status pages, incidents — is derived from the stream of checks a monitor produces.

Anatomy of a monitor

Each monitor has seven fields:

  • Name — a human-readable label. Shown everywhere a monitor is referenced.
  • URL — the full URL, including https://. Internationalized domain names are supported.
  • Interval — either 60 seconds (Pro) or 300 seconds (Free).
  • Expected status — the HTTP status code(s) that count as success. Accepts a single code (200), a range (200-299), or a comma list (200, 301, 302).
  • Timeout — milliseconds before a check is considered failed. Defaults to 15000.
  • Is active — a monitor can be paused without being deleted. Paused monitors don't count against your plan limits.

Creating a monitor

From the dashboard, click Add monitor and fill the form. The monitor is created in an "unknown" state and the first check fires within ten seconds. Most checks complete in under 200ms.

Pausing vs. deleting

Pausing a monitor stops checks. No new data is recorded. The existing history is preserved and the monitor disappears from your public status page. Pause a monitor when you are doing scheduled maintenance and don't want alerts.

Deleting a monitor removes the monitor, every check it has ever recorded, and every incident it has ever triggered. This is irreversible.

Plan limits

The Free tier allows 3 active monitors at a 5-minute interval. The Pro tier raises the cap to 20 and unlocks the 1-minute interval. If you hit your plan limit, new monitors must be created paused; you can then swap which three (or twenty) are active at any time.

Programmatic access

Monitors can be created, updated, and deleted via the JSON API. See the API reference for authentication and endpoint details.

curl https://api.pingpane.com/v1/monitors \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name":"Marketing site","url":"https://example.com"}'

Related