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

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

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

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

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

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

Displays all spans for a trace on a timeline where each row corresponds to a span. This visualization is useful for isolating and focusing on relevant parts of a trace.

Each row (span) indicates the following:

• Relative span duration: The length of the color-coded bar corresponds to the percentage of total trace duration.
• Absolute span duration: The absolute time in milliseconds (ms).
• Span details: The corresponding service name and resource name are displayed.
• Statuses: When applicable, an HTTP status code is displayed.
• Color coding: Spans are color-coded by service (default), host, or container. To change how spans are color-coded, use the Color by dropdown.

To expand or collapse span descendants, click the chevron (>) icon on a row. To expand or collapse all spans, click the Expand all (+) or Collapse all (-) buttons.

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

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

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

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

• git 警告メッセージ (CI Test で git 情報が見つからない場合)

• SQL クエリのマークアップ (SQL クエリ上)

• RUM コンテキストとメタデータ (RUM スパン上)

• スパークメトリクス (Spark ジョブスパン上)

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

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

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

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

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

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

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

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

View Code Hotspots to identify lines of code related to performance issues. The values on the left side represent the time spent in each method call during the selected span.

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

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

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

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