テーマ別の解説テーマ:CloudWatch・CloudTrail・Configと障害調査
AWSのログ調査入門:時刻・要求ID・観測点から障害を切り分ける
同じ時刻のエラーを並べるだけでは、同じ要求や障害の原因とは決まりません。 入口・アプリ・依存先・設定変更の記録を分け、照合できる条件から調べます。架空のレポートAPIを使い、504とタイムアウトの記録から言えること、まだ言えないことを整理します。
要求の識別と観測点をそろえ、記録された事実・原因候補・追加で必要な証拠を分けて説明できる。
HTTPステータスは観測した場所の応答です。依存先はアプリが処理中に呼び出す別のサービス。例は端末内で読む固定資料で、AWSへの接続、実ログの貼付、認証情報の入力は不要です。
まず「誰が見た記録か」を分ける
メトリクスは一定の対象や期間で測る数値、ログは出来事の記録です。CloudWatchではこれらを調べられますが、必要なログが自動で全て集まるという意味ではありません。CloudTrailの操作イベントは、アプリの全HTTP要求を記録するアクセスログとも異なります。
- 閲覧者 → 入口プロキシHTTP要求と応答を観測する場所
- 入口プロキシ → レポートAPIこの架空例ではアプリへ転送
- レポートAPI → 保管APIアプリが別の処理を呼び出す
- 閲覧者
- 入口で受けた応答を観測
- 入口プロキシ
- アプリへ渡す要求と応答
- レポートAPI
- 自分の処理と依存呼出し
- 保管API
- 届いた要求と内部処理
| 観測点 | 分かることの例 | それだけでは分からないこと |
|---|---|---|
| 入口HTTPログ | 入口が返したステータスや記録した時間 | アプリ内部の待ち時間の内訳 |
| アプリログ | アプリが記録した処理・依存先のエラー | 依存先サーバーの内部状態 |
| 操作イベント | 記録対象の変更要求と、その結果 | その変更が特定要求を失敗させた因果関係 |
R1:同じ要求を、入口からアプリへ追う
2026-10-24T12:00:00.000Z ingress request=demo-r1 event=received path=/reports
2026-10-24T12:00:00.010Z app request=demo-r1 event=begin
2026-10-24T12:00:00.020Z app request=demo-r1 event=dependency-call deadline_ms=1500
2026-10-24T12:00:01.520Z app request=demo-r1 event=dependency-timeout
2026-10-24T12:00:01.525Z app request=demo-r1 event=respond status=504
2026-10-24T12:00:01.530Z ingress request=demo-r1 event=respond status=504R1では、アプリが依存呼出しのタイムアウトを記録して504を返し、入口も504を返したことが与えられています。呼出し開始からタイムアウト記録までの差は1,500ミリ秒です。これはアプリ側の観測区間であり、依存先サーバーが1,500ミリ秒処理した証明ではありません。
| 段階 | R1からの判断 |
|---|---|
| 確認できた事実 | アプリでタイムアウトが記録され、入口まで504が返った。 |
| 次の焦点 | 依存呼出しの接続・期限・経路と、許可された依存先側の記録。 |
| 未確定 | 依存先へ届いたか、内部処理が遅いか、接続や経路で待ったか。 |
| 避ける対処 | 証拠なしに通信制御を外す、期限だけ延ばす、全サービスを再起動する。 |
要求ID・時刻・対象の三つを照合する
要求IDの意味は発行元や記録形式で異なります。ALBのtrace_idやCloudTrailのrequestIDを、別のアプリIDと無条件に結び付けません。IDを引き継ぐ設計や対応関係を確認し、アカウント・リージョン・環境・対象・パス・時刻の条件もそろえます。
| 比較ケース | 早合点 | 適切な確認 |
|---|---|---|
| R2:同時刻にdemo-r2のエラー | R1の依存先エラーだ。 | 別の要求として保留し、正当な対応付けがあるか調べる。 |
| R3:保管APIの一致記録がない | 要求は絶対に届いていない。 | 収集対象・欠落・保存期間・時刻・検索条件を確認する。 |
| R4:2分前に通信規則の変更記録 | この変更が必ず原因だ。 | 変更前後と対象経路の整合、許可された観測で仮説を確かめる。 |
| R5:時計同期が未確認 | 別ホストの差分は正確な通信時間だ。 | 時刻の信頼性と基準を確認し、使える処理内計測を区別する。 |
調査の順序を、残せる記録にする
- 症状・再現時刻・対象環境・期待する動作を固定する。
- 各観測点の記録条件、期間、時計、識別子の意味を確認する。
- 同じ要求と照合できる事実だけを時系列へ並べる。
- 事実・原因候補・反証や追加観測を分けて書く。
- 変更が必要なら担当権限・影響・戻す方法を確認して最小範囲で行う。
- 同じ条件で期待する応答と拒否すべき要求を再確認し、残る未確認を記録する。
R1の記録例は「観測:appのdemo-r1でdependency-timeout、その後504。未確認:保管APIの到達と内部処理。次:収集条件を確認して対応する接続/保管APIの記録を照合」です。「原因:DBが遅い」と書き換えないでください。
記録から言えることを選んでみる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- R1の要求IDとアプリ側1,500ミリ秒の区間を指す。
- R2〜R5で断定できない条件を説明する。
- 調査メモを事実・仮説・次の観測に分けて書く。
理解を確かめる: ログ調査で、原因を書く前に何を分けますか?
観測した事実、原因候補、まだ必要な証拠を分ける。
同時刻・同じステータス・直前の変更だけでは、要求の一致や原因は確定しません。識別子・観測点・収集条件をそろえて確かめます。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件運用状況を調べるためのメトリクス・ログ等の機能。 公式資料の確認であり実AWS検証ではありません。
参照した本文まず「誰が見た記録か」を分ける
確認した内容・条件ログの収集・検索・保存期間。メトリクスや因果の証明と区別。 公式資料の確認であり実AWS検証ではありません。
参照した本文まず「誰が見た記録か」を分ける
確認した内容・条件管理・データ等のイベント分類と記録条件。並びは完全な呼出し順ではない。 公式資料の確認であり実AWS検証ではありません。
参照した本文まず「誰が見た記録か」を分ける
確認した内容・条件入口とターゲットの応答・時刻・trace_idを区別。ログはbest-effortで完全な全件台帳ではない。 公式資料の確認であり実AWS検証ではありません。
確認した内容・条件eventTime・eventName・requestID等の意味。要求ごとの識別を全層共通IDへ一般化しない。 公式資料の確認であり実AWS検証ではありません。
確認した内容・条件単一アカウント/リージョンの直近90日管理イベント。データイベント等は含まれない。 公式資料の確認であり実AWS検証ではありません。
参照した本文要求ID・時刻・対象の三つを照合する