トレースビュー

概要

個々のトレースを表示すると、そのスパンと関連するメタデータをすべて見ることができます。各トレースは、フレームグラフ、スパンリスト、ウォーターフォール、またはマップとして視覚化できます。

トレースヘッダーには、ルートスパンのサービス名、リソース名、トレース ID、エンドツーエンドのトレース期間、トレース開始時刻などの重要なトレース情報が表示されます。トレースへのパーマリンクを取得するには、Open Full Page をクリックし、URL を保存します。

トレースヘッダー

トレースの視覚化

フレームグラフ

フレームグラフはデフォルトの視覚化で、トレースから色分けされたすべてのスパンをタイムライン上に表示します。これはリクエストの実行経路や、トレースのどこに時間が費やされたかを理解するのに便利です。

グラフを操作するには、スクロールしてズームし、クリックしてドラッグして移動し、ミニマップを使用して選択したスパンにズームインしたり、フルトレースにズームアウトします。

凡例は、フレームグラフの色分けを詳細に示します。Service (デフォルト)、Host、または Container のいずれかでスパンをグループ化します。グループごとに、トレース実行時間の割合 (% Exec Time) またはスパン数 (Spans) のいずれかを選択して表示します。トレース内のスパンにエラーが存在する場合は、Filter Spans の下にある Errors チェックボックスを選択することで、フレームグラフでこれらをハイライトします。

トレースビュー

リソースをグループ (サービスがデフォルト) ごとに表示し、スパン数でソートします。この視覚化は、リソースやグループ別にレイテンシー情報をスキャンするのに便利です。

対応するボタンとテキストベースの検索を使用して、リソースをタイプまたはネーミング情報でフィルタリングします。

スパンリストヘッダー

グループは、対応する列のヘッダーをクリックすることでソートできます (RESOURCESPANS、平均期間 (AVG DURATION)、実行時間 (EXEC TIME)、トレース実行時間の割合 (% EXEC TIME))。

ベータ版に参加!
ウォーターフォールの非公開ベータ版に参加するには、このフォームにご記入ください
ウォーターフォール

関連するトレースのすべてのスパンを、個別の行とタイムライン上に色分けして表示します。この視覚化は、トレースの関連する部分を分離して焦点を当てるのに便利です。

各行で (つまりスパンごとに):

  • バー (サービスごとに色分け)。その長さは、トレース全体の期間の割合に対応します
  • サービス名、オペレーション名、リソース名。フォントスタイル: サービスオペレーションリソース
  • 絶対および相対スパン期間情報
  • (該当する場合) エラーアイコンまたは HTTP ステータスコード

スパンの子孫を展開または折りたたむには、任意の行のプラスまたはマイナスボタンをクリックします。すべてのスパンを展開するには、タイムスケールの左側にあるプラスボタンをクリックします。

マップ

トレースに関与するすべてのサービスの代表を表示します。この視覚化は、サービスの依存関係やトランザクションライフサイクルのおおまかな概要をサービスレベルで把握するのに便利です。

サービスにカーソルを合わせると、その親と子がハイライトされます。またこれをクリックすると、サービスエントリスパンにフォーカスします。

詳細

トレースビューの高さ調節可能な下部には、選択したスパンとトレース情報が表示されます。

スパンヘッダーには、選択したスパンのサービス名、オペレーション名、リソース名、およびレイテンシー情報が含まれます。ネーミングピルをクリックして、プラットフォームの他の部分にピボットしたり、トレースエクスプローラー検索を絞り込むことができます。

スパンヘッダー

カスタムタグを含む、すべてのスパンのメタデータを表示します。スパンタグをクリックして、トレースエクスプローラーで検索クエリを更新するか、タグの値をクリップボードにコピーします。

以下の情報がさまざまな条件下で表示されます。

  • git 警告メッセージ (CI Test で git 情報が見つからない場合)
  • SQL クエリのマークアップ (SQL クエリ上)
  • RUM コンテキストとメタデータ (RUM スパン上)
  • スパークメトリクス (Spark ジョブスパン上)
Span Info タブ

選択したスパンのインフラストラクチャー情報を、ホストレベルとコンテナレベル (利用可能な場合) の間で切り替えます。

関連するタグや、CPU、メモリ、I/O などの重要なホスト/コンテナのメトリクスグラフを、トレースが発生した日時のオーバーレイとともに確認します。

Infrastructure タブ

トレース時にサービスに関連するログを参照します。ログにカーソルを合わせると、そのタイムスタンプを示すラインがトレースフレームグラフに表示されます。ログをクリックすると、ログエクスプローラー検索が表示されます。

Logs タブ

サービスのスパンをクリックすると、基礎インフラストラクチャーで実行中のプロセスを確認できます。サービスのスパンプロセスは、リクエスト時にサービスが実行されているホストまたはポッドと相関関係にあります。CPU および RSS メモリなどのプロセスメトリクスをコードレベルのエラーとともに分析することで、アプリケーション特有の問題かインフラストラクチャーの問題かを見分けることができます。プロセスをクリックすると、ライブプロセス ページが開きます。スパン固有のプロセスを表示するには、プロセスの収集を有効にします。現在、関連するプロセスはサーバーレスおよびブラウザのトレースでサポートされていません。

Processes タブ

サービスのスパンをクリックして、リクエストを行っているサービスネットワークの依存関係を確認します。特に、コードエラーが生成されない場合には、ボリューム、エラー (TCP 再送)、ネットワークレイテンシー (TCP ラウンドトリップ時間) などの主要なネットワークパフォーマンスのメトリクスを使用して、アプリケーション固有の問題とネットワーク全体の問題の切り分けを行います。たとえば、ネットワークのテレメトリーを使用して、リクエストのレイテンシーが高い理由 (関連するアプリケーションのトラフィックがオーバーロードした、ダウンストリームのポッドやセキュリティグループ、その他のタグ付けされたエンドポイントとの依存関係に問題があったなど) を特定することができます。プロセスをクリックすると Network Analytics ページが開きます。スパン固有のプロセスを閲覧するには、ネットワークパフォーマンスモニタリングを有効にしてください。

: 関連するネットワークのテレメトリーは、現在サーバーレスのトレースではサポートされていません。

Network タブ

分散型トレーシングのサービスを対象とした攻撃の試行を確認できます。攻撃者が使用したパターン、攻撃を検出したルール、攻撃者がサービスの脆弱性を発見したかどうかを確認することができます。

Datadog Application Security Management を使用してさらに調査するには、View in ASM をクリックします。

Security タブ
スパンリンクのサポートはベータ版です。

スパンリンクは、因果関係はあるが、典型的な親子関係を持たない 1 つ以上のスパンを相関付けます。

フレームグラフのスパンをクリックすると、スパンリンクで接続されたスパンが表示されます。

Span Links タブ

: スパンリンクは、例えば保持フィルターを使用して、対応するスパンが取り込まれ、インデックス化された場合にのみ表示されます。

スパンリンクの詳細とカスタムインスツルメンテーションでスパンリンクを追加する方法については、スパンリンクをお読みください。

その他の参考資料