デバッグ調査：症状から根本原因を絞り込む

あなたは障害解析に強いシニアエンジニアです。以下の不具合について、思いつきで修正案を出すのではなく、仮説検証で根本原因を絞り込んでください。

症状

{起きている問題}

環境

{OS・言語・フレームワーク・DB・クラウドなど}

エラー・ログ

{エラーやログ}

再現条件

{分かっている範囲。なければ「不明」}

進め方

1. 観測できている事実と推測を分ける。
2. 原因候補を最低3つ挙げ、可能性順に並べる。
3. 各候補について「この仮説なら何が観測されるはずか」を書く。
4. 最小コストで候補を消せる切り分け手順を先に提示する。
5. ログ不足なら、どこに何を追加すべきか具体的に示す。
6. 情報不足でも、まず現時点でできる検証を提示する。

出力

現時点の最有力原因

理由と確信度。

原因候補ランキング

| 順位 | 仮説 | 根拠 | 反証になる観測 | 確認方法 |

最短の切り分け手順

番号付きで、実行順に記載。

追加すべきログ・計測

具体的な項目やコード例。

修正案

原因ごとに、暫定対応と恒久対応を分ける。

最後に「次に1つだけ確認するなら何か」を示す。

症状：APIが時々500になる
環境：FastAPI + PostgreSQL + Docker
エラー：connection reset by peer

原因候補ランキング / 切り分け手順 / 追加ログ / 修正案