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

# Amazon EventBridge と の統合 AWS X-Ray
<a name="eb-related-service-xray"></a>

を使用して AWS X-Ray 、EventBridge を通過する[イベント](eb-events.md)をトレースできます。EventBridge は元のトレースヘッダーを[ターゲット](eb-targets.md)に渡し、ターゲットサービスが追跡、分析、およびデバッグできるようにします。

EventBridgeがイベントのトレースヘッダーを渡すことができるのは、そのイベントが、トレースコンテキストを渡した `PutEvents` リクエストから来ている場合のみです。X-Ray は、サードパーティーパートナーから発生したイベント、スケジュールされたイベント、または[AWS サービス](eb-events.md#eb-service-event)をトレースしないため、これらのイベントソースは X-Ray のサービスマップに表示されません。

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

**重要**  
トレースヘッダーは、呼び出しターゲットに配信されるイベントでは使用**できません**。  
[イベントアーカイブ](eb-archive-event.md)がある場合、アーカイブされたイベントでトレースヘッダは使用できません。アーカイブされたイベントを再生する場合、トレースヘッダーは含まれません。
[デッドレターキュー (DLQ)](eb-rule-dlq.md) がある場合、トレースヘッダは DLQ にイベントを送信する `SendMessage` リクエストに含まれます。`ReceiveMessage` を使用して DLQ からイベント (メッセージ) を取得する場合、そのイベントに対応するトレースヘッダーは Amazon SQS のメッセージ属性に含まれ、イベントメッセージには含まれません。

EventBridge イベントノードがソースおよびターゲットサービスを接続する方法については、『*AWS X-Ray 開発者ガイド*』の「[X-Ray サービスマップでのソースおよびターゲットの表示](https://docs.aws.amazon.com//xray/latest/devguide/xray-services-eventbridge.html#xray-services-eventbridge-service-map)」を参照してください。

EventBridge を通じて、次のトレースヘッダー情報を渡すことができます。
+ **デフォルトの HTTP ヘッダー** - X-Ray SDK は、すべての呼び出しターゲットの `X-Amzn-Trace-Id` HTTP ヘッダーとして自動的にトレースヘッダーを入力します。デフォルトの HTTP ヘッダーの詳細については、『*AWS X-Ray 開発者ガイド*』の「[トレースヘッダー](https://docs.aws.amazon.com//xray/latest/devguide/xray-concepts.html#xray-concepts-tracingheader)」を参照してください。
+ **`TraceHeader` システム属性** - `TraceHeader` は、X-Ray トレースヘッダをターゲットに渡すために EventBridge で予約されている [PutEventsRequestEntry 属性](https://docs.aws.amazon.com//eventbridge/latest/APIReference/API_PutEventsRequestEntry.html)です。`PutEventsRequestEntry` も使用している場合、`PutEventsRequestEntry` は HTTP トレースヘッダを上書きします。

**注記**  
トレースヘッダーは、`PutEventsRequestEntry` イベントサイズに含まれません。詳細については、「[PutEvents イベントエントリのサイズの計算](eb-putevents.md#eb-putevent-size)」を参照してください。

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