Vantage points and confirmation

How the primary checker and the probe regions confirm a failure, what Partial means and why OctoPing alerts when the probes are silent.

Last reviewed

On this page

A site is observed from more than one place. When one place says the site is down and the others say it's up, the disagreement is information, and OctoPing uses it to decide whether to alert. This page describes the vantage points, what each one is for and how a failed check is confirmed.

The vantage points

Vantage pointWhat it does
PrimaryYour main checker. Runs as often as every 30 seconds and drives alerting.
USRegional probe confirming from North America every five minutes.
EuropeRegional probe confirming from Europe every five minutes.
AsiaRegional probe confirming from Asia every five minutes.

All of them send the same request, so a difference between them describes the site and not the monitor. The primary checker decides when a site goes down and when it recovers. The probe regions provide the second opinion.

  • Each probe region reports about every 5 minutes. A result counts as current for 20 minutes, and a region whose newest result is older is shown as stale (no recent data), which is different from up or down.
  • A region that has stopped reporting is left out.
  • The primary checker has its own freshness allowance, which scales with the site's check interval, so a site on a slow interval isn't marked stale between checks.

What happens when the primary check fails

When the primary check fails, OctoPing looks at what the probe regions reported since the failure began. Reports from before the failure, and reports made during a maintenance window, can't confirm or contradict it. There are three verdicts.

VerdictWhen it appliesWhat happens
ConfirmedAny probe report since the failure began also failed, or the probes have nothing to say.The normal down path: the site reads Offline and the down alert goes out once the notification's failure threshold is met.
ContradictedEvery region with a current report saw the site up.The site stays up and reads Partial. No down alert is sent. The failing checks count as up in uptime and outages.
PendingProbes exist, but none has reported since the failure began.The alert is held for up to 10 minutes. After that the failure is treated as confirmed.

"The probes have nothing to say" covers two cases: no probe has reported for the site within 24 hours, and probe silence that has outlasted the 10-minute wait. In both of them the failure is confirmed.

  • A declared outage is never reversed by later healthy probes. Recovery is decided by the primary checker.
  • A contradicted run becomes a real outage the moment any probe region reports a failure.
  • When only some regions are failing, the down alert names them, for example that the site is down from Europe, so a regional routing problem can be told apart from a global outage.

Partial: only the primary checker is refused

Partial means the probe regions reach the site and OctoPing's primary checker doesn't. A firewall or bot rule that blocks the checker's address is the usual cause. Because visitors can reach the site, Partial isn't counted as downtime, and a public status page shows the site as Operational.

OctoPing sends one informational notice per run of failures, instead of a down alert, once the notification's failure threshold is met. It names the regions that see the site up and the status the checker received, and it lists the addresses to allow when they are known. There's no recovery alert, because no down alert was sent.

There are two ways to clear it. Allow the addresses named in the notice on the firewall, or add a Custom HTTP Header under the site's Advanced request settings and write a firewall rule that allows requests carrying that header. The header is sent by the primary checker and the probe regions.

Reading disagreement

What you seeWhat it usually means
All vantage points failThe site is down or unreachable from everywhere.
The primary checker succeeds and one or two regions failA regional routing or CDN problem. The site stays Online, because the primary checker decides the status, and the detail page shows which regions fail.
The primary checker and some regions fail while others succeedA regional problem that the primary checker also sees. The down alert names the failing regions.
Only the primary checker failsPartial: the checker is refused and visitors aren't affected.
A region shows staleThat probe hasn't reported recently. Its last result is no longer evidence.

Each vantage point's latest result and response time are on the site's detail page. For how failures are worded, see the failure reasons page. For how these decisions affect the numbers, see uptime and outages.