---
title: Runbook — DEPENDENCY_DNS_FAILED (DNS 조회 실패)
category: TRANSIENT_DEPENDENCY
error_codes: [DEPENDENCY_DNS_FAILED]
severity: P1
owner: oncall
last_updated: 2026-06-15
status: stub
---

# Runbook: DEPENDENCY_DNS_FAILED (`runbook://dependency/dns-failed`)

## Symptoms

- HTTP 503 with `error.code=DEPENDENCY_DNS_FAILED`
- DNS resolution failure for upstream hostname

## Diagnosis

- Test DNS resolution from app pod: `nslookup <upstream-host>`
- Check cluster DNS (CoreDNS) health

## Action

- Verify upstream hostname configuration
- Check CoreDNS / cluster DNS health

## Escalation

- P1 if cluster DNS is degraded

---

> **Stub**: Phase D2 — author body after domain adoption. (feature-operational-runbook-contract D9)