Manuals / Documentation Systems / Chapter 5

B · Decisions · intermediate · ~40 min · Chapter 5 of 9

Runbooks for humans at 2am

Symptoms → diagnosis checks → mitigate → escalate → verify. Short. Executable. Owned.

Path progress
56%

Step 1 of 1

Write a runbook

  • Symptoms
  • Checks
  • Mitigations
  • Rollback
  • Escalation contacts
  • Last verified
Write a runbookDrag stickies · tap for tips
Study mapDrag stickies · tap for tipsKeep it shortdrag · tap →Name the waitdrag · tap →Scope locatorsdrag · tap →Trace when stuckdrag · tap →One browser firstdrag · tap →Isolate statedrag · tap →Assert the UIdrag · tap →Retry wiselydrag · tap →Seed datadrag · tap →Close the loopdrag · tap →Keep it shortdrag · tap →Name the waitdrag · tap →Scope locatorsdrag · tap →Trace when stuckdrag · tap →One browser firstdrag · tap →Isolate statedrag · tap →Pathwise hackdrag · tap →Write a runbookdrag · tap →Try thisdrag · tap →Follow the dashed drag · tap →

Do this now

One runbook for a real alert or failure mode. Dry-run the steps.

Was this step clear?
Chapter learning outcomes
  • Runbook structure
  • Verification
  • Ownership

Clear these before you leave