Alert Rule Conditions: Uptime Percentage

Alert Rule Conditions: Uptime Percentage

An uptime percentage alert rule fires when your monitor's uptime over a specified time window drops below a threshold. This is ideal for SLA-based alerting and reducing false positives from one-off check failures.


How It Works

Instead of evaluating each check in isolation, PulseAPI looks at the overall uptime percentage across all checks in the time window. If the percentage drops below your threshold, the rule fires.

This means a single failed check out of 1,440 (one minute of downtime in a day) doesn't trigger a Critical alert — you can tune the threshold to match your SLA commitments.


Configuring an Uptime Rule

  1. In the alert rule form, set Condition Type to Uptime Percentage.
  2. Choose an Operator — typically less than (<).
  3. Enter the Threshold as a percentage (e.g., 99.9).
  4. Select the Time Window: 24 hours, 7 days, or 30 days.

Choosing the Right Threshold and Window

SLA 24h Window Threshold 7d Window Threshold
99.9% ("three nines") < 99.9% < 99.9%
99.5% < 99.5% < 99.5%
99% < 99% < 99%

24-hour window — more sensitive; catches degradation quickly. Good for critical services where even a brief dip below SLA is worth alerting on.

7-day window — less sensitive to short outages; catches sustained degradation. Good for SLA reporting and non-critical services.

30-day window — SLA reporting threshold; only fires on sustained, long-term degradation. Use as a summary metric rather than an operational alert.


Uptime Percentage vs. Per-Check Rules

Per-Check Rule Uptime Percentage Rule
Fires on Every single failure Pattern of failures
False positive rate Higher Lower
Detection speed Faster (fires on first failure) Slower (fires after enough failures accumulate)
Best for Mission-critical endpoints SLA monitoring; reducing alert noise

Use both: a per-check Critical rule for immediate notification on failures, plus a per-period Uptime rule for sustained degradation tracking.


Related Articles


Still have questions? Contact support.

    • Related Articles

    • Creating an Alert Rule

      This article walks you through creating an alert rule in PulseAPI. Alert rules define when PulseAPI creates an incident and sends notifications. Prerequisites: At least one notification channel must exist before you can assign it to a rule. See ...
    • Understanding Uptime Percentage

      Uptime percentage is the most commonly used metric for describing service reliability. This article explains how PulseAPI calculates it and how to interpret the numbers. How Uptime Percentage Is Calculated Uptime percentage = (successful checks ÷ ...
    • Alert Rule Conditions: Status Code

      A status code alert rule fires when the check receives an HTTP status code that matches (or doesn't match) your condition. This is the most direct way to detect when an endpoint is down. How It Works After every check, PulseAPI records the HTTP ...
    • Alert Rule Conditions: Response Time

      A response time alert rule fires when a check takes longer than a threshold you define. This article explains how to configure response time rules and recommends sensible starting thresholds. How It Works After every check, PulseAPI records the ...
    • Alert Rule Conditions: SSL Certificate Expiry

      An SSL expiry alert rule fires when your monitor's SSL certificate will expire within a specified number of days. This gives you advance warning before your certificate expires and causes real failures. How It Works PulseAPI reads the SSL certificate ...