--- title: Runbook — DB_UNAVAILABLE (데이터베이스 연결 불가) category: TRANSIENT_DEPENDENCY error_codes: [DB_UNAVAILABLE] severity: P1 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: DB_UNAVAILABLE (`runbook://db/unavailable`) ## 증상 - HTTP 503, `error.code=DB_UNAVAILABLE`. - 로그에 SQLState 08* 연결 오류가 있다. ## 진단 - DB 서버 상태와 커넥션 풀 고갈을 확인한다. - 앱 pod에서 DB까지 네트워크가 닿는지 확인한다. ## 조치 - DB primary 상태를 확인한다. replica가 있으면 failover한다. - 커넥션 풀을 비우고 다시 연결한다. ## 에스컬레이션 - P1: DB primary가 내려갔으면 즉시. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.