Glossary
Failure threshold
A failure threshold is the number of consecutive failed checks a monitor needs before it alerts, so one brief blip does not page anyone.
Also called Confirmation period, Retries before alert, Consecutive failures.
A failure threshold means the number of consecutive failed checks required before a monitor raises an alert or declares an incident. It is also called a confirmation period or retries before alert. At one, the monitor alerts on the first failure and every transient blip becomes a page. At two or three, brief failures are absorbed and only a sustained problem raises anything. It is the simplest and most effective control over false alarms that monitoring offers.
The cost is arithmetic and entirely predictable: each additional required failure adds one check interval to detection. Two failures at a one-minute interval means an outage is announced roughly two minutes in; the same threshold at five minutes means ten. This is why the interval and the threshold are one decision rather than two.
The important design question is what the threshold gates. It should gate ALERTING, not measurement. If a below-threshold failure is discarded rather than recorded, short outages vanish from your uptime figures entirely and the availability number becomes a fiction — the monitor is asserting that a failure it observed did not happen. Recording the failure and merely declining to page for it keeps both facts true.
Recovery should not have a threshold at all, or should have a much smaller one. Waiting for confirmation before believing bad news is prudence; waiting for confirmation before believing good news keeps an incident open after it has ended and delays the all-clear to everyone watching.
| Failed checks in a row | Alert after, checking every minute | Alert after, checking every 5 minutes | Good for |
|---|---|---|---|
| 1 | About 1 minute | About 5 minutes | Checks where any failure needs a person at once |
| 2 | About 2 minutes | About 10 minutes | Most monitors: a single network blip is absorbed at the cost of one interval |
| 3 | About 3 minutes | About 15 minutes | Endpoints known to fail now and then without affecting anyone |
| 5 | About 5 minutes | About 25 minutes | Low-priority checks where a short outage can wait |
| 10 | About 10 minutes | About 50 minutes | Background jobs that recover on their own; the most Uptimely allows |
Questions
What does failure threshold mean?
It is the number of failed checks in a row a monitor waits for before it alerts. With a threshold of 2, one failed check is recorded but pages nobody; a second consecutive failure raises the alert.
What is a good failure threshold?
Two suits most checks: it absorbs a single network blip and costs one extra check interval. Use 1 where any failure must be acted on at once, and 3 or more for endpoints that are known to be noisy.
Does a failure threshold hide downtime?
It should not. A threshold should delay the alert, not erase the failure. In Uptimely a failed check below the threshold still counts as downtime and still shows on the status page; it only stops short of declaring an incident.
How long does a failure threshold delay an alert?
About the threshold multiplied by the check interval. Two failures at a one-minute interval is roughly two minutes; at five minutes it is roughly ten.
Is a failure threshold the same as retries?
They are close but not the same. A retry re-runs one check straight away, within seconds, to rule out a momentary glitch. A failure threshold waits for whole checks, one interval apart, to fail in a row. Uptimely does both: a failed check that would mark a monitor down is re-run once before it counts, and the threshold then decides when to alert.
In Uptimely
Uptimely monitors declare an incident after two consecutive failed checks by default, configurable from one to ten per monitor. The threshold gates declaring only: the status still flips, the failed check is still recorded as downtime, and it still appears on the status page and in the uptime figure. Recovery is immediate on the first passing check. Each counted check has itself already been re-run once for confirmation, so the default is four agreeing probe attempts.
Uptimely declares an incident after 2 consecutive failed checks by default, and you can set anywhere from 1 to 10 per monitor.
Start monitoring free →Read next
Related terms
Part of the Uptimely monitoring glossary — plain definitions of the vocabulary uptime monitoring, incident response and status pages are discussed in. Something here read wrong to you? Email support@getuptimely.com.