--- title: Runbook — DEPENDENCY_CONNECT_FAILED (외부 의존성 연결 실패) category: TRANSIENT_DEPENDENCY error_codes: [DEPENDENCY_CONNECT_FAILED] severity: P1 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: DEPENDENCY_CONNECT_FAILED (`runbook://dependency/connect-failed`) ## 증상 - HTTP 503, `error.code=DEPENDENCY_CONNECT_FAILED`. - 업스트림으로 TCP 연결이 거부됐거나 네트워크에 닿지 않는다. ## 진단 - `dependency_name` 태그로 어느 업스트림에 닿지 않는지 본다. - 네트워크 경로와 방화벽 규칙을 확인한다. ## 조치 - 업스트림 서비스가 살아 있는지 확인한다. - service discovery와 DNS 조회를 확인한다. ## 에스컬레이션 - 업스트림이 중요한 서비스 의존성이면 P1. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.