コンテンツにスキップ

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: #(番号)
  • ドキュメント: (修正後に作成したガイドへのリンク)