Night Mode LabsBlue Book
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.

On this page