本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon EventBridge 與 整合 AWS X-Ray
<a name="eb-related-service-xray"></a>

您可以使用 AWS X-Ray 來追蹤通過 EventBridge [的事件](eb-events.md)。EventBridge 會將原始追蹤標頭傳遞至[目標](eb-targets.md)，以便目標服務可以追蹤、分析和偵錯。

只有當事件來自傳遞追蹤內容的 `PutEvents` 要求時，EventBridge 才能傳遞事件的追蹤標頭。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` 是由 EventBridge 保留的 [PutEventsRequestEntry 屬性](https://docs.aws.amazon.com//eventbridge/latest/APIReference/API_PutEventsRequestEntry.html)，可將 X-Ray 追蹤標頭傳送至目標。如果您也使用 `PutEventsRequestEntry`，則 `PutEventsRequestEntry` 會覆寫 HTTP 追蹤標頭。

**注意**  
追蹤標頭不會計入 `PutEventsRequestEntry` 事件大小。如需詳細資訊，請參閱[計算 PutEvents 事件項目大小](eb-putevents.md#eb-putevent-size)。

 下面為演示 X-Ray 和 EventBridge 一起使用的視頻：