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

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

トレースの表示

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 つのトレースのトレース詳細ページが表示されます。トレースに関係するノードを示すトレースマップが、トレースの概要とトレースセグメントのタイムラインとともに表示されます。

   

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

X-Ray console

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

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

   

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

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

   

トレースタイムラインの調査

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

CloudWatch console

X-Ray console

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

計測された 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 にシリアル化し、セグメントドキュメントに追加します。