トレース詳細¶
トレースエクスプローラーで任意のトレースをクリックすると、トレース詳細を確認できます。表示内容には、相対時間、所要時間、HTTP メソッド、URL、ステータスコード、TraceId、フレームグラフ、スパンリスト、サービス呼び出し関係、および関連するログ、ホスト、メトリクス、ネットワーク情報が含まれます。フロントエンドアプリケーション(ブラウザなど)の場合は、キュー、ファーストバイト、ダウンロードの所要時間割合を含むリクエスト所要時間の分布も確認できます。
トレース詳細を開くと、ユーザー設定の「トレース詳細デフォルトビュー」の設定に基づいて、ウォーターフォールチャートまたはフレームグラフが優先的に表示されます。
注意
- RUM SDK はバージョン 2.2.10 以降である必要があります。このバージョン未満ではデータが表示されません。また、クロスドメインの場合はヘッダー設定の調整が必要です。
詳細については、Web アプリケーションの導入を参照してください。
- フレームグラフ/スパンリスト/ウォーターフォールチャートに表示できるスパンは最大 10,000 件です。オフセット設定を使用して、表示されていないスパンを確認できます。
フレームグラフ¶
フレームグラフでは、各スパンの流れと実行時間が明確に表示され、右側ではサービスリストと応答時間を確認できます。スパンをクリックすると、トレース詳細で 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
実行された具体的なステートメントと実行時間の詳細は、スパンリストを参照してください。
フレームグラフ内のサービス実行時間割合は、この呼び出しトレースにおいて各サービスが占める総時間の比率を示します。以下の図を例にとると、この呼び出しトレースには CloudCare と Mysql の 2 つのサービスが含まれており、実行時間割合はそれぞれ 42.37% と 57.63% です。CloudCare サービスには 2 つのスパン、Mysql サービスには 10 つのスパンがあります。
- Mysql サービスの実行時間割合の計算方法:すべてのスパンの実行時間を合計し、現在の呼び出しトレースの総時間で割ります。
計算方法の説明:下図の Mysql サービスには合計 10 個のスパンがあります。各スパンをクリックして現在のスパンの実行時間を取得します。図から、このスパンの実行時間は 5.08ms であることがわかります。同様に、残りの 9 個のスパンの実行時間を取得して合計します。
- CloudCare サービスの実行時間割合の計算方法:(現在の呼び出しトレースの総時間 - Mysql サービスの実行時間)/ 現在の呼び出しトレースの総時間
計算方法の説明:下図の CloudCare サービスは現在の呼び出しトレース全体にわたって存在します。Mysql サービスの実行時間を除いた残りの時間が CloudCare サービスの実行時間です(赤線で囲まれた部分の実行時間を参照)。実行時間割合は、スパンリストで各スパンの実行時間と実行時間割合を直接確認することもできます。
スパンリスト¶
- このトレース内のすべてのスパンのリソース名、数、所要時間、実行時間、および割合を表示します。
- リソース名またはスパン ID を入力して検索できます。
- 任意のスパンをクリックすると、トレース詳細で JSON コンテンツを表示でき、フレームグラフに切り替えると同期表示されます。
- エラーがある場合は、エラー通知が表示されます。
- Error Spans をクリックすると、フィルター条件に一致した結果が直接表示されます。
ウォーターフォールチャート¶
各リソース間の親子関係を確認できます。
ウォーターフォールチャートは、開始時間の順にスパンデータを表示します。左側のリストにはスパンデータが表示され、各リソースの実行時間割合が示されます。右側には時間順にウォーターフォールチャートが表示されます。
- スパンに対応するリソース名またはスパン ID を入力して検索できます。
- 左側のリソースをワンクリックで折りたたむ/展開できます。
- をクリックすると、実行時間の表示形式を切り替えられます。
- Error Spans をクリックすると、フィルター条件に一致した結果が直接表示されます。
サービス呼び出し関係¶
異なるサービス間の呼び出し関係と呼び出し回数、および個々のサービスの実行時間、平均所要時間、呼び出し数を全体的に表示します。
任意のサービスノードをクリックすると、詳細情報を表示できます。
- サービス操作とリソース:そのサービスに含まれる具体的な操作(API エンドポイント、メソッドなど)および関連リソースを一覧表示します。
- エラーステータスの追跡:
- そのサービスにエラーが存在する場合、エラー詳細が直接表示されます。
- クリックすると、サービスの親スパンを表示し、上流の呼び出し元を特定できます。
注意
システムは、トレース詳細 > フレームグラフで統計されたサービスに対応する error の結果に基づいて、ここのサービスの色を表示します。
クイック操作¶
操作 |
説明 |
|---|---|
| 全画面表示/デフォルトサイズに戻す | トレース詳細右上の全画面表示アイコン をクリックすると、トレースのフレームグラフを横方向に拡大表示できます。デフォルトサイズに戻すアイコン をクリックすると、詳細ページに戻ります。 |
| 現在のスパンに移動 | クリックすると、ビューを拡大して現在のスパンに移動します。 |
| ミニマップの展開/折りたたみ | トレース詳細左側のミニマップ展開/折りたたみアイコン をクリックすると、ミニマップ上で範囲選択、ドラッグ、スクロールしてフレームグラフをすばやく確認できます。 |
| グローバルトレースの表示 | トレース詳細左側のグローバルトレース表示アイコン をクリックすると、フレームグラフでグローバルトレースを確認できます。 |
| スパンをダブルクリック | フレームグラフ内でそのスパンを中央に拡大表示し、前後の関連スパンをすばやく特定できます。 |
| サービス名をクリック | 対応するスパンがハイライト表示されます。再度サービス名をクリックすると、デフォルトの全スパン選択に戻ります。サービス名をクリックして、対応するスパンをすばやくフィルタリング表示できます。 |
拡張属性¶
- 検索バーにフィールド名や値を入力して、すばやく検索・特定できます。
- フィールドエイリアスをチェックすると、フィールド名の後ろに表示されます。必要に応じて選択できます。
- トレース詳細ページでは、拡張属性で現在のトレースに関連するフィールド属性を確認できます。
フィールド |
属性 |
|---|---|
| フィールド値で絞り込み | このフィールドをエクスプローラーに追加し、このフィールドに関連するすべてのデータを表示します。トレースエクスプローラーでこのフィールドに関連するトレースリストをフィルタリングして表示できます。 図1参照 |
| フィールド値で除外絞り込み | このフィールドをエクスプローラーに追加し、このフィールド以外のデータを表示します。 |
| 表示列に追加 | このフィールドをエクスプローラーリストの表示列に追加します。 |
| コピー | このフィールドをクリップボードにコピーします。 |
一部のフィールドはフィルタリングや集計などのロジックをサポートしていません
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 フィルターオプションをチェックできます。システムは自動的にすべてのエラースパンをハイライト表示します。ハイライト表示された任意のスパンをクリックすると、関連するエラースタックトレース、ログなどの詳細情報を確認できます。
詳細については、エラー追跡を参照してください。
サービスコンテキスト¶
インフラストラクチャリソースカタログからオブジェクト分類を取得し、create_time に基づいて最新のオブジェクトを選択して表示することで、現在のサービスの実行情報、サービス依存関係、および統合情報をすばやく確認できます。
関連分析¶
ログを使用して、トレース全体のすべてのサービスに関連するログデータを確認できます(関連フィールド:trace_id)。表示列はカスタマイズできます。より詳細なログ内容を確認する必要がある場合は、ログ内容をクリックしてログ詳細ページに移動するか、ジャンプボタンをクリックしてログページを開くことができます。
システムは、現在のトレースの service、env、version などのフィールドに基づいてログインデックスマッピングを照合し、対応するログインデックスを自動的に選択します。元のインデックス「サービス一致」設定は、service フィールドマッピングに従って引き続き有効です。
管理者以上の権限を持つユーザーは、関連フィールドをカスタマイズできます。関連フィールドの右側にある設定ボタンをクリックし、表示されるダイアログで関連付けるフィールドを選択します。手動入力やドラッグによる順序変更などが可能で、確認後設定が完了します。
注意:関連ログのカスタムフィールドとサービスリストの関連分析設定のカスタムフィールドは相互に影響します。サービスリストでカスタムフィールドを設定した場合、ここでも同期して表示されます。
アプリケーションが ddtrace コレクターを使用して、APM 分散型トレーシングとプロファイリングデータ収集の両方を有効にしている場合、システムはスパンレベルでのコードホットスポットの関連表示を提供します。これには、実行所要時間、メソッド、実行時間割合が含まれます。
プロファイル詳細を表示をクリックすると、プロファイル詳細ページに移動して、さらに関連するコードを確認できます。
トレース詳細ページでは、ホストを使用して、関連ホストのメトリクスビューとプロパティビューを確認できます(関連フィールド:host)。
- メトリクスビュー:関連ホストのトレース終了前 30 分からトレース終了後 30 分までのパフォーマンスメトリクス状態を確認できます。これには、関連ホストの CPU、メモリなどのパフォーマンスメトリクスビューが含まれます。
- プロパティビュー:トレース発生時のホストオブジェクトの実際の状態を追跡するのに役立ちます。関連ホストの対応する時間内に生成された最新の 1 つのオブジェクトデータを表示できます。これには、ホストの基本情報、統合実行状況が含まれます。クラウドホストの収集が有効になっている場合は、クラウドプロバイダーの情報も表示できます。
注意: Guance は、ホストオブジェクトの最近 48 時間の履歴データをデフォルトで保存します。現在のトレース時間に対応するホスト履歴データが見つからない場合、関連ホストのプロパティビューは表示できません。
トレース詳細ページでは、コンテナを使用して、関連コンテナのメトリクスビューとプロパティビューを確認できます(関連フィールド:container_name)。
-
メトリクスビュー:関連コンテナのトレース終了前 30 分からトレース終了後 30 分までのパフォーマンスメトリクス状態を確認できます。これには、コンテナの CPU、メモリなどのパフォーマンスメトリクスビューが含まれます。
-
プロパティビュー:トレース発生時のコンテナオブジェクトの実際の状態を追跡するのに役立ちます。関連コンテナの対応する時間内に生成された最新の 1 つのオブジェクトデータを表示できます。これには、コンテナの基本情報、プロパティ情報が含まれます。
トレース詳細ページでは、Pod を使用して、関連 Pod のプロパティビューとメトリクスビューを確認できます(関連フィールド:pod_name)。
-
メトリクスビュー:関連コンテナ Pod のトレース終了前 30 分からトレース終了後 30 分までのパフォーマンスメトリクス状態を確認できます。これには、コンテナの CPU、メモリなどのパフォーマンスメトリクスビューが含まれます。
-
プロパティビュー:トレース発生時のコンテナ Pod オブジェクトの実際の状態を追跡するのに役立ちます。関連コンテナ 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 の関連フィールドが同時に検出された場合、詳細ページに入るときはこの順序でネットワークデータが表示されます。
- 関連フィールドが検出されなかった場合は、末尾にグレー表示され、クリックするとネットワークビューにマッチングしませんでしたと表示されます。
















