포스트모텀 — 2026-05-12 API 장애 (45분)

날짜: 2026-05-12 장애 지속 시간: 약 45분 (14:02 ~ 14:55) 영향: 공개 API 전반에 걸친 5xx 오류 발생, 결제(checkout) 기능 차단 [Engineering — Incidents & Decisions.md]

신규 엔드포인트가 DB 커넥션 풀을 사용하지 않고 요청마다 독립적인 DB 커넥션을 직접 생성하였습니다. 부하가 걸리는 상황에서 Postgres 커넥션 한도가 소진되어 API 전체가 타임아웃 상태에 빠졌습니다. [Engineering — Incidents & Decisions.md]

• DB 커넥션 수가 최대치의 80%에 도달할 때 경보 알림 추가
• 풀 외부에서 임의로 커넥션을 생성하는 코드를 금지하는 린트 규칙 도입
• 신규 엔드포인트 릴리즈 전 부하 테스트 의무화

[Engineering — Incidents & Decisions.md]

• 엔지니어링 개요 (홈) — 서비스 전체 구조 및 주요 문서 맵
• 런북 — 잘못된 배포 롤백 절차 — 이 장애에서 적용된 롤백 절차
• ADR-014 — Postgres를 기본 데이터스토어로 채택 — Postgres 도입 배경 및 결정 근거
• DB 커넥션 풀 — 장애의 직접적 원인이 된 커넥션 풀 개념
• Engineering — Incidents & Decisions.md — 원본 소스 문서