ログとエラートラッキングの違い、調査での使い分け
ログとエラートラッキングを、収集範囲、グループ化、コンテキスト、通知、費用から比較。クラッシュ分析や影響ユーザー数の条件と、Guanceでリクエストをたどる方法を解説します。
決済リクエストが失敗したとき、例外から処理が止まった場所は分かっても、その前に在庫を確保したか、下流サービスが何を返したかまでは分からないことがあります。その情報を調べるには、別の記録が必要です。
ログはアプリケーションが記録したイベントを残し、エラートラッキングは収集したエラーを調査・対応できる問題として整理します。 「ログは手作業、エラートラッキングは自動診断」と単純に分けられるものではありません。どちらもクエリや通知を持ち得ますし、収集されなかった情報は復元できません。影響ユーザー数も、実際に得られたイベントと識別子に依存します。
押さえておきたい違い
- ログは正常な処理、デバッグ情報、警告、エラーなどを扱えますが、実際の範囲は記録・収集・保持の方針で決まります。エラートラッキングは主にエラーを扱い、明示的なメッセージ送信もできます。
- エラートラッキングはフィンガープリントなどでイベントをグループ化できます。ログ基盤も、構造化フィールド、クエリ、クラスタリング、アラートでエラーを整理できます。
- スタック、端末、リリース、パンくずの情報はSDKや連携設定次第です。すべてが自動でそろうわけではなく、ログにも構造化したコンテキストを残せます。
- エラートラッキングで問題の発見・整理・担当割り当てを進め、ログで記録済みの業務処理や下流応答を補う使い方ができます。
ログが残すもの
開発者、フレームワーク、ミドルウェアは、リクエスト処理、状態変更、デバッグなど、選んだイベントをログに出します。システム内のすべてを記録するわけではありません。自由なテキストの場合もあれば、service、status、リクエスト識別子を持つ構造化レコードの場合もあります。何を記録し、収集し、保持したかによって価値が変わります。OpenTelemetryのログデータモデル(英語)は本文に加えて構造化属性も扱います。
調査の入口はキーワード検索だけではありません。構造化クエリ、監視イベント、関連するリクエストからも入れます。ログは業務状態や処理順序を確認する材料になりますが、errorの1行だけで根本原因まで確定するとは限りません。
エラートラッキングが加えるもの
Sentryなどの製品のエラートラッキング機能は、SDKや連携機能からエラーイベントを集めます。自動収集の範囲はランタイム、SDKの初期化と設定に依存し、典型例は未処理の例外やPromise rejectionです。アプリケーションが捕捉して処理した例外は、captureExceptionなどで明示的に報告する必要がある場合があります。すべてのクラッシュや業務上の誤結果を自動検知するとは考えられません。Sentryのエラー収集(英語)
主に次の3つの作業を整理します。ただし、ログ基盤では絶対にできない機能という意味ではありません。
- 問題へのグループ化。 スタック、例外の型、メッセージ、カスタムfingerprintなどを使います。Sentryの既定アルゴリズムにはバージョンがあり、ルールも変更できます。似たメッセージが同じ問題とは限らず、同じ原因が複数グループに分かれる場合もあります。グループ化の仕組み(英語)
- コンテキストの追加。 スタック、環境、リリース、端末、ユーザー、パンくずを付けられますが、SDKや有効な連携機能に左右されます。ユーザーデータは目的とプライバシーに合わせて設定・制御するもので、SDKを入れるだけで全訪問者を識別できるわけではありません。SDKが収集するデータ(英語)
- 通知と再発時の対応。 新しい問題や、解決済みの問題の再発をルールの起点にできます。フィルタリング、サンプリング、クォータ、通知条件、送信頻度の制限によって通知される範囲は変わり、新しい例外ごとの即時通知が保証されるわけではありません。通知の条件とフィルター(英語)
クラッシュ分析(crash analytics)は、クラッシュと、そのリリース・端末・観測された影響範囲に焦点を当てます。例外の発生が必ずプロセスのクラッシュにつながるわけではありません。クラッシュやネイティブエラーの対応範囲はプラットフォームごとに異なるため、該当SDKとシンボルファイルの要件を確認します。「影響ユーザー数」は受信したイベントの識別情報に基づく値であり、被害を受けた全利用者や業務損失をそのまま表すものではありません。
処理の違いを比較する
| 観点 | ログ | エラートラッキング |
|---|---|---|
| 対象範囲 | 実際に記録・保持した正常処理やエラー | 収集した例外、対応するクラッシュ、明示的なメッセージ |
| 収集方法 | フレームワーク出力、アプリケーションの記録、コレクター | SDK・連携による自動収集と明示的な報告 |
| 集約 | 構造化クエリ、集計、クラスタリングなど。基盤による | 問題単位のグループ化・件数。指紋などのルールを調整可能 |
| 通知 | 収集データに対する検出・通知ルール | 新しい問題や再発などの条件と通知頻度を設定 |
| コンテキスト | ログ内容、加工後のフィールド、保持範囲 | SDK、プラットフォーム、連携、識別子、プライバシー設定 |
| 費用 | 製品・プランごとの取り込み、保存、クエリ、機能料金 | 製品・プランごとのイベント枠、保持、機能、超過料金 |
グループ化で減るのは、個別に対応する問題の数です。取り込んだエラーイベントの件数が減るとは限りません。どちらが安いかは実際の製品とプランで比べます。「ログ量」と「イベント量」を全製品共通の課金単位として扱うことはできません。
調査の段階に合わせて併用する
入口によって順番は変わりますが、次の3段階で考えると整理できます。
- 発見: エラートラッキングのルールやログ監視で、新しい問題やエラー数の変化を検知します。影響範囲は収集済みのイベントと識別情報から判断します。
- 範囲の特定: リリースや環境で対象を絞り、担当チームへ渡します。そのためのフィールドが正しく記録されていることも前提です。
- 原因の調査: 発生時刻とリクエスト情報から保持中のログを探し、スタック、業務状態、下流応答を使って原因の仮説を確かめます。
エラーイベントだけでは、失敗前の正常な処理が抜けることがあります。一方、フィールドや通知を整えずにテキストを保存するだけでは、対応すべき問題を見落とすこともあります。データの呼び名ではなく、不足している証拠と作業を基準に選びます。
Guanceで同じリクエストのログへ戻る
トレースを収集し、業務ログに同じ形式の現在のtrace_idを記録すると、Guanceのトレース詳細(英語)で記録済みのエラーSpanと関連ログを調べられます。時間範囲、サービス・環境、ログインデックスのマッピング、閲覧権限も確認します。未収集、サンプリングで破棄、保持期間切れのデータは、同じtrace IDがあっても復元できません。APMを有効にしただけで、すべての例外が収集・グループ化されたことにはなりません。
ログ側にもエラーを整理する入口があります。Guanceのログのエラートラッキング(英語)は、error_stackまたはerror_messageを含む収集済みログを表示します。errorレベルだけでは、欠けているスタックを補えません。
通知先を決めるには、ログやトレースを対象に監視ルール(英語)を設定し、イベント内に関連クエリへのリンクを含めます。インシデントの関連付けとイベントの重要度マッピングを有効にすれば、条件に合う異常イベントからインシデントを作成できます。通知は設定したアラートポリシーに従います。エラーの文字列を探すことと、対応作業を管理することを分けられます。
よくある疑問
errorレベルのログだけでは足りませんか。 レベルは一つのフィールドです。構造化エラーログでも集計、クラスタリング、通知はできます。同じ問題の追跡やリリース・ユーザーへの影響の判断には、スタック、グループ化ルール、識別子などが必要です。
エラートラッキングでログを置き換えられますか。 通常、そのままの置き換えにはなりません。エラーイベントは問題管理に向きますが、監査や正常な処理順序には別の記録が必要です。論理的な不具合が例外を発生させず、検出も報告もされなければ、どちらのツールも業務結果の誤りを自動では認識できません。
エラーログをリクエストへどう結び付けますか。 処理中のtrace_idを記録し、サービスと環境をそろえ、時間、インデックス、権限を確認します。既知の失敗リクエストで実際に記録を取得できるか確かめます。同じ時刻に起きただけでは因果関係の証明にはなりません。
フロントエンドのエラーも追跡できますか。 対応SDKで収集できますが、ランタイム、連携機能、ブラウザーによる制約があります。圧縮後のスタックを元ソースへ対応付けるには、配備した成果物と一致するsourcemapと、必要なソース内容を、アップロードなど対応する方法で取得できることが必要です。SentryはDebug IDで関連付けられ、releaseやパスで照合する方法もあります。どの方式でもreleaseが必須というわけではなく、元イベントにないスタックをマップやシンボルで作り出すこともできません。sourcemap(英語) · Debug ID(英語)
