How-to
Investigating an Alert
Read the AI brief, follow the playbook, check the incident context, and act — without having to know every detector's internals.
Jump to section
The shape of an alert page
Every alert page is organised top-to-bottom for how an operator actually reads an incident:
- Header — severity, status, and a live-state pill that tells you whether the underlying condition is still happening.
- What happened — a one-sentence summary in natural language. "🇬🇧 Cloudflare (AS13335) · GB is sending 2.7× its normal traffic — 1.23k req/min vs. 450 baseline."
- The AI brief — a card titled "What happened, in plain English": a few sentences explaining what tripped, why it matters for a storefront, and what to look at first. It is written by AI from the alert's own data; the numbers and any drafted rule come from the deterministic pipeline, not the AI. See Plain-English Summaries.
- Incident banner — if other detectors are currently firing on the same target, a banner tells you this alert is part of a correlated incident, how many detectors agree, and the combined confidence. Click through to investigate once instead of per-alert. See Correlated Incidents.
- What to do — a detector-specific playbook with 3–5 concrete actions, plus a "When to close" criterion.
- Stop this now — where the alert maps to a blockable pattern, the drafted eCDN rule with copy-paste text and (on Growth and above, for owners) a one-click Apply on my eCDN button. See Applying and Rolling Back Protections.
- Related open alerts — other alerts sharing the same target or the same detector kind.
- Event timeline — what happened when, in plain English.
- Rule details — the raw detector mechanics (thresholds, window sizes, context). Collapsed by default; for SREs.
Live / Cooling / Stale
Every alert has a small coloured pill near the header:
- Live (red, pulsing) — the detector evaluated this within the last 5 minutes. The underlying condition is ongoing.
- Cooling (amber) — 5–60 minutes since last update. The condition may have just stopped.
- Stale (grey) — more than an hour since last update. The incident has likely passed even if the alert is still technically open.
Use this to prioritise: Live alerts need attention now; Stale alerts can usually be resolved without investigation. Open alerts refresh automatically every 30 seconds while you have the page open, so you can watch a condition cool without reloading.
Severity
- Info — worth knowing about, not urgent
- Warning — the detector's primary threshold tripped
- Critical — threshold exceeded by 3× or a novel condition (e.g. new-traffic ASN from a type we expect clean traffic from)
Severity is shown as a coloured left-rail on the Alerts list and as a pill on the detail page.
The Alerts list
The Alerts page groups open alerts by detector kind into collapsible sections, with chip-style filters across the top. Click a chip to narrow to one detector. The list shows an honest "Showing X of Y" total with a Load more control, and refreshes automatically every 30 seconds on the open-alerts tab.
Acknowledging vs resolving
- Acknowledge — "I've seen this, I'm investigating." The detector keeps evaluating. The alert moves to the Acknowledged tab, stops appearing in the unread count, but continues to update if the condition persists.
- Resolve — "I've taken action (or the condition cleared)." The alert moves to Resolved and stops updating.
Most detectors auto-resolve when the condition clears (e.g. an ASN's ratio drops below the multiplier for a sustained period). Manual resolution is for when you've applied a rule or decided to accept the alert.
When to close — the "When to close" hint
Every detector has a specific close criterion written into its playbook. Example from ASN Spike: "Close when this (ASN, country) pair's ratio returns below 1.5× the type-specific multiplier for 15 minutes, or when a mitigation is in place."
This takes the "have I done enough?" guesswork out of resolution. If the criterion is met, close. If not, acknowledge and keep watching.
Pausing alert emails
If you're in the middle of a known incident and don't want more notifications, use Settings → Pause alert emails. Detectors keep firing and building an audit trail; webhooks still fire (so on-call integrations keep working); email, Teams, and Slack messages stop until you resume. See Pausing Alert Emails.