在 Amazon 上使用区域自动换档 EventBridge - Amazon Route 53 应用程序恢复控制器

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

在 Amazon 上使用区域自动换档 EventBridge

使用 Amazon EventBridge,您可以设置事件驱动的规则,以监控您的区域自动转移资源并启动使用其他服务的目标操作。 AWS 例如,您可以设置发送电子邮件通知的规则,方法是在区域自动移位练习开始时向 Amazon SNS 主题发送信号。

您可以在 Amazon 中创建规则 EventBridge 来处理区域自动移动。区域自动移位事件的事件指定了练习跑自动换档的状态信息,例如,练习跑正在进行时。

要捕获您感兴趣的特定区域自动移位事件,请定义 EventBridge 可用于检测事件的特定事件模式。事件模式与它们匹配的事件具有相同的结构。模式引用了您要匹配的字段,并提供您所查找的值。

尽最大努力发出事件。 EventBridge 在正常运营情况下,它们几乎实时地从 Route 53 ARC 运送到。但是,可能会出现延迟或阻止事件交付的情况。

有关 EventBridge 规则如何处理事件模式的信息,请参阅中的事件和事件模式 EventBridge

使用以下命令监控区域自动移位资源 EventBridge

使用 EventBridge,您可以创建规则,定义在 Route 53 ARC 为其资源发出事件时要采取的操作。例如,您可以创建一条规则,在区域自动移位练习开始时发送电子邮件。

要在控制台中键入或复制并粘贴事件模式,请选择该选项以在 EventBridge 控制台中使用 Enter my ow n 选项。为了帮助您确定可能对您有用的事件模式,本主题包括区域自动移位事件匹配模式和区域自动移位事件的示例,供您使用。

要为资源事件创建规则
  1. 打开亚马逊 EventBridge 控制台,网址为 https://console.aws.amazon.com/events/

  2. 选择您 AWS 区域 要在其中创建规则的区域,即您有兴趣观看其赛事的区域。

  3. 选择 Create rule (创建规则)

  4. 输入规则的 Name (名称) 和“Description (描述)”(可选)。

  5. 对于事件总线,保留默认值,即默认

  6. 选择下一步

  7. 对于构建事件模式步骤,对于事件源,保留默认值,即 AWS 事件

  8. 示例事件下,选择输入我自己的

  9. 对于示例事件,键入或复制并粘贴事件模式。

区域自动移位事件模式示例

事件模式与它们匹配的事件具有相同的结构。模式引用了您要匹配的字段,并提供您所查找的值。

您可以将此部分中的事件模式复制并粘贴 EventBridge 到中,以创建可用于监控区域自动移位操作和资源的规则。

在为可用区自动转移事件创建事件模式时,可以为 detail-type 指定以下任一选项:

  • Autoshift In Progress

  • Autoshift Completed

  • Practice Run Started

  • Practice Run Succeeded

  • Practice Run Interrupted

  • Practice Run Failed

当练习运行中断时,可参阅 additionalFailureInfo 字段,以详细了解导致中断的原因。

  • 从已开始练习跑的区域自动切换中选择所有赛事。

    { "source": [ "aws.arc-zonal-shift" ], "detail-type": [ "Practice Run Started" ] }
  • 从区域自动移位中选择练习跑失败的所有赛事。

    { "source": [ "aws.arc-zonal-shift" ], "detail-type": [ "Practice Run Failed" ] }

区域自动移位事件示例

以下是区域自动移位操作的示例事件:

{ "version": "0", "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4", "detail-type": "Practice Run Interrupted", "source": "aws.arc-zonal-shift", "account": "111122223333", "time": "2023-11-16T23:38:14Z", "region": "us-east-1", "resources": [ "TEST-EXAMPLE-2023-11-16-23-28-11-5" ], "detail": { "version": "0.0.1", "data": { "additionalFailureInfo": "Practice run interrupted. The blocking alarm entered ALARM state." }, "metadata": { "awayFrom": "use1-az2" } } }

指定要用作目标的 CloudWatch 日志组

创建 EventBridge 规则时,必须指定将与规则匹配的事件发送到的目标。有关可用目标的列表 EventBridge,请参阅 EventBridge 控制台中的可用目标。您可以添加到 EventBridge 规则的目标之一是 Amazon CloudWatch 日志组。本节介绍将 CloudWatch 日志组添加为目标的要求,并提供了在创建规则时添加日志组的过程。

要将 CloudWatch 日志组添加为目标,可以执行以下操作之一:

  • 创建新的日志组

  • 选择现有的日志组

如果您在创建规则时使用控制台指定了新的日志组,则 EventBridge 会自动为您创建该日志组。确保用作 EventBridge 规则目标的日志组以开头/aws/events。如果要选择现有的日志组,请注意,只有以开头的日志组才/aws/events会作为选项出现在下拉菜单中。有关更多信息,请参阅 Amazon CloudWatch 用户指南中的创建新日志组

如果您使用控制台之外的 CloudWatch 操作创建或使用 CloudWatch 日志组作为目标,请确保正确设置权限。如果您使用控制台向 EventBridge 规则添加日志组,则该日志组的基于资源的策略会自动更新。但是,如果您使用 AWS Command Line Interface 或 S AWS DK 来指定日志组,则必须更新该日志组的基于资源的策略。以下示例策略说明了您必须在基于资源的策略中为日志组定义的权限:

{ "Statement": [ { "Action": [ "logs:CreateLogStream", "logs:PutLogEvents" ], "Effect": "Allow", "Principal": { "Service": [ "events.amazonaws.com", "delivery.logs.amazonaws.com" ] }, "Resource": "arn:aws:logs:region:account:log-group:/aws/events/*:*", "Sid": "TrustEventsToStoreLogEvent" } ], "Version": "2012-10-17" }

您无法使用控制台为日志组配置基于资源的策略。要向基于资源的策略添加所需的权限,请使用 CloudWatch PutResourcePolicyAPI 操作。然后,您可以使用 describe-resource-policiesCLI 命令检查您的策略是否正确应用。

为资源事件创建规则并指定 CloudWatch 日志组目标
  1. 打开亚马逊 EventBridge 控制台,网址为 https://console.aws.amazon.com/events/

  2. 选择 AWS 区域 要在其中创建规则的。

  3. 选择 “创建规则”,然后输入有关该规则的任何信息,例如事件模式或计划详细信息。

    有关为 Route 53 ARC 创建 EventBridge 规则的更多信息,请参阅本主题前面的部分。

  4. “选择目标” 页面上,选择CloudWatch作为您的目标。

  5. 从下拉菜单中选择一个 CloudWatch 日志组。