Page 5 of 8~245 min topic

Disaster recovery lab

Triage and recover disaster recovery

When traffic cut before vector rebuild finishes — fluent ungrounded answers, 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 region-b https://b.rag.example: retryable vs fatal vs needs-human. Retries need budgets, jitter, and idempotency rules aligned to restore validates citation gold set before traffic; corrupt snapshot rejected. The chapter’s signature failure — traffic cut before vector rebuild finishes — fluent ungrounded answers — must take a deliberate branch, not a generic catch-all.

Read

Containment path

Implement the degrade/rollback/refuse behavior DR lead failing over region A → B within RTO 2h / RPO 15m needs when DR-2026-07-30 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

./dr/cut_traffic.sh --to a --reason gold_fail

Read

Verify harm reduction

After containment, check rto_minutes, rpo_minutes, citation_precision_post_restore 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 traffic cut before vector rebuild finishes — fluent ungrounded answers 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 rto_minutes, rpo_minutes, citation_precision_post_restore.

Read

Field notes for `disaster-recovery-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 regional RAG platform restore with PostgreSQL + object storage + vector indexes, the human stakeholder is DR lead failing over region A → B within RTO 2h / RPO 15m, and the incident id you design against is DR-2026-07-30. Re-state the oracle in your notes — drill DR-2026-07-30: restore completes 97m; gold citation_precision ≥ 0.95 — and keep the invariant visible: restore validates citation gold set before traffic; corrupt snapshot rejected. Track rto_minutes, rpo_minutes, citation_precision_post_restore as the scoreboard. Surface under change control: region-b https://b.rag.example. If you only have forty minutes, finish the fixture for traffic cut before vector rebuild finishes — fluent ungrounded answers 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 traffic cut before vector rebuild finishes — fluent ungrounded answers 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: restore validates citation gold set before traffic; corrupt snapshot rejected.

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 DR-2026-07-30?

All responses are required.