--- title: Runbook — DEPENDENCY_TIMEOUT (외부 의존성 타임아웃) category: TRANSIENT_DEPENDENCY error_codes: [DEPENDENCY_TIMEOUT] severity: P1 owner: oncall last_updated: 2026-11-07 status: 초안 --- # Runbook: DEPENDENCY_TIMEOUT (`runbook://dependency/timeout`) ## 증상 - HTTP 504, `error.code=DEPENDENCY_TIMEOUT`. - 업스트림 서비스가 설정된 시간 안에 답하지 않았다. 호출 전체의 상한은 HTTP 클라이언트 profile의 `timeout.total-call`이다(기본값은 `docs/httpclient/configuration-reference.md`). ## 진단 - 로그의 `dependency_name`으로 어느 업스트림이 시간을 넘기는지 본다. - 업스트림 서비스의 지연 메트릭을 본다. ## 조치 - 업스트림 서비스 상태를 확인한다. - 시간 상한 설정이 SLA 기대와 맞는지 확인한다. ## 에스컬레이션 - 중요한 업스트림이 대규모로 시간을 넘기면 P1. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.