Amazon と EventBridge の統合 AWS X-Ray

を使用して AWS X-Ray 、元のトレースヘッダーをターゲットに EventBridge EventBridge パススルーするイベントをトレースAmazon のイベントバスターゲット EventBridge し、ターゲットサービスが追跡、分析、デバッグできるようにします。

EventBridge は、トレースコンテキストを渡したPutEventsリクエストからイベントが送信された場合にのみ、イベントのトレースヘッダーを渡すことができます。X-Ray は、サードパーティーパートナーから発生したイベント、スケジュールされたイベント、またはAWS サービスをトレースしないため、これらのイベントソースは X-Ray のサービスマップに表示されません。

X-Ray がトレースヘッダーを検証し、有効でないトレースヘッダーは削除されます。ただし、イベントは引き続き処理されます。

重要

トレースヘッダーは、呼び出しターゲットに配信されるイベントでは使用できません。

• イベントアーカイブがある場合、アーカイブされたイベントでトレースヘッダは使用できません。アーカイブされたイベントを再生する場合、トレースヘッダーは含まれません。

• デッドレターキュー (DLQ） がある場合、トレースヘッダーは、イベントを に送信するSendMessageリクエストに含まれますDLQ。DLQ を使用して からイベント (メッセージ) を取得する場合ReceiveMessage、イベントに関連付けられたトレースヘッダーは Amazon SQS メッセージ属性に含まれますが、イベントメッセージには含まれません。

EventBridge イベントノードがソースサービスとターゲットサービスを接続する方法については、「 AWS X-Ray デベロッパーガイド」の「X-Ray サービスマップでのソースとターゲットの表示」を参照してください。

次のトレースヘッダー情報を 経由で渡すことができます EventBridge。

• デフォルトHTTPヘッダー – X-Ray は、トレースヘッダーをすべての呼び出しターゲットのX-Amzn-Trace-IdHTTPヘッダーとしてSDK自動的に入力します。デフォルトHTTPヘッダーの詳細については、「 AWS X-Ray デベロッパーガイド」の「トレースヘッダー」を参照してください。

• TraceHeader system attribute – は、X-Ray トレースヘッダーをターゲットに渡す EventBridge ために によって予約されたPutEventsRequestEntry 属性TraceHeaderです。も使用している場合PutEventsRequestEntry、 はHTTPトレースヘッダーをPutEventsRequestEntry上書きします。

注記

トレースヘッダーは、PutEventsRequestEntry イベントサイズに含まれません。詳細については、「 PutEvents イベントエントリサイズの計算」を参照してください。

次のビデオでは、X-Ray と を EventBridge 一緒に使用する方法を示します。