ログ・メトリクス・トレースのどれから見るか

三つの観測手段には得意な質問があります。最初に「何を知りたいか」を決めると、入口を選べます。常にメトリクスから始める固定手順ではありません。特定のエラー報告があるならログ、複数サービスをまたぐ一件の遅延ならトレースから始めることもあります。

広がりを知るメトリクス、一件の出来事を調べるログ、処理経路を追うトレースを、知りたいことに応じて選ぶ図

最初の選び方

「一部だけ遅い」という全体傾向なら、まずメトリクスで発生時刻と範囲を見ます。次に、関連するtraceを選び、必要な詳細をログで確認します。すでにrequest IDやtrace IDが分かっているなら、その一件から入り、後でメトリクスへ戻って広がりを確認します。

課題提出が遅いという報告があった場合、提出APIの応答時間とエラー率を確認します。特定の時間帯だけ増えていれば、その時間帯のログを探します。アップロード、保存、通知のどこで待っているかはトレースで確認します。

ログとトレースを結び付けるには、リクエストIDやトレースIDが必要です。個人情報やトークンをそのままログに書かず、必要な識別子と結果だけを残します。

観測データには保存コストとプライバシーの問題があります。何をいつまで残すか、失敗時に必要な項目は何かを先に決めます。

広がりはメトリクス、個別の出来事はログ、処理経路はトレースで見ます。同じ識別子を使い、仮説に必要な情報から順に確認します。