You're reading the docs for v1.4.0, which isn't released yet. Commands here pull :edge, the newest pre-release build. Go to the current release (v1.3.0) →
Core concepts › Monitors & incidents

Monitors & incidents

A monitor is one thing you watch. When enough locations agree it is broken, Uptimer opens an incident.

A monitor describes what to watch: what to request (an HTTP or HTTPS URL, with a method and an optional body), how often (an interval), and the expected response that decides healthy from broken. Uptimer checks it on that interval from every location you assign — the server, or a remote worker — and each check is one report from one location.

When enough of those reports say the same thing, Uptimer opens an incident: the period the monitor was not healthy, what the locations saw, and how it ended. That is what the status badge and the history are showing you.

Checks are HTTP/HTTPS only in this release: no TCP, DNS, ping or keyword types.

Called a rule in the API. The REST API, the Python SDK and import/export call a monitor a rule, and that is not changing. The dashboard is moving to the plainer word first.

Intervals are whole minutes and the scheduler ticks once a minute, so one minute is the finest resolution.

You create monitors in the dashboard or over the API — the dashboard is just an API client. For the exact request/response fields, see the REST API reference.

Monitor status

Every monitor shows one of three statuses:

StatusMeaning
UpEnough locations report the check passing.
DownEnough locations report it failing — wrong status code, missing body substring, or a connection/TLS error.
No DataNot enough locations have reported to decide. Almost always because no location is assigned (a monitor needs at least one), or because the workers serving them have gone quiet.

Alerts fire only on a change between Up and Down — see When an alert actually fires.

How many locations must fail

New in 1.4.0. Status is a decision across all the locations a monitor runs from, not simply the most recent check to arrive. The monitor form has a Locations Required to Fail control:

SettingThe monitor goes Down when
Majority of locations (default)More than half of its locations report a failure.
At least one locationAny single location reports a failure.

A majority stops one unhappy location from raising an incident on its own. A location that never reports is not ignored — it counts as unknown and stays inside the decision, which is why a half-silent monitor reads No Data rather than quietly falling back to whichever location did answer.

With a single location assigned, both settings behave identically.

Confirming and closing

A monitor going bad opens an incident straight away, but nothing is sent for the first 2 minutes — the run has to last that long before the incident is confirmed and an alert goes out. On the way back, an ok run has to last 2 minutes before the incident closes, and the incident is then backdated to the first ok check.

That is what stops a single blip from paging you, and it is why a short outage can appear in the history without ever having produced an alert. These waits are fixed in this release.

Incident history

Changed in 1.4.0. A monitor’s history is now a timeline of its incidents, not a list of every check that ran. Each row is one event, with the locations that caused it:

EventMeaning
pendingSomething started failing. Not confirmed yet, so no alert has been sent.
problemConfirmed failing.
no dataConfirmed, but the locations have gone quiet rather than reported a failure.
recoveringReporting ok again, still inside the close wait.
closedBack to normal. The row carries how long the incident lasted.

The Locations column shows which were failing (red) and which were silent (grey) at that event, plus the error text they reported. Where an event recorded no evidence of its own, the last known evidence is carried forward and marked as such.

Dashboard timestamps use YY/MM/DD order (e.g. 26/07/14 is 2026-07-14).

How checks identify themselves

New in 1.4.0. Every HTTP(S) check sends a User-Agent that names the product and its version:

Uptimer/1.4.0 (+https://uptimer.myuptime.info)

Before this, monitoring traffic arrived as Go-http-client/1.1 — indistinguishable from any other Go program, and it inflated bot metrics in analytics and error trackers.

To exclude Uptimer from analytics or logs, filter on the Uptimer/ prefix — for example User-Agent starting with Uptimer/, which survives version bumps.