장애 Postmortem 생성기

장애 Postmortem 생성기 사용 가이드

장애가 끝나면 무엇이 일어났고 어떻게 막을지 정리하는 회고(Postmortem)를 써야 같은 장애를 반복하지 않습니다. 이 생성기는 메모 몇 줄을 받아 회고에 필요한 절을 갖춘 문서를 만들고, 사람이 아니라 시스템과 절차를 개선한다는 '비난 없는 회고' 원칙을 머리에 적어 줍니다.

'영향: …', '타임라인: 09:10 경보 발생'(여러 줄), '원인: …', '복구: …', '후속 조치: …'처럼 절 이름을 붙여 적으면 해당 절로 들어갑니다. 타임라인은 적은 순서대로 목록이 되고, 후속 조치는 '- [ ]' 체크박스로 만들어 진행 상황을 표시할 수 있게 합니다.

Impact·Timeline·Root cause·Action items 같은 영어 절 이름도 알아보며, 비어 있는 절에는 '영향받은 사용자 수, 기간, 기능을 숫자로 적으세요' 같은 안내가 남습니다.

사용 방법

1. 1'장애 제목'과 '사건 번호'를 적습니다.
2. 2'내용' 칸에 '영향: …', '타임라인: 시각 내용'(여러 줄), '원인: …', '후속 조치: …'를 한 줄씩 적습니다.
3. 3'실행' 후 결과를 공유 문서에 붙여 넣고 회고 회의에서 빈 절을 함께 채웁니다.

장애 제목: 검색 색인 누락
사건 번호: INC-2026-08
내용:
영향: 120개 페이지가 2일간 검색에서 빠짐
타임라인: 09:10 경보 발생
타임라인: 10:30 robots 규칙 되돌림
원인: robots.txt 규칙이 /tools/를 막음
후속 조치: 배포 전 robots 검사 추가

# 검색 색인 누락 장애 회고

- 사건 번호: INC-2026-08
- 작성일: 2026-10-01
- 원칙: 사람이 아니라 시스템과 절차를 개선하는 비난 없는 회고

## 요약

<!-- 무슨 일이 언제 얼마나 있었는지 두세 문장으로 적으세요 -->

## 영향

- 120개 페이지가 2일간 검색에서 빠짐

## 타임라인

- 09:10 경보 발생
- 10:30 robots 규칙 되돌림

## 근본 원인

robots.txt 규칙이 /tools/를 막음

## 복구

<!-- 어떻게 복구했는지 적으세요 -->

## 후속 조치

- [ ] 배포 전 robots 검사 추가

## 배운 점

<!-- 잘된 점과 개선할 점을 적으세요 -->

이럴 때 쓰면 좋아요

• 서비스 장애 직후 회고 문서 초안을 만들 때
• 장애 대응 메모를 정해진 형식으로 정리할 때
• 재발 방지 작업을 담당자별 체크리스트로 관리할 때
• 분기별 장애 회고 문서의 형식을 통일할 때

문제가 생겼을 때

활용 팁

• 근본 원인은 '왜?'를 다섯 번 정도 반복해 사람의 실수 뒤에 있는 시스템의 빈틈까지 내려가 적으면 재발 방지 조치가 구체적으로 나옵니다.
• 후속 조치에는 담당자와 기한을 함께 적으세요. 예: '배포 전 robots 검사 추가 (담당: 김, 10/15까지)'.

자주 묻는 질문