Statuses
The statuses a site and a heartbeat can have in the app and on a public status page, and the order in which the rules apply.
Last reviewed
On this page
A site has one status at a time. The app, the status page and the uptime badge all read it from the same rule, so they can't disagree about a site. This page lists the statuses, the order in which the rules apply and what the public sees.
Statuses in the app
The rules apply from the top of the table down, and the first one that matches decides. A workspace whose monitoring is paused shows its sites as Paused. Only a few values are stored: a site is remembered as up, down or unknown, and the other statuses are worked out when you read the site.
| Status | Colour | Meaning |
|---|---|---|
| Disabled | Gray | The site is switched off. Nothing is checked, and this wins over every other state. |
| Maintenance | Blue | A maintenance window is running. Planned work outranks every check result below, so a site that is down inside a window reads Maintenance. |
| Offline | Red | The latest confirmed check failed. |
| Partial | Amber | OctoPing's own checker is being refused while every probe region reaches the site. The site counts as up. |
| Degraded | Amber | The site answers, but its latest response was slower than the site's Response Time Alert Threshold. |
| Online | Green | The latest check succeeded, and the response wasn't slow. |
| Pending | Gray | The site is on, but no check has finished yet. |
Content changes are an event and not a status. A site that changed its page text in the last 24 hours shows a Changed chip next to its status, so a site can be Online and Changed at the same time.
When a site turns Offline
A failed check doesn't make the site Offline straight away. OctoPing first weighs it against the probe regions, as described on the vantage points page. A failure the probes back up, or that they can't speak to within the confirmation wait, turns the site Offline. A failure every probe contradicts leaves it up and shows Partial.
The status and the alert are two decisions. Offline starts at the first confirmed failure. The down alert waits until the notification's number of consecutive failures is reached (3 on the default email notification), and repeats no more often than the notification's repeat interval.
Heartbeat statuses
Heartbeats use their own four statuses. The same order applies: the first match wins.
| Status | Meaning |
|---|---|
| Paused | The heartbeat is switched off, or the workspace's monitoring is paused. |
| Maintenance | A maintenance window is running. |
| Healthy | Pings are arriving before the deadline. |
| Unhealthy | The deadline passed without a ping. |
Statuses on a public status page
A public page uses a shorter vocabulary. Visitors see whether something is available, so internal states such as Disabled don't appear by name.
| Public status | Shown as | Comes from |
|---|---|---|
| operational | Operational | Online and Partial |
| degraded | Degraded | Degraded |
| down | Down | Offline |
| maintenance | Under maintenance | Maintenance |
| unknown | Unknown | Pending and Disabled |
Partial reads Operational on a public page because visitors can reach the site, and only OctoPing's checker was refused. On the page's 90-day bars the same days draw as successful days. Heartbeats map Healthy to Operational, Unhealthy to Down and Maintenance to Under maintenance.
The banner at the top of the page folds the item statuses into one, using the first rule that matches.
| Banner | Shown as | Rule |
|---|---|---|
| major_outage | Major Outage | At least one item is down. |
| degraded | Some Systems Degraded | No item is down and at least one is degraded. |
| maintenance | Under Maintenance | No item is down or degraded and at least one is under maintenance. |
| operational | All Systems Operational | Everything else. |
An item with the status Unknown doesn't change the banner, which treats it like Operational.
Incidents override monitoring
While an incident is open on a status page, the impact set for a component replaces the status monitoring would show for it. Degraded performance and partial outage show as Degraded, and major outage shows as Down. The banner is worked out after the override, so an incident that marks a component down outranks that component's maintenance.
Related
- DocsVantage points and confirmationHow the primary checker and the probe regions confirm a failure, what Partial means and why OctoPing alerts when the probes are silent.
- DocsUptime, downtime and outagesHow uptime percentage, downtime and outage counts are computed, why they don't add up to each other and how maintenance and probe results change them.
- DocsChecks referenceWhat each of the eight checks and heartbeats measures, whether it is on by default, how often it runs and what counts as a failure or a change.