トレースの表示トレースのタイムラインの探索セグメントの詳細を表示するサブセグメントの詳細を表示する

トレースとトレースの詳細の表示

X-Ray コンソールのトレースページを使用して、、URLレスポンスコード、またはその他のデータをトレースサマリーから検索します。トレースリストからトレースを選択すると、トレースの詳細ページには、選択したトレースに関連付けられているサービスノードのマップとトレースセグメントのタイムラインが表示されます。

トレースの表示

CloudWatch console

CloudWatch コンソールでトレースを表示するには

にサインイン AWS Management Console し、で CloudWatch コンソールを開きますhttps://console.aws.amazon.com/cloudwatch/。
左側のナビゲーションペインで、X-Ray トレース を選択し、トレース を選択します。グループでフィルタリングするか、フィルター式を入力できます。これにより、ページの下部にあるトレースセクションに表示されるトレースがフィルタリングされます。

または、サービスマップを使用して特定のサービスノードに移動し、トレースを表示することもできます。これにより、クエリが既に適用されているトレースページが開きます。
[クエリリファイナー] セクションでクエリを絞り込みます。共通の属性でトレースをフィルタリングするには、 でクエリを絞り込むの横にある下矢印からオプションを選択します。オプションは以下のとおりです。
- Node – サービスノードでトレースをフィルタリングします。
- リソース ARN – トレースに関連付けられたリソースでトレースをフィルタリングします。これらのリソースの例としては、Amazon Elastic Compute Cloud (Amazon EC2) インスタンス、 AWS Lambda 関数、 Amazon DynamoDB テーブルなどがあります。
- ユーザー – ユーザー ID でトレースをフィルタリングします。
- エラーの根本原因メッセージ — エラーの根本原因でトレースをフィルタリングします。
- URL – アプリケーションで使用されるURLパスでトレースをフィルタリングします。
- HTTP status code – アプリケーションから返されたHTTPステータスコードでトレースをフィルタリングします。カスタムレスポンスコードを指定するか、以下から選択できます。
  - 200 – リクエストは成功しました。
  - 401 – リクエストに有効な認証情報がありません。
  - 403 – リクエストに有効なアクセス許可がありませんでした。
  - 404 – サーバーはリクエストされたリソースを見つけることができませんでした。
  - 500 – サーバーで予期しない状態が発生し、内部エラーが発生しました。
1 つ以上のエントリを選択し、クエリに追加 を選択して、ページ上部のフィルター式に追加します。
1 つのトレースを検索するには、トレース ID をクエリフィールドに直接入力します。X-Ray 形式または World Wide Web Consortium (W3C) 形式を使用できます。例えば、 AWS Distro for OpenTelemetryを使用して作成されたトレースは W3C 形式です。

注記
W3C-formatトレース ID で作成されたトレースをクエリすると、コンソールには一致するトレースが X-Ray 形式で表示されます。例えば、W3C 形式で 4efaaf4d1e8720b39541901950019ee5をクエリすると、コンソールに X-Ray に相当するが表示されます1-4efaaf4d-1e8720b39541901950019ee5。
[クエリを実行] を選択すると、いつでもページ下部の [トレース] セクションに一致するトレースのリストが表示されます。
1 つのトレースのトレース詳細ページを表示するには、リストからトレース ID を選択します。

次の図は、トレースに関連付けられたサービスノードと、トレースを構成するセグメントによって取得されるパスを表すノード間のエッジを含むトレースマップを示しています。トレースの概要は、トレースマップ の後に続きます。概要には、サンプルGETオペレーション、レスポンスコード 、トレースの実行にかかった時間、およびリクエストの経過時間に関する情報が含まれます。セグメントタイムラインは、トレースセグメントとサブセグメントの期間を示すトレースサマリーに従います。

Amazon SQSと Lambda を使用するイベント駆動型アプリケーションがある場合は、トレースマップ で各リクエストのトレースの接続されたビューを確認できます。マップでは、メッセージプロデューサーからのトレースは AWS Lambda コンシューマーからのトレースにリンクされ、破線のエッジとして表示されます。イベント駆動型アプリケーションの詳細については、「」を参照してくださいイベント駆動型アプリケーションのトレース。

トレースページとトレースの詳細ページでは、クロスアカウントトレースもサポートされています。クロスアカウントトレースでは、トレースリストおよび 1 つのトレースマップ内の複数のアカウントのトレースを一覧表示できます。

X-Ray console

X-Ray コンソールでトレースを表示するには

X-Ray コンソールのトレースページを開きます。トレースの概要パネルには、エラーの根本原因、リソース 、などの一般的な機能別にグループ化されたトレースのリストが表示されますInstanceId。 ARN
トレースのグループ化されたセットを表示する共通機能を選択するには、グループ化 の横にある下矢印を展開します。次の図は、の URL でグループ化されたトレースのトレースの概要とAWS X-Ray サンプルアプリケーション、関連するトレースのリストを示しています。
トレースの ID を選択して、トレースリスト の下に表示されます。ナビゲーションペインでサービスマップを選択して、特定のサービスノードのトレースを表示することもできます。その後、そのノードに関連付けられているトレースを表示できます。

タイムラインタブにはトレースのリクエストフローが表示され、以下が含まれます。
- トレース内の各セグメントのパスのマップ。
- セグメントがトレースマップ内のノードに到達するまでにかかる時間。
- トレースマップ内のノードに対して行われたリクエストの数。
次の図は、サンプルアプリケーションに対して行われたGETリクエストに関連付けられたトレースマップの例を示しています。矢印は、各セグメントがリクエストを完了するために取ったパスを示しています。サービスノードには、リクエスト中に行われたGETリクエストの数が表示されます。

タイムラインタブの詳細については、次のトレースタイムラインの探索セクションを参照してください。

Raw データタブには、トレースに関する情報と、トレースを構成するセグメントとサブセグメントが JSON 形式で表示されます。この情報には以下が含まれます。
- タイムスタンプ
- 一意 IDs
- セグメントまたはサブセグメントに関連付けられたリソース
- セグメントまたはサブセグメントのソースまたはオリジン
- リクエストからのレスポンスなど、アプリケーションへのHTTPリクエストに関する追加情報

トレースのタイムラインの探索

タイムラインセクションには、タスクの完了に使用された時間に対応する水平バーの横にあるセグメントとサブセグメントの階層が表示されます。リスト内の最初のエントリは、1 回のリクエストに対してサービスによって記録されたすべてのデータを表すセグメントです。サブセグメントはインデントされ、セグメントの後に一覧表示されます。列には、各セグメントに関する情報が含まれます。

CloudWatch console

CloudWatch コンソールでは、セグメントタイムラインに次の情報が表示されます。

最初の列: 選択したトレースのセグメントとサブセグメントを一覧表示します。
セグメントステータス列: 各セグメントとサブセグメントのステータス結果を一覧表示します。
レスポンスコード列: セグメントまたはサブセグメントによって行われたブラウザリクエストに対するHTTPレスポンスステータスコードが使用可能な場合に一覧表示します。
Duration 列: セグメントまたはサブセグメントが実行された時間を一覧表示します。
Hosted in 列: 必要に応じて、セグメントまたはサブセグメントが実行されている名前空間または環境を一覧表示します。詳細については、「収集されたディメンション」と「ディメンションの組み合わせ」を参照してください。
最後の列: タイムライン内の他のセグメントまたはサブセグメントに関連して、セグメントまたはサブセグメントが実行された期間に対応する水平バーを表示します。

セグメントとサブセグメントのリストをサービスノード別にグループ化するには、ノードごとにグループ化をオンにします。

X-Ray console

トレースの詳細ページで、タイムラインタブを選択すると、トレースを構成する各セグメントとサブセグメントのタイムラインが表示されます。

X-Ray コンソールでは、タイムラインは次の情報を提供します。

名前列: トレース内のセグメントとサブセグメントの名前を一覧表示します。
Res. 列: 利用可能な場合、セグメントまたはサブセグメントによって行われたブラウザリクエストに対するHTTPレスポンスステータスコードを一覧表示します。
Duration 列: セグメントまたはサブセグメントが実行された時間を一覧表示します。
ステータス列: セグメントまたはサブセグメントのステータスの結果を一覧表示します。
最後の列: タイムライン内の他のセグメントまたはサブセグメントに関連して、セグメントまたはサブセグメントが実行された期間に対応する水平バーを表示します。

コンソールがタイムラインの生成に使用する未加工のトレースデータを表示するには、未加工のデータタブを選択します。raw データには、トレースに関する情報と、トレースを構成するセグメントとサブセグメントが JSON 形式で表示されます。この情報には以下が含まれます。

タイムスタンプ
一意 IDs
セグメントまたはサブセグメントに関連付けられたリソース
セグメントまたはサブセグメントのソースまたはオリジン
リクエストからのレスポンスなど、アプリケーションへのHTTPリクエストに関する追加情報。

計測された AWS SDK、HTTP、または SQLクライアントを使用して外部リソースを呼び出すと、X-Ray はサブセグメントを自動的にSDK記録します。X-Ray を使用してSDK、任意の関数またはコードブロックのカスタムサブセグメントを記録することもできます。カスタムサブセグメントが開いている間に記録される追加のサブセグメントは、カスタムサブセグメントの子になります。

セグメントの詳細を表示する

トレースタイムライン からセグメントの名前を選択して、その詳細を表示します。

セグメントの詳細パネルには、概要、リソース 、注釈、メタデータ 、例外、および SQLタブが表示されます。以下が適用されます。

[概要] タブには、リクエストと応答に関する情報が表示されます。情報には、名前、開始時刻、終了時刻、期間、リクエスト URL、リクエストオペレーション、リクエストレスポンスコード、エラーと障害が含まれます。
セグメントのリソースタブには、X-Ray からの情報SDKと、アプリケーションを実行している AWS リソースに関する情報が表示されます。X-Ray の Amazon EC2 AWS Elastic Beanstalk、、または Amazon ECSプラグインSDKを使用して、サービス固有のリソース情報を記録します。プラグインの詳細については、「」の「サービスプラグイン」セクションを参照してくださいX-Ray SDK for Java の設定。
残りのタブには、セグメントに記録された注釈、メタデータ 、および例外が表示されます。例外は、計測されたリクエストから生成されたときに自動的にキャプチャされます。注釈とメタデータには、X-Ray SDKが提供するオペレーションを使用して記録する追加情報が含まれています。セグメントに注釈またはメタデータを追加するには、X-Ray を使用しますSDK。詳細については、「」の「を使用した AWS X-Ray SDKsアプリケーションの計測」に記載されている言語固有のリンクを参照してくださいのアプリケーションの計測 AWS X-Ray。

サブセグメントの詳細を表示する

トレースタイムラインから、詳細を表示するサブセグメントの名前を選択します。

概要タブには、リクエストとレスポンスに関する情報が含まれています。これには、名前、開始時刻、終了時刻、期間、リクエスト URL、リクエストオペレーション、リクエストレスポンスコード、エラーと障害が含まれます。計測されたクライアントを使用して生成されたサブセグメントについては、[概要] タブにアプリケーションの視点からのリクエストと応答に関する情報が含まれています。
サブセグメントのリソースタブには、 AWS サブセグメントの実行に使用されたリソースの詳細が表示されます。例えば、リソースタブには、 AWS Lambda 関数 ARN、DynamoDB テーブルに関する情報、呼び出されるオペレーション、およびリクエスト ID が含まれる場合があります。
残りのタブには、サブセグメントに記録された注釈、メタデータ 、および例外が表示されます。例外は、計測されたリクエストから生成されたときに自動的にキャプチャされます。注釈とメタデータには、X-Ray SDKが提供するオペレーションを使用して記録する追加情報が含まれています。X-Ray SDKを使用して、セグメントに注釈またはメタデータを追加します。詳細については、「」の「 を使用した AWS X-Ray アプリケーションの計測SDKs」に記載されている言語固有のリンクを参照してくださいのアプリケーションの計測 AWS X-Ray。

カスタムサブセグメントの場合、[概要] タブには記録するコードまたは関数の領域を指定するために設定できるサブセグメントの名前が表示されます。詳細については、「」の「 を使用したアプリケーションの計測 AWS X-Ray SDKs」に記載されている言語固有のリンクを参照してくださいX-Ray SDK for Java を使用したカスタムサブセグメントの生成。

次の図は、カスタムサブセグメントの概要タブを示しています。概要には、サブセグメント ID、親 ID、名前、開始時刻と終了時刻、期間、ステータス、エラーまたは障害が含まれます。

カスタムサブセグメントのメタデータタブには、そのサブセグメントで使用されるリソースに関する情報が JSON 形式で含まれます。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

トレースマップ

フィルタ式