X-Ray トレースマップの使用

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

注記

CloudWatch に Application Signals が追加されました。これにより、アプリケーションサービス、クライアント、合成 Canary、およびサービスの依存関係を検出してモニタリングできます。Application Signals を使用すると、サービスのリストやビジュアルマップを確認したり、サービスレベル目標 (SLO) に基づくヘルスメトリクスを表示したり、ドリルダウンして相関関係のある X-Ray トレースを確認したりして、より詳細なトラブルシューティングを行うことができます。

X-Ray サービスマップと CloudWatch ServiceLens マップは、Amazon CloudWatch コンソール内の X-Ray トレースマップに結合されます。CloudWatch コンソールを開き、左側のナビゲーションペインから X-Ray トレースの下にあるトレースマップを選択します。

トレースマップの表示

トレースマップは、アプリケーションによって生成されたトレースデータを視覚的に表現したものです。リクエストを処理するサービスノード、リクエストの送信元を示すアップストリームクライアントノード、リクエストの処理中にアプリケーションが使用するウェブサービスとリソースを示すダウンストリームサービスノードがマップに表示されます。

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

CloudWatch console

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

1. CloudWatch コンソールを開きます。左ナビゲーションペインの X-Ray トレースセクションでトレースマップを選択します。

   

2. そのノードのリクエスト、または 2 つのノード間のエッジを表示するサービスノードを選択して、やり取りされた接続のリクエストを表示します。

3. メトリクス、アラート、応答時間分布のタブなど、追加情報がトレースマップの下に表示されます。メトリクスタブで、各グラフ内の範囲を選択して詳細を表示するか、障害またはエラーオプションを選択してトレースをフィルタリングします。[応答時間の分布] タブでは、応答時間でトレースをフィルタリングするグラフ内の範囲を選択します。

   

4. [トレースを表示] を選択してトレースを表示するか、フィルターが適用されている場合は [フィルタリングされたトレースの表示] を選択します。

5. ログの表示 を選択すると、選択したノードに関連付けられた CloudWatch ログが表示されます。すべてのトレースマップノードがログの表示をサポートしているわけではありません。詳細については、「 CloudWatch ログのトラブルシューティング」を参照してください。

トレースマップは、色で概説することで、各ノード内の問題を示します。

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

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

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

トレースマップが大きい場合は、画面上のコントロールまたはマウスを使用して、マップを拡大/縮小したり、マップを移動したりできます。

X-Ray console

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

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

   

2. そのノードのリクエスト、または 2 つのノード間のエッジを表示するサービスノードを選択して、やり取りされた接続のリクエストを表示します。

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

   

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

• 緑は、正常な呼び出し

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

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

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

サービスマップが大きい場合は、画面のコントロールまたはマウスを使用して、マップを拡大/縮小したり移動したりします。

注記

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

グループによるトレースマップのフィルタリング

フィルター式を使用すると、グループに含めるトレースの基準を定義できます。トレースマップにその特定のグループを表示するには、次のステップを実行します。

CloudWatch console

トレースマップの左上にあるグループフィルターからグループ名を選択します。

X-Ray console

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

これで、サービスマップがフィルタリングされ、選択したグループのフィルター式と一致するトレースが表示されます。

トレースマップの凡例とオプション

トレースマップには、マップ表示をカスタマイズするための凡例といくつかのオプションが含まれています。

CloudWatch console

マップの右上にある [凡例とオプション] ドロップダウンを選択します。以下のノード内に表示する内容を選択します。

• メトリクスには、選択した時間範囲の平均応答時間と 1 分あたりに送信されたトレース数が表示されます。

• ノードには、各ノード内のサービスアイコンが表示されます。

[設定] ペインから追加のマップ設定を選択します。このペインには、マップの右上にある歯車アイコンからアクセスできます。これらの設定には、各ノードのサイズを決定するために使用するメトリクスや、マップに表示する Canary の選択などがあります。

X-Ray console

サービスマップの凡例を表示するには、マップの右上にある [マップの凡例] リンクを選択します。サービスマップオプションは、トレースマップの右下で次のように選択できます。

• サービスアイコン 各ノード内の表示内容を切り替えて、サービスアイコンを表示するか、または選択した時間範囲の平均応答時間と 1 分あたりに送信されたトレース数を表示します。

• ノードサイズ : なし すべてのノードを同じサイズに設定します。

• ノードサイズ : ヘルス エラー、障害、スロットリングされたリクエストなど、影響を受けるリクエストの数に応じてノードのサイズを設定します。

• ノードサイズ : トラフィック リクエストの合計数に応じてノードのサイズを設定します。