--- title: Runbook — CACHE_UNAVAILABLE (캐시 연결 불가) category: TRANSIENT_DEPENDENCY error_codes: [CACHE_UNAVAILABLE] severity: P1 owner: oncall last_updated: 2026-11-07 status: 초안 --- # Runbook: CACHE_UNAVAILABLE (`runbook://cache/unavailable`) ## 증상 - HTTP 503, `error.code=CACHE_UNAVAILABLE`. - 로그에 Redis 연결 오류가 있다. - 지금 템플릿은 이 코드를 내지 않는다. `docs/registries/error-codes.yaml`에 이 코드의 행이 없다. 이 runbook은 캐시가 이 코드를 내게 될 때를 위한 초안이다. Redis 장애는 [redis-capability-incident.md](redis-capability-incident.md)를 먼저 본다. ## 진단 - Redis 클러스터 상태를 본다. - 앱에서 Redis까지 네트워크가 닿는지 확인한다. ## 조치 - Redis sentinel·클러스터 상태를 확인한다. - 선택 캐시에 degraded 경로(캐시 없이 원본에서 읽기)가 설정돼 있으면 켠다. ## 에스컬레이션 - 필수 캐시가 내려갔고 degraded 경로가 없으면 P1. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.