Page 8 of 8~245 min topic

Runbook lab

Canary and operate runbooks

A second person can reproduce drill INC-INGEST-9021: lag 60→5 minutes in ≤ 25m following runbook v1.4 from a clean checkout and name the owner for INC-INGEST-9021.

~30 min this pageMastery check

1Learn the idea

Read

Clean-room demo

From a fresh clone/directory, run the commands that prove drill INC-INGEST-9021: lag 60→5 minutes in ≤ 25m following runbook v1.4. A second person plays secondary on-call clearing ingest.lag_minutes > 45 and follows your script without coaching. The demo includes limitations: what executable queue-backlog runbook for embedding ingestion pipeline still will not do.

Read

Evidence pack

Bundle: contract snippet, passing tests, metric snapshot for drill_completion_minutes and lag_minutes, security negative probe, rollback note, owner name. Reference INC-INGEST-9021 as the drill you rehearsed. If any item is missing, the ship gate fails even if the happy path dazzles.

Read

Implementation artifact

./scripts/runbook_drill.py --id INC-INGEST-9021 --max-minutes 25

Read

Ownership and next review

For Runbook lab, name the human who gets paged, the review date for thresholds, and the condition that triggers reevaluation. Endpoint ingest worker + queue metrics remains the production surface you operate for executable queue-backlog runbook for embedding ingestion pipeline — not a slide. Keep INC-INGEST-9021 in the handoff template so the next owner inherits the drill.

Read

Stage depth

After the peer demo, schedule the next threshold review date. File a short changelog that mentions INC-INGEST-9021 and the control that addresses it. Archive the evidence pack where your team already stores launch records. Resist rewriting everything “for real production” in one weekend — operate this slice until the metrics bore you, then widen. Final self-check: if telemetry vanished, would you still know to hold? If yes, you learned the operating posture this lane teaches.

Read

Field notes for `runbook-lab` / `mastery-ship`

Trim the demo script until every command is necessary. Record a peer signature line: name, date UTC, pass/fail. File known limitations as bullets, not apologies. Link the evidence pack from the README. Schedule the next game day on a calendar, even if it is solo. Archive the branch tag or release digest you actually shipped. In this chapter the product is executable queue-backlog runbook for embedding ingestion pipeline, the human stakeholder is secondary on-call clearing ingest.lag_minutes > 45, and the incident id you design against is INC-INGEST-9021. Re-state the oracle in your notes — drill INC-INGEST-9021: lag 60→5 minutes in ≤ 25m following runbook v1.4 — and keep the invariant visible: every command is copy-pasteable; mutating steps need change ticket; verify after each step. Track drill_completion_minutes and lag_minutes as the scoreboard. Surface under change control: ingest worker + queue metrics. If you only have forty minutes, finish the fixture for runbook says 'restart something' without naming deployment or verifying lag before polishing UI. Promotion language stays ternary: promote, hold, or roll back based on evidence, not hope.

Go deeper

Before you start

Why this matters

Draft a two-minute demo script that proves drill INC-INGEST-9021: lag 60→5 minutes in ≤ 25m following runbook v1.4 from a clean directory. Include the failure rehearsal for runbook says 'restart something' without naming deployment or verifying lag and the rollback/owner line. If the script needs tribal knowledge, the lab is not shipped.

Check your understanding

Page assessment

Answer from memory. Completion is saved from this evidence, not from opening the next page.

1. Can a peer reproduce without coaching?
2. Does the pack include drill_completion_minutes and lag_minutes and rollback?
3. Is ownership for INC-INGEST-9021-class events explicit?

All responses are required.