Comparison
RunbookvsToil
Runbook
the alert links to a page that tells the person on call what to check and what to do, at four in the morning.
Written procedure for diagnosing and mitigating a specific alert. It converts institutional knowledge into something a tired non-expert can execute. Runbooks rot faster than code because nothing fails when they go stale, so linking them from the alert is what keeps them honest.
Full entry →Toil
you did the same twenty-minute manual runbook every Tuesday for a year.
Manual, repetitive, automatable operational work that scales with the size of the system and produces no lasting value. It is worth naming because it hides: each instance is small and doing it feels like being helpful. The SRE convention of capping it — measuring what fraction of a team's time it consumes and treating a breach as a signal to invest — turns a slow drain into a visible, arguable number.
Full entry →