--- title: Runbook — CACHE_STAMPEDE_LOCK_TIMEOUT (캐시 스탬피드 락 타임아웃) category: TRANSIENT_DEPENDENCY error_codes: [CACHE_STAMPEDE_LOCK_TIMEOUT] severity: P2 owner: oncall last_updated: 2026-11-07 status: 초안 --- # Runbook: CACHE_STAMPEDE_LOCK_TIMEOUT (`runbook://cache/stampede-lock-timeout`) ## 증상 - HTTP 503, `error.code=CACHE_STAMPEDE_LOCK_TIMEOUT`. - 같은 키에 캐시 miss가 동시에 몰리고 락 경합이 생긴다. - 지금 템플릿은 이 코드를 내지 않는다. `docs/registries/error-codes.yaml`에 이 코드의 행이 없다. 이 runbook은 캐시가 이 코드를 내게 될 때를 위한 초안이다. Redis 장애는 [redis-capability-incident.md](redis-capability-incident.md)를 먼저 본다. ## 진단 - 캐시 적중률 메트릭을 본다. - miss 비율이 높은 캐시 키를 찾는다. ## 조치 - 스탬피드 락 TTL이 알맞게 설정됐는지 확인한다. - 트래픽이 많은 키는 기동할 때 캐시를 미리 채운다. ## 에스컬레이션 - 스탬피드와 함께 백엔드 부하가 치솟으면 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.