Skip to main content

Runbook Template

Type: RunbookCreated: Team: Platform
published

Symptom​

How the problem shows up — what you see in dashboards, logs, or user reports.

Impact​

Who's affected? Customer-facing? Blocking something downstream?

Diagnosis​

Step-by-step checks to confirm this is the right runbook and find the cause.

  1. Check X — if you see Y, go to step 4.
  2. Check Z — …

Fix​

The exact, copy-pasteable steps to resolve it.

# example
kubectl ...

Verification​

How do you know the fix worked? What should you see?

Escalation​

If the fix doesn't work — who to page, and what info they need.

  • ADRs that shaped the system behind this problem
  • Runbooks for adjacent issues