跳转到主要内容
本集成接收 Amazon SNS 主题的 HTTPS 订阅推送。CloudWatch 告警的触发和恢复对应同一条 Flashduty 告警;同一主题上的 Cost Anomaly Detection、Amazon Managed Service for Prometheus(AMP)告警管理器和 AWS Budgets 通知也会被识别。

在 Flashduty On-call

您可通过以下两种方式获取集成推送地址,任选其一即可。

使用专属集成

如果您只需将告警发往一个协作空间,选择此方式,配置更简单。
  1. 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增集成
  3. 选择 AWS CLoudWatch 集成,点击 保存,生成卡片。
  4. 打开生成的集成卡片,复制 推送地址

使用共享集成

如果您需要根据告警事件的 Payload 将告警路由到不同协作空间,选择此方式。
  1. 进入 Flashduty 控制台,选择 集成中心 → 告警事件
  2. 选择 AWS CloudWatch 集成:
    • 集成名称:为当前集成定义一个名称。
  3. 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
  4. 点击 保存,复制生成的 推送地址

在 AWS 中配置

1

在 Amazon SNS 中创建主题

操作路径:Amazon SNS › Topics › Create topic点击 Create topic。
2

在 Amazon SNS 中创建指向 Flashduty 的 HTTPS 订阅

操作路径:Amazon SNS › Subscriptions › Create subscription点击 Create subscription。在 SNS 中创建 HTTPS 订阅回到 Subscriptions 页面,订阅状态变为 Confirmed 说明 Flashduty 已完成订阅确认。
订阅可以开启或关闭 Raw message delivery,两种方式都能接收。关闭时 SNS 会附带 Subject,可作为纯文本消息的告警标题,建议保持关闭。
3

在 Amazon CloudWatch 告警中选择该主题

操作路径:Amazon CloudWatch › Alarms › All alarms › Create alarm › Configure actions › Notification(已有告警:选中告警后 Actions › Edit,点击 Next 进入第 2 步 Configure actions,设置完成后点击 Update alarm)在 CloudWatch 告警中为三种状态选择 SNS 主题保存告警。
4

在 AWS 中触发告警状态并确认

操作路径:已配置 AWS CLI 的终端
状态变更只持续到下一次告警评估。几秒后回到 Flashduty,集成显示 最新事件时间,说明配置成功。再把 --state-value 改为 OK 执行一次,可确认告警自动恢复。

其他发布到 SNS 的 AWS 服务

把下列服务的通知发送到同一个 Flashduty 主题即可,无需额外配置。

Cost Anomaly Detection

在 Billing and Cost Management → Cost Anomaly Detection → Alert subscriptions 中创建订阅,Alerting frequency 选择 Individual alerts,Alert recipients 选择 SNS 主题 Flashduty。SNS 主题的访问策略需要允许 costalerts.amazonaws.com 发布消息。 每个异常(anomalyId)对应一条告警,同一异常的后续通知会合并。Cost Anomaly Detection 不发送异常结束通知,告警需要手动关闭。

Amazon Managed Service for Prometheus

在工作区的告警管理器配置中添加 sns_configs 接收器,指向 Flashduty 主题。请使用 AWS 文档 Configure alert manager to send messages to Amazon SNS as JSON 中的 default_template,让消息以 JSON 发送:
  • 每条告警按 fingerprint 生成 Alert Key,firing 触发,resolved 恢复
  • severity 标签为 critical、warning、info 时分别对应 Critical、Warning、Info,其余为 Warning
  • 标签和注解会成为 Flashduty 标签,标题取 summary 注解,没有时取 alertname
未使用该模板时,告警管理器默认发送纯文本,Flashduty 会按下文「其他消息」处理,无法自动恢复。模板不会转义标签值中的双引号,含双引号的消息同样按纯文本处理。

AWS Budgets

在预算的 Alert 设置中选择 Amazon SNS Alerts,填写 Flashduty 主题的 ARN。SNS 主题的访问策略需要允许 budgets.amazonaws.com 发布消息。Budgets 通知是纯文本,按下文「其他消息」处理。

其他消息

无法识别的消息(纯文本或其他 JSON)每条生成一条 Warning 告警:Alert Key 为 SNS MessageId,SNS 重试同一条消息时不会重复建告警;标题取 SNS Subject,没有时取消息第一行。这类告警不会自动恢复。

Alert Key

CloudWatch 告警的 ALARM、INSUFFICIENT_DATA、OK 使用同一个 Alert Key,告警名称、阈值、原因和描述的变化不会拆分告警。缺少 AlarmArn 的 CloudWatch 告警消息会被拒绝。

状态和告警等级

CloudWatch 告警没有等级字段,ALARM 和 INSUFFICIENT_DATA 默认对应 Warning,OK 对应恢复。如需指定等级,在告警的 Alarm description 中写入 flashduty_severity: critical(可选 critical、warning、info,不区分大小写,= 或 : 均可)。例如:

标签

  • 单指标告警:trigger_metric_name、trigger_namespace、trigger_dimensions_<维度名> 等,维度含 InstanceId 时写入 resource
  • 指标数学和异常检测告警:每个查询写入 trigger_expression_<查询 ID>、trigger_metric_<查询 ID>(命名空间/指标名)和 trigger_dimensions_<维度名>;metric 和 check 取返回数据的查询
  • 复合告警:alarm_rule 和 triggering_children(触发的子告警 ARN)
  • 所有告警:alarm_arn、aws_account_id、region、new_state_value、old_state_value

排查问题

  • 订阅停留在 Pending confirmation:确认 Endpoint 是完整推送地址且包含 integration_key,然后在 SNS 控制台对该订阅执行 Request confirmation
  • Flashduty 返回 SubscribeURL 错误:Flashduty 只访问 sns.<region>.amazonaws.com、sns.<region>.amazonaws.com.cn 和 sns.<region>.amazonaws.eu 上的订阅确认地址,请确认订阅请求来自 Amazon SNS
  • 告警没有恢复:确认 CloudWatch 告警的 OK 状态也通知了 Flashduty 主题
  • 需要在 EventBridge 中统一处理:GuardDuty、Security Hub、AWS Health 等事件请使用 AWS EventBridge 集成