Page 5 of 8~245 min topic

Postmortem lab

Triage and recover postmortems

When action 'be more careful' with no owner — recurrence in 6 weeks, the system must degrade on purpose without widening blast radius.

~35 min this pageFailure handling

1Learn the idea

Read

Classify and bound retries

Map failure classes for summarization service: retryable vs fatal vs needs-human. Retries need budgets, jitter, and idempotency rules aligned to actions are owned, dated, verifiable; contributing factors include process not only code. The chapter’s signature failure — action 'be more careful' with no owner — recurrence in 6 weeks — must take a deliberate branch, not a generic catch-all.

Read

Containment path

Implement the degrade/rollback/refuse behavior EM facilitating review of INC-SUM-TOK-87 needs when INC-SUM-TOK-87 repeats. Prefer scoped controls (one flag, one weight, one tenant, one secret version) over fleet-wide restarts. Preserve evidence; do not delete logs to “clean the demo.”

Read

Implementation artifact

Read

What didn't work

Paging only on CPU — missed application 5xx for 9 minutes.

Read

Verify harm reduction

After containment, check actions_closed_on_time and recurrence_90d moves in the safe direction and watch for retry amplification. Write the stop condition that ends the incident response for this lab.

Read

Stage depth

Chaos note: inject only one fault class at a time and restore fixtures after. Watch for dual failures — dependency down and retry amplifier — which is how action 'be more careful' with no owner — recurrence in 6 weeks becomes an outage. Customer communication templates (even if only for the drill) beat silence. If you queue deferred work, define poison-message handling. Budget documents should state the maximum extra spend allowed during retries. Close the loop by linking the containment action to a dashboard panel for actions_closed_on_time and recurrence_90d.

Read

Field notes for `postmortem-lab` / `failure-handling`

Draw a state diagram for degrade modes and put it in the repo as ASCII if needed. Cap concurrent retries across the process, not only per request. Ensure cancellation propagates to downstream HTTP clients. When failing closed, choose a user-visible message that does not leak internals. Practice the single command that flips the kill switch or weight to zero. After recovery, drain or inspect deferred work before declaring green. In this chapter the product is blameless postmortem for tokenizer-induced summarization outage, the human stakeholder is EM facilitating review of INC-SUM-TOK-87, and the incident id you design against is INC-SUM-TOK-87. Re-state the oracle in your notes — postmortem published with 3 actions; action A1 verified by test that fails on old tokenizer pin — and keep the invariant visible: actions are owned, dated, verifiable; contributing factors include process not only code. Track actions_closed_on_time and recurrence_90d as the scoreboard. Surface under change control: summarization service. If you only have forty minutes, finish the fixture for action 'be more careful' with no owner — recurrence in 6 weeks 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

Assume action 'be more careful' with no owner — recurrence in 6 weeks is happening right now. Write the first safe action, the signal that confirms containment, and the action you will not take (infinite retry, broad restart, deleting evidence). Tie the plan to invariant: actions are owned, dated, verifiable; contributing factors include process not only code.

Check your understanding

Page assessment

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

1. Are retry budgets explicit?
2. Is containment scoped?
3. Do you preserve evidence for INC-SUM-TOK-87?

All responses are required.