Amazon EventBridge 集成 AWS X-Ray

您可以使用 AWS X-Ray 來追蹤通過的事件 EventBridge。 EventBridge 將原始追蹤標頭傳遞至目標，以便目標服務可以追蹤、分析和偵錯。

EventBridge 只有當事件來自傳遞追蹤內容的PutEvents要求時，才能傳遞事件的追蹤標頭。X-Ray 不會追蹤來自第三方合作夥伴、排程事件或AWS 服務的事件，而且這些事件來源不會顯示在 X-Ray 服務地圖上。

X-Ray 會驗證追蹤標頭，而且會捨棄無效的追蹤標頭。但是，仍會處理該事件。

重要

追蹤標頭在傳遞至調用目標的事件上無法使用。

• 如果您有事件封存，則已封存的事件上無法使用追蹤標頭。如果您重新顯示封存的事件，則不會包含追蹤標頭。

• 如果您有無效字母 queue (DLQ)，追蹤標頭會包含在SendMessage將事件傳送至. DLQ 如果您使用從中擷取事件 (訊息)ReceiveMessage，與事件相關聯的追蹤標頭會包含在 Amazon SQS 訊息屬性中，但事件訊息中不會包含該追蹤標頭。DLQ

有關 EventBridge 事件節點如何連接來源和目標服務的詳細資訊，請參閱AWS X-Ray 開發人員指南中的 X-Ray 服務對應中的檢視來源和目標。

您可以透過以下方式傳遞下列追蹤標頭資訊 EventBridge：

• 預設HTTP標頭 — X-Ray SDK 會自動填入追蹤標頭做為所有叫用目標的X-Amzn-Trace-IdHTTP標頭。要了解有關默認HTTP標題的更多信息，請參閱AWS X-Ray 開發人員指南中的跟踪標題。

• TraceHeader系統屬性 — TraceHeader 是保留的PutEventsRequestEntry 屬性，用於 EventBridge 將 X-Ray 追蹤標頭傳送至目標。如果您也使用PutEventsRequestEntry，則PutEventsRequestEntry會覆寫HTTP追蹤標頭。

注意

追蹤標頭不會計入 PutEventsRequestEntry 事件大小。如需詳細資訊，請參閱 計算 PutEvents 事件項目大小。

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