clean-architecture-backend-template/docs/runbooks/dependency-circuit-open.md

title, category, error_codes, severity, owner, last_updated, status

title	category	error_codes	severity	owner	last_updated	status
Runbook — DEPENDENCY_CIRCUIT_OPEN (서킷 브레이커 개방)	TRANSIENT_DEPENDENCY	DEPENDENCY_CIRCUIT_OPEN	P2	oncall	2026-06-15	stub

Runbook: DEPENDENCY_CIRCUIT_OPEN (runbook://dependency/circuit-open)

Symptoms

• HTTP 503 with error.code=DEPENDENCY_CIRCUIT_OPEN
• Circuit breaker (Resilience4j) in OPEN state for a dependency

Diagnosis

• Check Resilience4j circuit breaker metrics for the dependency
• Check upstream health; circuit opens after failure threshold breached

Action

• Wait for circuit half-open probe (automatic after wait duration)
• Resolve upstream issue to allow circuit to close

Escalation

• P1 if circuit remains open > 5 minutes on a critical dependency

---

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