Templates
Runbook Template
Runbooks help responders act quickly during incidents and routine operations. Keep them short, tested, and linked from the service catalog and alerts.
Template
# Runbook: Service or operation name
## Purpose
What this runbook is for and when to use it.
## Owners
- Owning team:
- Escalation channel:
- On-call rotation:
## Signals
- Alert name:
- Dashboard:
- Logs:
- Traces:
- Customer symptom:
## Triage
1. Confirm the alert or user impact.
2. Check current deployment and recent changes.
3. Check dependency health.
4. Identify scope: users, region, environment, or service.
## Mitigation
- Immediate mitigation option:
- Rollback or disablement path:
- Feature flag or traffic control:
- Safe restart or recycle steps:
## Verification
- Health check:
- Dashboard panel:
- Synthetic check:
- Customer-facing verification:
## Escalation
When to escalate and who to contact.
## Follow-up
What evidence, timeline notes, or backlog items should be created.Quality bar
A useful runbook has been exercised by someone who did not write it. If the runbook only works for the original author, it is tribal knowledge with markdown formatting.