使用死信队列处理中未传送的事件 EventBridge

为避免在事件未能传送到目标后丢失事件，您可以配置死信队列 (DLQ)，并将所有失败事件发送到该队列，以便日后处理。

EventBridge DLQs 是标准的 Amazon SQS 队列， EventBridge 用于存储无法成功传送到目标的事件。创建规则并添加目标时，可以选择是否使用 DLQ。配置 DLQ 时，可以保留任何未成功传送的事件。然后，您可以解决导致事件传送失败的问题，并在之后处理事件。

当您为规则的目标配置 DLQ 时， EventBridge 会将调用失败的事件发送到选定的 Amazon SQS 队列。

事件错误的处理方式不同。有些事件会在不进行任何重试的情况下被丢弃或发送到 DLQ。例如，由于缺少对目标的权限或目标资源已不存在而导致的错误，在采取行动解决潜在问题之前，系统将不会进行任何重试。 EventBridge 将这些事件直接发送到目标 DLQ（如已指定）。

当事件交付失败时，会向 Amazon CloudWatch 指标 EventBridge 发布一个表明目标invocation失败的事件。如果您使用 DLQ，则会将其他指标发送到 CloudWatch包括InvocationsSentToDLQ和。InvocationsFailedToBeSentToDLQ

如果您使用对静态事件 DLQs 进行加密，也可以 Amazon KMS 客户自主管理型密钥 为事件总线指定。有关更多信息，请参阅 使用死信队列捕获中的加密事件错误 EventBridge。

您的 DLQ 中的每条消息都将包含以下自定义属性：

以下视频介绍了设置 DLQs：

使用死信队列的注意事项

为配置 DLQ 时，请考虑以下几点。 EventBridge

为死信队列授予权限

要成功将事件传送到队列， EventBridge 必须具有执行此操作的权限。使用 EventBridge 控制台指定 DLQ 时，权限会自动添加。这包括：

如果您使用 API 指定 DLQ，或者使用其他 Amazon 账户中的队列，则必须手动创建基于资源的策略，然后将其附加到队列，用于授予所需权限。

目标死信队列权限示例

以下基于资源的策略演示了如何授予向 Amazon SQS 队列发送事件消息所需的权限。 EventBridge 策略示例向 EventBridge 服务授予使用该SendMessage操作向名为 “MyEventDLQ” 的队列发送消息的权限。队列必须位于 us-west-2 区域，账户为 123456789012。 Amazon 该Condition声明仅允许来自名为 “MyTestRule” 的规则的请求，该规则是在us-west-2区域创建的，账户为123456789012。 Amazon

{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:us-west-2:123456789012:MyEventDLQ",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:us-west-2:123456789012:rule/MyTestRule"
    }
  }
}

事件总线死信队列权限示例

以下基于资源的策略演示了如何在为事件总线指定 DLQ 时授予所需权限。在本例中，aws:SourceArn 指定用于将事件发送到 DLQ 的事件总线的 ARN。在本示例中，队列必须与事件总线位于同一区域。

{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:region:account-id:queue-name",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:region:account-id:event-bus/event-bus-arn"
    }
  }
}

要将策略附加到队列，请使用 Amazon SQS 控制台，打开队列，然后选择访问策略并编辑该策略。您也可以使用 Amazon CLI。要了解更多信息，请参阅Amazon SQS 权限。

如何从死信队列中重新发送事件

可以通过两种方式将消息移出 DLQ：