tech-log-backend/docs/runbooks/db-serialization-failure.md

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

title	category	error_codes	severity	owner	last_updated	status
Runbook — DB_SERIALIZATION_FAILURE (직렬화 실패)	CONFLICT	DB_SERIALIZATION_FAILURE	P3	oncall	2026-06-15	stub

Runbook: DB_SERIALIZATION_FAILURE (runbook://db/serialization-failure)

Symptoms

• HTTP 409 with error.code=DB_SERIALIZATION_FAILURE
• SQLState 40001; high concurrent transaction contention

Diagnosis

• Check DB transaction isolation level
• Identify hot rows / hot tables under high concurrency

Action

• Client should retry with exponential backoff (retryable=true)
• Optimize transaction scope if spike is sustained

Escalation

• Escalate to DBA if sustained serialization failure rate > 5%

---

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