clean-architecture-backend-template/docs/runbooks/cache-stampede-lock-timeout.md

title, category, error_codes, severity, owner, last_updated, status

title	category	error_codes	severity	owner	last_updated	status
Runbook — CACHE_STAMPEDE_LOCK_TIMEOUT (캐시 스탬피드 락 타임아웃)	TRANSIENT_DEPENDENCY	CACHE_STAMPEDE_LOCK_TIMEOUT	P2	oncall	2026-06-15	stub

Runbook: CACHE_STAMPEDE_LOCK_TIMEOUT (runbook://cache/stampede-lock-timeout)

Symptoms

• HTTP 503 with error.code=CACHE_STAMPEDE_LOCK_TIMEOUT
• Multiple concurrent cache misses on same key; lock contention

Diagnosis

• Check cache hit ratio metrics
• Identify cache keys with high miss rates

Action

• Verify stampede lock TTL is configured appropriately
• Pre-warm cache for high-traffic keys on startup

Escalation

• Escalate if backend load spike accompanies stampede

---

Stub: Phase D2 — author body after domain adoption. (feature-operational-runbook-contract D9)