--- title: Runbook — category: <CATEGORY> error_codes: [<ERROR_CODE_1>, <ERROR_CODE_2>] severity: <P1|P2|P3> owner: oncall last_updated: <YYYY-MM-DD> status: <초안|운영> --- # Runbook: <TITLE> (`runbook://<area>/<scenario>`) ## 증상 - 이 runbook을 펴게 하는 관측 신호는 무엇인가? - alert 이름, 메트릭 임계값, 로그 패턴 ## 진단 - 차례로 따라 하는 진단 명령과 쿼리 - 로그 쿼리(Loki·CloudWatch) - 볼 메트릭 패널 - trace 조사 방법 ## 조치 - 바로 하는 완화 - 설정 변경 - 손으로 하는 개입 절차 ## 에스컬레이션 - 심각도를 올리는 조건(예: P2 → P1) - 언제 누구를 부르나 - 당번이 풀지 못할 때의 대안 --- > **안내**: 이 파일이 runbook의 기준 양식이다. > 이 파일을 복사하고, `runbook://area/scenario` 꼴에 맞춰 이름을 바꾸고(→ `area-scenario.md`), 머리말 칸을 채우고, > 절 본문을 운영 내용으로 바꾼 뒤 `status: 운영`으로 둔다. 본문을 아직 쓰지 못한 runbook은 `status: 초안`이다. > `RunbookCoverageContractTest`의 `LEGACY_STUB_DEBT`는 이미 있는 초안만 잠시 담아 두는 목록이다. 새 초안을 거기에 > 더하지 않는다. runbook을 끝내거나, 앞으로 생길 소유자·기한 있는 부채 장부를 쓴다.