イベント駆動型アプリケーションのトレース

AWS X-Ray は、Amazon SQS および を使用したイベント駆動型アプリケーションのトレースをサポートしています AWS Lambda。 CloudWatch コンソールを使用して、Amazon SQS でキューに入れられ、1 つ以上の Lambda 関数によって処理される各リクエストの接続されたビューを表示します。アップストリームメッセージプロデューサーからのトレースは、ダウンストリーム Lambda コンシューマーノードからのトレースに自動的にリンクされ、アプリケーションの end-to-end ビューが作成されます。

注記

各トレースセグメントは最大 20 のトレースにリンクできます。また、1 つのトレースには最大 100 のリンクを含めることができます。シナリオによっては、追加のトレースをリンクするとトレースドキュメントの最大サイズを超え、トレースが不完全になる可能性があります。例えば、トレーシングが有効になっている Lambda 関数が 1 回の呼び出しで多数の SQS メッセージをキューに送信した場合に発生することがあります。この問題が発生した場合は、X-Ray SDK を使用する緩和策があります。詳細については、Java、Node.js、Python、Go、または .NET 用の X-Ray SDK を参照してください。

リンクされたトレースをトレースマップに表示する

CloudWatch コンソールのトレースマップページを使用して、Lambda コンシューマーからのトレースにリンクされているメッセージプロデューサーからのトレースを含むトレースマップを表示します。これらのリンクは、Amazon SQS ノードとダウンストリーム Lambda コンシューマーノードを接続する破線のエッジで表示されます。

破線のエッジを選択すると、[受け取ったイベントが発生してから経過した時間]ヒストグラムが表示されます。これは、コンシューマーが受け取ったイベントの経過時間の分布をマッピングしたものです。経過時間は、イベントを受信するたびに計算されます。

リンクされたトレースの詳細の表示

メッセージプロデューサー、Amazon SQS キュー、または Lambda コンシューマーから送信されたトレースの詳細を表示します。

1. トレースマップを使用して、メッセージプロデューサー、Amazon SQS、または Lambda コンシューマーノードを選択します。

2. ノードの詳細ペインから [トレースを表示] を選択すると、トレースのリストが表示されます。 CloudWatch コンソール内のトレースページに直接移動することもできます。

3. リストから特定のトレースを選択し、トレースの詳細ページを開きます。選択したトレースが、リンクされたトレースセットの一部である場合、トレースの詳細ページにメッセージが表示されます。

   

トレースの詳細マップには、現在のトレースと、アップストリームおよびダウンストリームのリンクされたトレースが表示されます。各トレースは、各トレースの境界を示すボックスに含まれています。現在選択されているトレースがアップストリームまたはダウンストリームの複数のトレースにリンクされている場合、アップストリームまたはダウンストリームにリンクされているトレース内のノードは積み重ねられ、[トレースを選択] ボタンが表示されます。

トレースの詳細マップの下に、アップストリームとダウンストリームのリンクされたトレースを含むトレースセグメントのタイムラインが表示されます。アップストリームまたはダウンストリームにリンクされたトレースが複数ある場合、それらのセグメントの詳細は表示できません。リンクされたトレースセット内の 1 つのトレースのセグメント詳細を表示するには、以下の説明に従って 1 つのトレースを選択します。

リンクされたトレースのセットから 1 つのトレースを選択

リンクされたトレースセットを 1 つのトレースにフィルタリングすると、タイムラインにセグメントの詳細が表示されます。

1. トレースの詳細マップのリンクされたトレースの下でトレースを選択を選択します。トレースのリストが表示されます。

   

2. トレースの横にあるラジオボタンを選択して、トレースの詳細マップ内に表示します。

3. [トレースの選択をキャンセル] を選択すると、リンクされたトレースのセット全体が表示されます。