View a markdown version of this page

亚马逊 EventBridge 与 AWS X-Ray - 亚马逊 EventBridge

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

亚马逊 EventBridge 与 AWS X-Ray

您可以使用 AWS X-Ray 来跟踪通过亚马逊活动 EventBridge的事件 EventBridge。 EventBridge 将原始跟踪标头传递给目标,以便目标服务可以跟踪、分析和调试。

EventBridge 只有当事件来自通过跟踪上下文的PutEvents请求时,才能传递事件的跟踪标头。 X-Ray 不会追踪源自第三方合作伙伴、预定活动或AWS 服务的事件,并且这些事件源不会出现在您的 X-Ray 服务地图上。

X-Ray 验证跟踪标头,无效的跟踪标头将被删除。但仍会处理该事件。

重要

对于传送到调用目标的事件,跟踪标头可用。

  • 如果您有事件存档,则跟踪标头对于存档事件不可用。如果您重放存档事件,其中不包括跟踪标头。

  • 如果您有死信队列 (DLQ),跟踪标头包含在将事件发送到 DLQ 的 SendMessage 请求中。如果您使用 ReceiveMessage 从 DLQ 中检索事件(消息),则与该事件关联的跟踪标头将包含在 Amazon SQS 消息属性中,但不包含在事件消息中。

有关 EventBridge 事件节点如何连接源和目标服务的信息,请参阅AWS X-Ray 开发者指南中的在 X-Ray 服务映射查看源和目标

您可以通过以下跟踪标头信息传递 EventBridge:

  • 默认 HTTP 标头 — X-Ray SDK 自动将跟踪标头填充为所有调用目标的 X-Amzn-Trace-Id HTTP 标头。要了解有关默认 HTTP 标头的更多信息,请参阅《AWS X-Ray 开发人员指南》中的跟踪标头

  • TraceHeader系统属性 TraceHeader 是为将 X-Ray跟踪标头 EventBridge 传送到目标而保留的PutEventsRequestEntry 属性。如果您还使用 PutEventsRequestEntryPutEventsRequestEntry 会覆盖 HTTP 跟踪标头。

注意

跟踪标头不会计入 PutEventsRequestEntry 事件大小。有关更多信息,请参阅 计算 PutEvents 活动参赛规模

以下视频演示了 X-Ray 和的 EventBridge 组合使用: