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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

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

トレースの表示

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

  1. X-Ray コンソールのトレースページを開きます。サービスマップを使用して特定のサービスノードに移動してトレースを表示することもできます。これにより、フィルター式がすでに適用されたトレースページが表示されます。

    トレースサマリから URL、レスポンスコード、またはその他のデータでトレースを検索するための X-Ray コンソールのトレースリスト

  2. トレースリストをフィルタリングする URL を選択します。

  3. トレース ID を選択すると、トレースのトレースマップとタイムラインが表示されます。

    トレース ID を選択すると、トレースのトレースマップとタイムラインが表示されます。
CloudWatch console
CloudWatch コンソールでトレースを表示するには

  1. にサインインしてAWS Management Console、https://console.aws.amazon.com/cloudwatch/ CloudWatch でコンソールを開きます。

  2. 左側のナビゲーションペインの [X-Ray トレース] で [トレース] を選択します。「トレース」ページでは、グループでフィルタリングできます。また、オプションでフィルター式を入力して、ページ下部のトレースセクションに表示されるトレースをフィルタリングできます。

  3. サービスマップを使用して特定のサービスノードに移動してトレースを表示することもできます。これにより、クエリがすでに適用されたトレースページが表示されます。

  4. 「クエリリファイナー」セクションでクエリを絞り込みます。「クエリを絞り込む」メニューからオプションを選択して、ノード、URL、その他のフィルターでフィルタリングできます。使用可能なフィルター値のリストがすぐ下に表示されます。1 つまたは複数のエントリを選択し、[クエリに追加] を選択して、ページ上部のフィルター式に追加します。

    トレースをフィルタリング

  5. [クエリをいつでも実行] を選択すると、ページ下部の [トレース] セクションに一致するトレースのリストが表示されます。

  6. リストからトレース ID を選択すると、1 つのトレースのトレース詳細ページが表示されます。トレースに関係するノードを示すトレースマップが、トレースの概要とトレースセグメントのタイムラインとともに表示されます。

    トレース ID を選択すると、トレースのトレースマップとタイムラインが表示されます。

    トレース詳細ページには、Amazon SQS と Lambda を使用するイベント駆動型アプリケーション全体のトレースの接続ビューが表示されます。詳細については、「イベント駆動型アプリケーションのトレース」を参照してください。トレースとトレースの詳細ページでは、クロスアカウントトレースもサポートされており、複数のアカウントからのトレースをトレースリストと 1 つのトレースマップに表示できます。

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

タイムラインセクションには、セグメントとサブセグメントの階層が表示されます。リスト内の最初のエントリは、1 回のリクエストに対してサービスによって記録されたすべてのデータを表すセグメントです。セグメントの下にサブセグメントがあります。

X-Ray console
計測された Amazon DynamoDB クライアントによって記録されたサブセグメントのタイムライン表示

タイムラインビューから、コンソールがタイムラインを生成するために使用する未加工のトレースデータにアクセスすることもできます。[Raw data (raw データ)] を選択して、トレースを構成するすべてのセグメントとサブセグメントを含む JSON 文書を表示します。

トレースを構成するすべてのセグメントおよびサブセグメントを含む raw データの JSON ドキュメント
CloudWatch console
計測された Amazon DynamoDB クライアントによって記録されたサブセグメントのタイムライン表示

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

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

トレースタイムラインから、詳細を表示するセグメントの名前を選択します。セグメント情報を表示するタブは複数あります。

セグメント詳細ウィンドウ

  • [概要] タブには、リクエストと応答に関する情報が表示されます。

  • セグメントの [リソース] タブには、アプリケーションと X-Ray SDK を実行しているAWSリソースに関する情報が表示されます。SDK用のAmazon EC2、AWS Elastic Beanstalk または Amazon ECS プラグインを使用して、サービス固有のリソース情報を記録します。

  • その他のタブには、セグメントに記録されている [Annotations]、[Metadata]、[Exceptions] が表示されます。計測されたリクエストからスローされると、Exceptions が自動的にキャプチャされます。Annotations と Metadata には、SDK が提供するメソッドを使用して記録する追加情報が含まれています。

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

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

  • 計測されたクライアントを使用して生成されたサブセグメントについては、[概要] タブにアプリケーションの視点からのリクエストと応答に関する情報が含まれています。

  • サブセグメントの [リソース] タブには、DynamoDB テーブル、呼び出されたオペレーション、およびリクエスト ID の詳細が示されます。

カスタムサブセグメントの場合、[概要] タブには記録するコードまたは関数の領域を指定するために設定できるサブセグメントの名前が表示されます。

カスタムサブセグメントに関する概要情報

カスタムサブセグメントを使用して、計測されたクライアントからのサブセグメントをグループに整理します。サブセグメントにメタデータと注釈を記録して、デバッグ機能に役立てることもできます。

関数のデバッグに役立つカスタムサブセグメントのメタデータの記録

この例では、アプリケーションは、DynamoDB に保存する各 Game オブジェクトの状態を記録します。これは、オブジェクトをサブセグメント上の putMetadata メソッドに渡すことによって行います。X-Ray SDK はオブジェクトを JSON にシリアル化し、セグメントドキュメントに追加します。