Postmortem テンプレート¶
📁 docs/ops/postmortem/template.md
[!NOTE] ファイル名:
site-docs/ops/postmortem/YYYY-MM-DD_短いタイトル.md
障害・失敗が発生したらこのテンプレートをコピーして記録する。
概要¶
発生日時: YYYY-MM-DD HH:MM JST
検知日時: YYYY-MM-DD HH:MM JST
解消日時: YYYY-MM-DD HH:MM JST
ダウンタイム: X 時間 Y 分
影響範囲¶
- システム: (例: koi-navi.com / SD Forge / GitHub Actions / Ollama)
- 影響内容: (例: サイト閲覧不可 / 自動更新停止 / モデル推論不可)
- 影響期間: YYYY-MM-DD 〜 YYYY-MM-DD
タイムライン¶
| 日時 | 出来事 |
|---|---|
| YYYY-MM-DD HH:MM | 障害発生(または最後の正常確認) |
| YYYY-MM-DD HH:MM | 問題を検知 |
| YYYY-MM-DD HH:MM | 原因特定 |
| YYYY-MM-DD HH:MM | 修正適用 |
| YYYY-MM-DD HH:MM | 正常復旧確認 |
原因¶
直接原因¶
(何が起きたか。例: Python パッケージのバージョン非互換により xformers が起動不可になった)
根本原因¶
(なぜ起きたか。例: バージョン固定をせずに pip install --upgrade を実行したため)
修正内容¶
再発防止策¶
| 対策 | 担当 | 期限 | 状態 |
|---|---|---|---|
| (例: requirements.txt でバージョン固定) | Claude / 手動 | YYYY-MM-DD | ✅ 完了 / ⬜ 未着手 |
学んだこと¶
- (例: pip upgrade は単体では実行しない。torch/torchvision/xformers はセットで更新する)
関連リンク¶
- Issue: #(番号)
- ドキュメント: (修正後に作成したガイドへのリンク)