--- title: Runbook — DEPENDENCY_DNS_FAILED (DNS 조회 실패) category: TRANSIENT_DEPENDENCY error_codes: [DEPENDENCY_DNS_FAILED] severity: P1 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: DEPENDENCY_DNS_FAILED (`runbook://dependency/dns-failed`) ## 증상 - HTTP 503, `error.code=DEPENDENCY_DNS_FAILED`. - 업스트림 호스트 이름의 DNS 조회가 실패했다. ## 진단 - 앱 pod에서 DNS 조회를 시험한다: `nslookup ` - 클러스터 DNS(CoreDNS) 상태를 확인한다. ## 조치 - 업스트림 호스트 이름 설정을 확인한다. - CoreDNS·클러스터 DNS 상태를 확인한다. ## 에스컬레이션 - 클러스터 DNS가 나빠졌으면 P1. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.