Skip to content
BENIBIX Learn

Runbook

Infrastructure📟 ReliabilityIncident Response

Also known as Playbook (Operations), Operations Runbook, Run Book

Written steps to fix a known problem. Anyone can follow them, even when tired.

Think of it like

It is like the steps on a fire safety card. You follow them without having to think.

Example

The disk full alert links to a runbook. It lists the command to find big files, which logs are safe to delete and when to call for help.

Why it matters

It puts what the best expert knows into the hands of whoever is on call.

Definition

A runbook is a written set of steps for a known task or problem. It says what to check, what to type and what to expect back. A good alert links to the runbook for it. Then a tired person at 3 a.m. can fix the problem safely. The most used runbooks are often turned into scripts later.
The runbook is used in the middle step. It turns a page into a fix.

Common mistake

Writing a runbook once and never updating it. Steps that no longer work are worse than none.

Key takeaways

  1. 1
    Step by step. What to check, type and expect.
  2. 2
    Linked from alerts. The alert points to its runbook.
  3. 3
    Kept current. Fixed every time a step goes stale.

Compare