The Dog-Eared Procedure: Attesting Failover Runbooks Against Operator Reality
Photo: 玄史生, CC BY-SA 3.0, via Wikimedia Commons
A failover runbook is not proven by its presence in a document repository. It is proven when an operator, under pressure, can follow it from first instruction to recovered service without inventing the missing steps. In many UK regulated estates, that proof is rarely produced. The document is reviewed, formatted and approved, but the operational reality around it has moved on: an interface has changed, a credential has been rotated, a manual DNS step has been automated, or a key contact has left. The runbook remains formally current and practically obsolete.
This is runbook rot. It is not a housekeeping issue. It is a control weakness in the recovery system, because the instructions people actually use during a failover are part of the recovery capability itself.
Rot Is a Control Failure, Not a Documentation Defect
Documentation drift is often treated as an editorial problem: the runbook is out of date, so someone should update it. That framing misses the operational risk. A recovery procedure that cannot be executed as written extends recovery time, increases the chance of skipped controls and creates a hidden dependency on the knowledge of a small number of people. In a regulated environment, that dependency is difficult to evidence and difficult to replace at 03:00 on a Sunday.
The control question is not whether a runbook exists. It is whether the organisation can demonstrate that the runbook has been tested against the environment, the interfaces and the operators it depends on. That requires evidence of use, not just evidence of approval.
Sampling the Deviations That Already Exist
Most organisations already hold the raw material for runbook attestation: post-incident reviews, change records, on-call notes, problem tickets and the informal annotations operators add to printed copies. These artefacts show where the documented procedure and the executed procedure diverged.
A practical attestation cycle begins by sampling those deviations rather than asking authors to rewrite the document from memory. Select a representative set of recent incidents and failover exercises across critical services. For each, compare the documented sequence with what the operator actually did. Record the deviation type: a step skipped, a sequence reordered, a manual workaround substituted, an approval bypassed, or a verification omitted.
Patterns matter. Repeated substitution of a database failover command may indicate that the documented command no longer matches the platform. Repeated calls to a named engineer may indicate an undocumented dependency. Repeated omission of a validation step may indicate that the instruction is impractical under time pressure. Each pattern should be entered in an exceptions register with an owner, a remediation action and a review date.
Replay Under the Clock
Desk review is insufficient. The attestation cycle should include timed replay: operators execute the runbook in a non-production environment or a controlled simulation, using only the documented instructions and the tools they would expect to have available. Observers record where they hesitate, where they leave the document, where they ask for help and where they cannot complete a verification step.
The purpose is not to grade individuals. It is to test the instructional design of the recovery procedure. A runbook that requires an operator to infer a missing prerequisite is not resilient, even if the underlying technology is. Time pressure exposes ambiguity, missing access, unclear ownership and steps that assume context the operator does not have.
Replay should be repeated at a sensible cadence. Annual review is rarely enough for services with frequent change. A tiered approach works better: high-criticality services replayed at least twice a year, medium-criticality services annually, and all runbooks re-attested after material change to architecture, identity, network or supplier arrangements.
A Four-Part Attestation Cycle
A defensible cycle has four parts. First, ownership: every runbook has a named service owner and a technical reviewer, not a document library administrator alone. Second, version linkage: the runbook version is tied to the change record or configuration baseline it depends on, so reviewers can see what moved. Third, execution evidence: the replay produces a dated record of participants, deviations, timings and remediation actions. Fourth, sign-off: the service owner and the relevant control function attest that the runbook is fit for use, or that the identified exceptions are accepted with compensating measures.
This cycle should feed the organisation's risk and control self-assessment rather than sit outside it. A stale runbook is a reportable control weakness when it affects a critical service, because it undermines the recovery objective the control exists to support. Treating it as a documentation defect keeps it below the threshold of management attention.
Evidence the Regulator Can Follow
The output should be an evidence pack that a third party can follow without tribal knowledge. It should show the sampling method, the incidents reviewed, the deviations found, the replay results, the remediation actions and the residual exceptions. It should also show how the organisation prevented the same divergence from recurring: for example, by adding runbook impact checks to change management or by requiring runbook updates as part of release closure.
UK technology leaders should be careful not to turn this into a paperwork exercise. The value lies in the sampling and replay, not in the volume of signatures. A short, well-evidenced attestation for a critical payment service is more useful than a comprehensive library of documents that no operator has tested under load.
The Test Is Recoverability
Runbook rot survives because it is invisible until a failover exposes it. Attestation makes it visible on a controlled schedule. The objective is not perfect documentation. It is a reasonable, evidenced assurance that the instructions people actually use will carry them through the first hour of a failure without improvisation that the organisation cannot see, measure or repeat.