Track 08 · Deployment & opsLesson 09 of 11
Incidents, on-call and runbooks
The runbook someone follows at 2am, written before it's needed.
- Lesson library · reference
- 35 min read
- 60 min hands-on
- Pro
What you'll be able to do
01- Classify AI incidents (outage, provider degradation, quality regression, safety or PII leak, cost runaway, tool misuse, provider deprecation) and assign a severity from an agreed matrix.
- Design on-call for an agent inside the customer's estate: PagerDuty services, schedules, escalation policies and event routing, shared with the customer's service desk.
- Write a runbook a stranger can follow at 2am: symptoms, triage queries, mitigations in order of risk, verification and escalation.
- Implement an alert-to-runbook router that deduplicates, groups symptoms with causes, assigns severity and produces a timeline.
- Run a blameless post-incident review with AI-specific forensics, and plan game days that prove the runbooks work.
Before you start
- Retries, fallbacks and failing gracefully: what the agent does by itself before a human is paged.
- Approval gates and bounded autonomy: the autonomy ladder that "autonomy down" moves along.
- Canary releases and staged rollout: flags as kill switches and rollback by version.
- Tracing agents with OpenTelemetry: the traces you triage with.
- SLOs and latency budgets: burn-rate alerts, the main paging signal.
- The audit pack: the evidence you will need afterwards.
The short version
An AI incident is any unplanned event that harms, or threatens to harm, the work the agent does: the classic outage, but also a model provider slowing down, drafts that are fluent and wrong, personal data leaking into telemetry, token spend running away, a tool used outside policy, or a model reaching end of life. Many of these throw no errors, so detection has to include quality checks, guardrail spikes, cost monitors and user reports, not only uptime. Every alert routes through the customer's incident tool (PagerDuty at Halden) to a named on-call responder via a schedule and escalation policy, with severity set by an agreed matrix and a runbook link in the payload. Runbooks list symptoms, triage queries and mitigations in order of risk: kill switch, rollback, model fallback, autonomy down, tenant off. Each mitigation is pre-approved so a stranger can pull it without a meeting. Afterwards, a blameless review produces actions, new monitors and new eval cases. Game days prove all of it before peak.
- Quality incidents are silent. Detect them with deterministic checks and user reports, not error rates.
- Severity is a business judgement written down in advance. If unsure, take the higher one.
- Mitigate first, diagnose second. The levers must exist and be pre-approved before go-live.
- Mitigations are changes. A fallback model can cause the next incident.
- Keep the evidence. You cannot reconstruct a model's output tomorrow; you can only replay what you recorded.
Pro lesson
The rest of this lesson is in Pro.
The mental model, worked example, field note, failure table, exercise and self-check, with the voice tutor.
- Every stage and specialisation, in full
- Every lab and every role project
- Halden weeks 2–10, on your record
- Every drill, live in the playground
- All solutions, plus the server judge
- Lab Assistant and every Teach with AI