AWS X-Ray コンソール - AWS X-Ray

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

AWS X-Ray コンソール

-AWS X-Rayコンソールでは、サービスマップと、アプリケーションが処理するリクエストの関連付けられたトレースを表示できます。

コンソールのサービスマップは、アプリケーションによって生成されたトレースデータから X-Ray が生成した JSON サービスグラフをビジュアルに表現したものです。

マップは、リクエストを処理するアカウント内の各アプリケーションのサービスノード、リクエストの送信元を示すアップストリームクライアントノード、リクエストの処理中にアプリケーションが使用するウェブサービスとリソースを示すダウンストリームサービスノードで構成されます。

フィルタを使用して、特定のリクエスト、サービス、2 つのサービス間の接続 (エッジ)、または条件を満たすリクエストのサービスマップまたはトレースを表示できます。X-Ray にはフィルタ式言語があり、リクエストヘッダー、レスポンスステータス、元セグメントのインデックス付きフィールドのデータに基づいて、リクエスト、サービス、エッジをフィルタリングできます。

注記

X-Ray サービスマップは、最大 10,000 個のノードを表示できます。サービスノードの総数がこの制限を超えるまれなシナリオでは、エラーが発生し、コンソールに完全なサービスマップを表示できないことがあります。

サービスマップの表示

X-Ray コンソールでサービスマップを表示して、エラーが発生しているサービス、高レイテンシーの接続、失敗したリクエストのトレースを識別します。

サービスマップを表示するには

  1. [X-Ray console (X-Ray コンソール)] を開きます。デフォルトでは、サービスマップが表示されます。または、[] を選択することもできます。サービスマップ左のナビゲーションペインから。

    注記

    Amazon 内でサービスマップを表示できるようになりました CloudWatch console. を開くCloudWatch コンソールを選択し、サービスマップX-Ray トレース左のナビゲーションペインから。X-Ray コンソールを引き続き使用することもできます。

    
            X-Ray コンソールサービスマップページ
  2. そのノードのリクエスト、または 2 つのノード間のエッジを表示するサービスノードを選択して、やり取りされた接続のリクエストを表示します。

  3. ヒストグラムを使用して、期間ごとにトレースをフィルタリングし、トレースを表示するステータスコードを選択します。[View traces (トレースの表示)] を選択し、フィルタ式を適用してトレースリストを開きます。

    [] 内のCloudWatch コンソールで、X-Ray サービスマップでサービスノードを選択し、メトリック、アラート、応答時間分布のタブなどの追加情報を表示します。リポジトリの []メトリクスタブで、各グラフ内の範囲を選択してドリルダウンして詳細を表示するか、障害またはエラートレースをフィルタリングするオプション。リポジトリの []応答時間ディストリビューションタブで、応答時間でトレースをフィルタリングするグラフ内の範囲を選択します。トレースは、[] を選択していつでも表示できます。トレースの表示または、フィルタが適用されている場合は、フィルタリングされたトレースの表示

このサービスマップは、各ノードの状態をエラーと障害に対する正常な呼び出しの比率に基づいて色分けしたものです。

  • は、正常な呼び出し

  • は、サーバー障害 (500 系のエラー)

  • は、クライアントエラー (400 系のエラー)

  • は、スロットリングエラー (429 リクエストが多すぎる)

各ノードの中央には、選択した時間帯に平均レスポンス時間と 1 分間に送信したトレース数がコンソールに表示されます。

サービスマップが大きい場合、コンソールはデフォルトで縮小ビューになります。拡大/縮小したりイメージを移動したりするには、画面のコントロールまたはマウスを使用します。

コントロール

  • – 拡大または縮小。マウスホイールを使用して拡大/縮小することもできます。

  • – サービスマップをスクロールします。クリックしてドラッグし、マウスを使用してスクロールします。

  • – 選択したノードまたはエッジをマップの中央にはめ込みます。

グループ別のサービスマップの表示

フィルタ式を使用すると、グループへのトレースを受け入れる基準を定義できます。次のステップに従って、サービスマップにその特定のグループを表示します。

グループのサービスマップを表示するには

  1. X-Ray コンソールの「サービスマップページ」を開きます。

  2. 検索バーの左側にあるドロップダウンメニューからグループ名を選択します。

ノード表示の変更

次のオプションを使用して、サービスマップの表示方法を変更します。サービスアイコンをオンにすると、サービスのストリームをより適切に追跡できます。また、ノードの重みを変更して、トラフィックや正常性をより適切に表すことができます。

ノード表示を変更するには

  1. X-Rayコンソールのサービスマップページまたは個別のトレースマップを開きます。

    ノードオプションはマップの右下にあります。

  2. ノードの表示を選択します。

    Service Icons enabled

    サービスアイコン – 有効にすると、デフォルトのアクティビティの概要ではなく、ノードによって表現される AWS サービスのアイコンが表示されます。

    Node weight by None

    なし – ノードのサイズ変更はなく、すべてのノードの重みは同じです。

    Node weight by Health

    ヘルス – ノードサイズは、影響を受けるリクエストの総数によって計算されます。影響を受けるリクエストには、faulterrorthrottle があります。たとえば、1,000 個のサンプルのうち影響を受けたリクエストの合計がノードの 10% (100 個) であるノードサイズは、100 個のサンプルのうち影響を受けたリクエストの合計がノードの 50% のみ (50 個) であるノードサイズよりも大きくなります。

    Node weight by Traffic

    トラフィック – ノードサイズは、サンプリングされたリクエストの総数に基づいて計算されます。たとえば、1,000 個のサンプルリクエストがあるノードは、100 個のサンプルリクエストのあるノードよりも大きくなります。

トレースの表示

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を開き、 CloudWatch コンソールに追加します。https://console.aws.amazon.com/cloudwatch/

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

  3. でクエリを絞り込むクエリ絞り込みセクションに追加します。[] オプションから選択できます。クエリを絞り込むメニュー、ノード、URL、および追加のフィルタでフィルタリングします。使用可能なフィルタ値のリストがすぐ下に表示されます。1 つ以上のエントリを選択し、クエリに追加をクリックして、フィルタ式にページの上部にあります。

    
                  フィルタリングトレース
  4. 選択クエリを実行する内の一致するトレースのリストをいつでも表示できます。トレース] セクションに、[] を選択します。

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

    
                  トレース ID を選択してトレースのトレースマップとタイムラインを表示

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


        セグメントおよびサブセグメントの階層を示すタイムライン表示 (セグメントはリスト内の最初のエントリとして使用)

セグメントの下にサブセグメントがあります。この例では、計測機器を備えた Amazon DynamoDB クライアントによって記録されたサブセグメントとカスタムサブセグメントを表示しています。


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

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

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


        トレースを構成するすべてのセグメントおよびサブセグメントを含む raw データの JSON ドキュメント

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

トレースタイムラインから、詳細を表示するセグメントの名前を選択します。[概要] タブには、リクエストと応答に関する情報が表示されます。


        リクエストとレスポンスに関する情報を示すトレースタイムラインのセグメント概要

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


        アプリケーションと X-Ray SDK を実行している AWS リソースに関する情報を表すセグメントの [リソース] タブ

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


        セグメントに関する追加情報を示す [注釈] タブ

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

トレースタイムラインから、詳細を表示するセグメントの名前を選択します。計測されたクライアントを使用して生成されたサブセグメントについては、[概要] タブにアプリケーションの視点からのリクエストと応答に関する情報が含まれています。この例では、計測された呼び出しから DynamoDB へのサブセグメントを示しています。


        DynamoDB の計測された呼び出しのサブセグメント情報

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


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

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


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

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


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

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