--- title: Runbook — DEPENDENCY_5XX_SERVER (업스트림 서버 오류) category: TRANSIENT_DEPENDENCY error_codes: [DEPENDENCY_5XX_SERVER] severity: P1 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: DEPENDENCY_5XX_SERVER (`runbook://dependency/5xx-server`) ## 증상 - HTTP 502, `error.code=DEPENDENCY_5XX_SERVER`. - 업스트림이 5xx를 돌려줬다. 서버 쪽 일시 장애다. ## 진단 - `dependency_name` 태그로 어느 업스트림이 실패하는지 본다. - 업스트림 서비스의 상태 페이지를 본다. ## 조치 - 클라이언트는 다시 시도한다(retryable=true). - 업스트림 회복을 지켜본다. ## 에스컬레이션 - 중요한 업스트림이 5xx 상태로 계속 머물면 P1. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.