トレース詳細¶
トレースエクスプローラーで任意のトレースをクリックすると、トレース詳細を確認できます。相対時間、所要時間、HTTP メソッド、URL、ステータスコード、TraceId、フレームグラフ、Span リスト、サービス呼び出し関係、リソース呼び出し関係、および関連するログ、ホスト、メトリクス、ネットワーク情報が含まれます。フロントエンドアプリケーション(ブラウザなど)の場合は、リクエストの所要時間分布も確認できます。キューの待ち時間、最初のパケット、ダウンロードの所要時間の割合が含まれます。
トレース詳細を開くと、システムは自動的にエクスプローラー左側のクイックフィルターパネルを折りたたみ、詳細図表の表示幅を広げます。また、環境設定の「トレース詳細のデフォルトビュー」に基づいて、ウォーターフォールチャートまたはフレームグラフを優先的に表示します。
レイアウト切り替えの入り口を使用すると、拡張属性などの情報を図表の下部または右側に切り替えて表示し、必要に応じて詳細ページの表示レイアウトを調整できます。
クロスワークスペース検索結果からレコードを開いた場合、詳細および関連データは、そのレコードの発生元ワークスペースで照会されます。前または次のレコードに切り替える場合は、新しいレコードの発生元ワークスペースが使用されます。同名のサービスや同一の識別子で発生元を代替することはできません。発生元ワークスペースを確認できない場合、詳細への入り口は利用できないため、更新して再試行してください。クエリ範囲と権限の説明については、クロスワークスペース検索を参照してください。
注意
- リアルユーザーモニタリング(RUM)SDK が 2.2.10 以上の場合にのみ、このデータ表示を確認できます。クロスドメインの場合は、header 設定の調整が必要です。
詳細は、Web アプリケーション導入 を参照してください。
- フレームグラフ/ Span リスト/ウォーターフォールチャートに表示できる Span は最大 1 万件です。オフセット設定で、表示されていない Span を確認できます:
フレームグラフ¶
フレームグラフには、各 Span の流れと実行時間が明確に表示されます。右側ではサービスリストと応答時間を確認できます。Span をクリックすると、トレース詳細で JSON コンテンツを確認できます。マウスホイールでズームして詳細情報を確認できます。
詳細は、フレームグラフを活用したトレースパフォーマンス分析 を参照してください。
上のフレームグラフから、この呼び出しトレースには CloudCare と Mysql の 2 つのサービスが含まれていることがわかります。トレースは CloudCare サービスの POST リクエストの送信から始まり、次に ActionResource.executeAction を実行し、最後に Mysql ステートメントを実行します。ActionResource.executeAction の実行中に、Mysql ステートメントが複数回実行されます。CloudCare と Mysql の実行時間の計算方法はそれぞれ次のとおりです:
- CloudCare サービスの実行時間 = D1+D2+D3+D4+D5+D6+D7+D8+D9+D10+D11
- Mysql サービスの実行時間 = span2+span3+......+span11
実行された具体的なステートメントと実行時間の詳細は、Span リストを参照してください。
フレームグラフにおけるサービス実行時間の割合とは、この呼び出しトレース内の各サービスが総時間に占める比率です。下図を例にすると、この呼び出しトレースには CloudCare と Mysql の 2 つのサービスが含まれており、実行時間の割合はそれぞれ 42.37% と 57.63% です。CloudCare サービスには 2 つの Span、Mysql サービスには 10 個の Span があります。
- Mysql サービスの実行時間の割合の計算方法:すべての span の実行時間の合計 ÷ 現在の呼び出しトレースの総時間
計算方法の説明:下図の Mysql サービスには合計 10 個の Span があります。各 Span をクリックすると、現在の Span の実行時間を取得できます。図からわかるように、この Span の実行時間は 5.08ms です。同様の方法で、残り 9 個の Span の実行時間を取得して合算します。
- CloudCare サービスの実行時間の割合の計算方法:(現在の呼び出しトレースの総時間 - mysql サービスの実行時間) ÷ 現在の呼び出しトレースの総時間
計算方法の説明:下図では、CloudCare サービスが現在の呼び出しトレース全体にわたって存在しています。mysql サービスの実行時間を除いた残りの時間が CloudCare サービスの実行時間になります(赤線でマークされた部分の実行時間を参照)。実行時間の割合は、Span リストで各 Span の実行時間と実行時間の割合を直接確認することもできます。
Span リスト¶
- このトレース内のすべての Span のリソース名、数、所要時間、実行時間、および割合を表示します。
- リソース名または Span ID を入力して、検索・一致させることができます。
- 任意の Span をクリックすると、トレース詳細で JSON コンテンツを確認でき、フレームグラフに切り替えて同期表示できます。
- エラーがある場合は、エラープロンプトが表示されます。
- Error Spans をクリックすると、フィルター条件に一致した結果が直接表示されます。
ウォーターフォールチャート¶
各リソース間の親子関係を確認できます。
ウォーターフォールチャートには、開始時間の順に Span データが表示されます。左側のリストには Span データが表示され、各リソースの実行時間の割合が表示されます。右側には時間順にウォーターフォールチャートが表示されます。
- Span に対応するリソース名または Span ID を入力して、検索・一致させることができます。
- ワンクリックで左側のリソースを折りたたむ、または展開できます。
-
をクリックすると、実行時間の形式を切り替えられます。
-
Error Spans をクリックすると、フィルター条件に一致した結果を直接表示できます。
サービス呼び出し関係¶
サービス呼び出し関係では、矩形図を使用してサービス間の呼び出し関係とパフォーマンス情報を表示します。実行時間、平均所要時間、呼び出し数、リクエスト総数、平均リクエスト率、P99 応答時間、エラー数が含まれます。リクエストおよび関連メトリクスは、エントリスパンに基づいて集計されます。
デフォルトでは現在のトレースが分析されます。時間ウィジェットを有効にすると、時間範囲を選択して、その範囲内のサービス呼び出しデータを分析できます。同時に 1 秒あたりのリクエスト数が表示され、実行時間の割合は非表示になります。
任意のサービスノードをクリックすると、その詳細情報を確認できます:
-
サービス操作とリソース:そのサービスに含まれる具体的な操作(API エンドポイント、メソッドなど)と関連リソースを一覧表示します。
-
エラー状態の追跡:
-
そのサービスにエラーがある場合は、エラー詳細が直接表示されます。
-
クリックすると、サービスの親 Span を確認でき、上流の呼び出し元を追跡できます。
-
注意
現在のトレースを分析する場合、システムはトレース詳細 > フレームグラフ 内のサービスに対応する error 結果に基づいて、サービスの色を表示します。
未計装の HTTP 外部サービス¶
呼び出しトレースが未計装の HTTP 外部サービスを経由する場合、システムは上流・下流の Span 情報に基づいてそのサービスを識別し、サービス呼び出し関係に仮想 Gateway ノードを生成します。
呼び出し関係は次のように表示される場合があります:
- 一意の呼び出し元を識別できる場合:
呼び出し元 Service → Gateway → 下流 Service; - 一意の呼び出し元を識別できない場合:
Root → Gateway → 下流 Service。
Gateway ノードを生成するには、次の条件をすべて同時に満たす必要があります:
- 下流が HTTP Server Span であること;
- Server Span の
parent_idが有効で0ではないこと; - 追加照会後も対応する親 Span が見つからないこと;
- Span に識別可能な外部サービスアドレスが含まれていること。
HTTP Client Span のみが存在する場合は、Gateway ノードは生成されません。
仮想 Gateway には独立した Span がないため、呼び出し数、所要時間、エラー数は計算されません。関連メトリクスは - と表示され、ノードは中立状態で表示されます。
Warning
仮想 Gateway はトレース詳細の「サービス呼び出し関係」にのみ表示され、ウォーターフォールチャートとフレームグラフには表示されません。
Root Span は、trace_id と parent_id=0 に基づいて個別に追加照会されます。データの完全な識別には、最長で約 6 時間かかる場合があります。1 つの Trace に 10,000 個を超える Span がある場合、親 Span が照会結果に含まれないことで誤判定が発生する可能性があります。
リソース呼び出し関係¶
トレース詳細で Span を選択し、「サービス呼び出し関係」の右側にある「リソース呼び出し関係」タブに切り替えると、その Span が属するサービスとリソースの上流・下流の呼び出し関係を確認できます。
関係図は、選択した Span に対応するリソースを中心に、選択した時間範囲内で直接または間接的な呼び出し関係があるノードとトレースを表示します。範囲は現在の Trace に限定されません。同名のリソースは、所属サービスごとに区別されます。クロスワークスペース検索を有効にすると、現在のアカウントがアクセス権限を持つワークスペースのみが照会されます。
図内の右上隅には独立した時間ウィジェットがあります。時間範囲を調整すると、リソース呼び出し関係図のみが更新され、外側のリストや他の詳細タブには影響しません。自動更新はデフォルトでオフになっており、手動で更新すると現在選択されている範囲が再照会されます。
Span を切り替えると、システムは中心リソースを更新し、新しい Span の開始時間に基づいて時間範囲を再初期化します。同じ Span 内でタブを切り替える場合は、調整済みの時間範囲が保持されます。
関係図では、中心リソースノードが強調表示され、ノードのインスタンス情報、凡例、ズーム、キャンバスへのフィット、全画面表示の操作が提供されます。全画面表示に入る、または終了する場合は、現在のリソース、時間範囲、およびクエリ結果が保持されます。
- デフォルトで複数層の上流・下流の呼び出し関係が表示され、展開可能なノードが示されます。層ごとに展開できます。
- 同じ層のリソースは応答時間順に並べ替えられます。
- 呼び出しの接続線をクリックすると、対応する呼び出し関係の主要メトリクスとトレンドを確認できます。
Span に必要なサービスまたはリソースのフィールドがない場合、ページには照会できない理由が表示されます。呼び出し関係データがない場合は、時間範囲を調整して再試行できます。クエリに失敗した場合は、プロンプトに従って再試行できます。
ショートカット操作¶
操作 |
説明 |
|---|---|
| 全画面表示/デフォルトサイズに戻す | トレース詳細の右上隅にある全画面表示アイコン をクリックすると、トレースのフレームグラフを横方向に拡大して表示できます。デフォルトサイズに戻すアイコン をクリックすると、詳細ページを復元できます。 |
| 現在の Span に移動 | クリックするとビューが拡大され、現在の Span に移動します |
| ミニマップの展開/折りたたみ | トレース詳細の左側にあるミニマップの展開/折りたたみアイコン をクリックすると、ミニマップ上での範囲選択、ドラッグ、スクロールによってフレームグラフをすばやく確認できます。 |
| 全体 Trace の表示 | トレース詳細の左側にある全体 Trace 表示アイコン をクリックすると、フレームグラフでトレース全体を確認できます。 |
| Span のダブルクリック | フレームグラフの中央にその Span が拡大表示され、コンテキストに関連する Span をすばやく見つけて確認できます。 |
| サービス名のクリック | 対応する Span がハイライト表示されます。サービス名をもう一度クリックすると、デフォルトの全 Span 選択に戻ります。サービス名をクリックすると、サービスに対応する Span をすばやく絞り込んで確認できます。 |
| 情報レイアウトの切り替え | レイアウト切り替えの入り口から、拡張属性などの情報を図表の下部または右側に表示します。 |
拡張属性¶
-
検索バーにフィールド名または値を入力すると、すばやく検索して特定できます。
-
フィールドエイリアスをオンにすると、フィールド名の後ろに表示されます。必要に応じて選択できます。
-
トレース詳細ページでは、拡張属性で現在のトレースに関連するフィールド属性を確認できます:
フィールド |
プロパティ |
|---|---|
| フィールド値で絞り込み | このフィールドをエクスプローラーに追加し、そのフィールドに関連するすべてのデータを確認します。トレースエクスプローラーでそのフィールドに関連するトレースリストを絞り込んで確認できます。 図 1 を参照 |
| フィールド値で除外絞り込み | このフィールドをエクスプローラーに追加して、そのフィールド以外のデータを確認します |
| 表示列に追加 | このフィールドをエクスプローラーのリストに追加して確認します |
| コピー | フィールド値をクリップボードにコピーします。オブジェクト型および配列型のフィールドは、完全な JSON 値をワンクリックでコピーできます。項目ごとに展開したり、JSON ビューに切り替えたりする必要はありません。 |
一部のフィールドはフィルター集計などの関連ロジックをサポートしていません
Guance では一部のフィールドに全文インデックスが使用されており、これらのフィールドではフィルター集計などの関連ロジックを実行できません。全文インデックスフィールドの範囲は次のとおりです:
| カテゴリ | フィールド |
|---|---|
| オブジェクト、リソースカタログ | message |
| ログ、バックアップログ | message |
| セキュリティ | message / title |
| ネットワーク | message |
| トレース | error_message / error_stack |
| イベント | message / title / df_message / df_title |
| RUM エラー | error_message / error_stack |
| RUM ロングタスク | long_task_message / long_task_stack |
図 1
エラー詳細¶
トレース詳細ページで、現在のトレースにエラーがある場合は、サイドバーの error span フィルターオプションをオンにできます。システムはすべてのエラー Span を自動的にハイライト表示します。ハイライトされた任意の Span をクリックすると、関連するエラースタック、ログなどの詳細情報を確認できます。
詳細は、エラー追跡 を参照してください。
サービスコンテキスト¶
インフラストラクチャのリソースカタログからオブジェクトカテゴリを取得し、create_time に基づいて最新のオブジェクトを選択して表示することで、現在のサービスの実行情報、サービス依存関係、およびインテグレーション情報をすばやく確認できます。
関連分析¶
ログでトレース全体のすべてのサービスに関連するログデータを確認できます(関連フィールド:trace_id)。表示列をカスタマイズできます。より詳細なログコンテンツを確認する場合は、ログコンテンツをクリックしてログ詳細ページに移動するか、ジャンプボタンをクリックしてログページで開きます。
システムは、現在のトレースの service、env、version などのフィールドに基づいてログインデックスマッピングを照合し、対応するログインデックスを自動的に選択します。元のインデックスの「サービス一致」設定は、service フィールドマッピングに従って引き続き有効です。
管理者以上の権限がある場合は、関連フィールドをカスタマイズできます。関連フィールドの右側にある設定ボタンをクリックし、表示されたダイアログで関連付けるフィールドを選択します。手動入力やドラッグによる順序変更などの操作に対応しており、確認すると設定が完了します。
注意:関連ログのカスタムフィールドとサービスリストの関連分析設定のカスタムフィールドは相互に影響します。サービスリストでカスタムフィールドを設定した場合、ここにも同期して表示されます。
アプリケーションが ddtrace コレクターを使用し、APM の分散型トレーシングと Profile プロファイリングデータの収集を同時に有効にしている場合、システムは Span レベルでコードホットスポットを関連付けて確認する機能を提供します。実行所要時間、メソッド、および実行時間の割合が含まれます。
Profile 詳細を表示をクリックすると、Profile 詳細ページに移動して、関連するコードをさらに確認できます。
トレース詳細ページでは、ホストで関連ホストのメトリクスビューとプロパティビューを確認できます(関連フィールド:host)。
- メトリクスビュー:このトレースの終了 30 分前から終了後 30 分までの関連ホストのパフォーマンスメトリクスの状態を確認できます。関連ホストの CPU、メモリなどのパフォーマンスメトリクスビューが含まれます。
- プロパティビュー:トレース発生時におけるホストオブジェクトの実際の状態を遡って確認できます。対応する時間内に生成された最新の 1 件のオブジェクトデータを確認でき、ホストの基本情報、インテグレーションの実行状況が含まれます。クラウドホストの収集を有効にすると、クラウドベンダーの情報も確認できます。
注意: Guance は、ホストオブジェクトの直近 48 時間の履歴データをデフォルトで保存します。現在のトレース時刻に対応するホストの履歴データが見つからない場合は、関連ホストのプロパティビューを確認できません。
トレース詳細ページでは、コンテナで関連コンテナのメトリクスビューとプロパティビューを確認できます(関連フィールド:container_name)。
-
メトリクスビュー:このトレースの終了 30 分前から終了後 30 分までの関連コンテナのパフォーマンスメトリクスの状態を確認できます。コンテナの CPU、メモリなどのパフォーマンスメトリクスビューが含まれます。
-
プロパティビュー:トレース発生時におけるコンテナオブジェクトの実際の状態を遡って確認できます。対応する時間内に生成された最新の 1 件のオブジェクトデータを確認でき、コンテナの基本情報、属性情報が含まれます。
トレース詳細ページでは、Pod で関連 Pod のメトリクスビューとプロパティビューを確認できます(関連フィールド:pod_name)。
-
メトリクスビュー:このトレースの終了 30 分前から終了後 30 分までの関連コンテナ Pod のパフォーマンスメトリクスの状態を確認できます。コンテナの CPU、メモリなどのパフォーマンスメトリクスビューが含まれます。
-
プロパティビュー:トレース発生時におけるコンテナ Pod オブジェクトの実際の状態を遡って確認できます。対応する時間内に生成された最新の 1 件のオブジェクトデータを確認でき、コンテナの基本情報、属性情報が含まれます。
Guance では、ネットワークで Host、Pod、Deployment、Service の複数ディメンションにわたるネットワークトポロジービューとサマリーデータを確認できます。
一致フィールド:
詳細ページで関連ネットワークを確認するには、対応する関連フィールドを一致させる必要があります。つまり、データ収集時に対応するフィールドタグを設定する必要があります。設定しない場合、詳細ページで関連するネットワークビューを一致させて確認できません。
-
Host:一致フィールド
host。 -
Pod:
| 一致フィールドの優先順位 |
|---|
| namespace、pod_name |
| namespace、pod |
| pod_name |
| pod |
- Deployment:
| 一致フィールドの優先順位 |
|---|
| namespace、deployment_name |
| namespace、deployment |
| deployment_name |
| deployment |
- Service:
| 一致フィールドの優先順位 |
|---|
| namespace、service_name |
| namespace、service |
注意:
- Host、Pod、Deployment、Service の関連フィールドが同時に見つかった場合、詳細ページに入るとこの順序でネットワークデータが表示されます。
- 関連フィールドが見つからない場合、最後尾に灰色で表示され、クリックするとネットワークビューに一致しませんと表示されます。















