関連するログがトレース ID パネルに表示されない
概要
トレースパネルには、トレース、ホスト、および相関ログに関する情報が表示されます。
トレースに現れるログは 4 種類あります。
trace_id
: 対応するトレース ID を持つログを表示します。host
: トレースの時間枠内で、トレースのホストからのログを表示します。container_id
: トレースの時間枠内で、トレースのコンテナからのログを表示します。pod_name
: トレースの時間枠内で、トレースのポッドからのログを表示します。
トレースパネルの Logs セクションが空になることがあります。このガイドでは、この問題を解決する方法を説明します。
インフラストラクチャーオプション
host
、container_id
、または pod_name
オプションの Log セクションが空の場合、Log エクスプローラーに移動し、以下の条件を確認します。
- トレースを発行したホスト/コンテナ/ポッドからログが送信されている。
- トレースの時間枠内にそのホストのログがある。
- ログのタイムスタンプが正しく設定されている。詳しくは、ログに期待したタイムスタンプが表示されないをご覧ください。
トレース ID オプション
もし Log セクションが trace_id
オプションに対して空の場合、ログに標準的な trace_id
属性があることを確認してください。ログに trace_id
が含まれていない場合、以下を行うためにトレースとログの相関付けを行ってください。
ログ属性に含まれるトレース ID を抽出します。
この属性を予約された trace_id
属性にリマップします。
JSON ログの場合、ステップ 1、2 は自動で行われます。トレーサーは、トレースとスパンの ID をログに注入し、これらは予約属性リマッパーによって自動的にリマップされます。
このプロセスが期待通りに動作しない場合、トレース ID を含むログ属性の名前が dd.trace_id
であることを確認し、その属性が予約属性の Trace ID セクションに正しく設定されていることを検証してください。
<div class="shortcode-wrapper shortcode-img expand"><figure class="text-center"><a href="https://datadog-docs.imgix.net/images/tracing/troubleshooting/trace_id_reserved_attribute_mapping.bf8ead6e5722342da25c5315aec7bb68.png?fit=max&auto=format" class="pop" data-bs-toggle="modal" data-bs-target="#popupImageModal"><picture class="" >
<img
class="img-fluid"
srcset="https://datadog-docs.imgix.net/images/tracing/troubleshooting/trace_id_reserved_attribute_mapping.bf8ead6e5722342da25c5315aec7bb68.png?auto=format"
alt="Trace Id セクションがハイライトされた JSON ログの前処理ページ" />
</picture></a></figure>
</div>
生のログ (特定の言語の ログインテグレーションを使ってログを収集している場合) については、source
属性に java
、python
、ruby
などの言語を設定します。インテグレーションは、トレースとログを自動的に相関付けます。
この例では、Java インテグレーションパイプラインを紹介します。
<div class="shortcode-wrapper shortcode-img expand"><figure class="text-center"><a href="https://datadog-docs.imgix.net/images/tracing/troubleshooting/tracing_java_traceid_remapping.9aea4d2194cba4e077d724709744026d.png?fit=max&auto=format" class="pop" data-bs-toggle="modal" data-bs-target="#popupImageModal"><picture class="" style="width:90%;" >
<img
class="img-fluid"
srcset="https://datadog-docs.imgix.net/images/tracing/troubleshooting/tracing_java_traceid_remapping.9aea4d2194cba4e077d724709744026d.png?auto=format"
style="width:90%;" alt="Trace Id リマッパーがハイライトされた Java ログパイプライン" />
</picture></a></figure>
</div>
ログのフォーマットがインテグレーションパイプラインによって認識されていない可能性があります。この場合、パイプラインを複製し、パーストラブルシューティングガイドに従って、パイプラインがログ形式を受け入れることを確認します。
ログを収集するためのインテグレーションを使用していない生のログの場合
カスタムパースルールが、次の例のように、トレースとスパンの ID を文字列として抽出することを確認してください。
そして、抽出した属性にトレースリマッパーを定義して、ログの公式トレース ID にリマップします。
ID が正しく挿入され、ログにリマップされると、トレースパネルでトレースと相関のあるログを見ることができます。
注: ログまたは UI のログ属性には、トレース ID およびスパン ID は表示されません。
その他の参考資料