华为云 AOM 告警集成

华为云应用运维管理（Application Operations Management，AOM）可以通过 SMN 消息通知或 Webhook 数据订阅，将告警与恢复事件发送到 Flashduty On-call。两种方式使用同一个 AOM 集成推送地址。

推荐使用 SMN 消息通知，该方式适用于常规账号。AOM Webhook 数据订阅目前受限开放，仅在您的账号已开通该能力时使用。

接入前准备

已在 Flashduty 创建 华为云 AOM 集成并取得 HTTPS 推送地址。
已在华为云创建或准备好 AOM 告警规则。
使用 SMN 时，当前账号需要具备创建主题、订阅主题以及查看主题的权限。
告警规则需要同时发送 告警触发 和 告警恢复 通知。

方式一：通过 SMN 接入

创建 SMN 主题与订阅

创建 SMN 主题

登录华为云控制台，进入 消息通知服务 SMN。
选择 主题管理 > 主题，单击 创建主题。
将主题名称设置为 Flashduty，然后保存。

添加 HTTPS 订阅

在 Flashduty 主题中单击 添加订阅。
协议选择 HTTPS。
在订阅终端中填写 Flashduty AOM 集成的 推送地址，然后保存。
Flashduty 会验证 SMN 的订阅确认请求并自动访问华为云确认地址。订阅状态变为 已确认 后，SMN 才会发送告警。

配置 AOM 消息模板

在 AOM 2.0 控制台进入 告警中心 > 告警通知 > 消息模板。部分控制台版本中的入口名称为 告警 > 告警行动规则 > 消息模板。创建消息模板时，通知方式选择 HTTP/HTTPS。Flashduty 支持以下两种正文格式：

HTML
JSON

HTML 模板支持中文和英文。建议在正文第一行增加上报类型，Flashduty 将优先使用该字段识别告警与恢复。中文模板

上报类型：${clear_type};
通知类型：${event_type};
事件级别：${event_severity};
事件名称：${event_name_alias};
发生时间：${starts_at};
事件源：$event.metadata.resource_provider;
资源类型：$event.metadata.resource_type;
资源标识：${resources_new};
可能原因：${alarm_probableCause_zh};
附加信息：${message};
修复建议：${alarm_fix_suggestion_zh};

英文模板

Clear Type:${clear_type};
Alarm Name:${event_name_alias};
Alarm ID:${id};
Notification Rule:${action_rule};
Occurred:${starts_at};
Event Severity:${event_severity};
Alarm Info:${alarm_info};
Resource Identifier:${resources_new};
Suggestion:${alarm_fix_suggestion_zh};

每个字段单独占一行并保留结尾分号。资源标识可以跨多行，Flashduty 会解析其中的键值对并生成标签。

数据类型选择 JSON 后，保留 AOM 自动生成的默认 JSON 正文。Flashduty 会从 SMN 外层报文的 message 字段中解析该 JSON。AOM 默认 JSON 包含以下核心字段。请保留标记为必填的字段；可选字段有值时，Flashduty 会将其用于标签或恢复判断。

字段	是否必填	用途
`id`	否	AOM 事件 ID；有值时保存为 `event_id` 标签
`starts_at`	是	告警发生时间，Unix 毫秒时间戳
`ends_at`	否	大于 0 时表示恢复；缺失、空值或 0 时继续参考 SMN 主题
`metadata.event_name`	是	告警名称
`metadata.event_severity`	是	告警等级
`metadata.event_type`	是	事件类型，通常为 `alarm`
`metadata.resource_provider`	是	事件源，例如 `AOM` 或 `CCE`
`metadata.resource_type`	是	资源类型
`metadata.resource_id`	是	资源标识

不要把 SMN 外层的 signature、subject、topic_urn 等字段手动写入 AOM JSON 模板。SMN 会自动生成外层通知报文和签名。

创建告警通知规则

关联 SMN 主题与消息模板

在 AOM 2.0 控制台进入 告警中心 > 告警通知。
在 通知规则管理 中创建告警通知规则。
选择前面创建的 Flashduty SMN 主题和 AOM 消息模板。

发送触发与恢复通知

在 AOM 告警规则中启用通知，并确保通知场景同时包含 告警触发 和 告警恢复。

验证接入

触发一条测试告警，然后恢复该告警。回到 Flashduty 集成页面，确认最新事件时间已更新，并在告警详情中检查等级、资源和恢复状态。

方式二：通过 AOM Webhook 数据订阅

AOM Webhook 数据订阅目前受限开放。如果控制台没有 Webhook 告警订阅选项，请提交华为云工单申请开通，或使用上面的 SMN 方式。

账号已开通该能力时，可在 AOM 2.0 控制台进入 设置 > 全局设置 > 数据订阅，创建 Webhook 告警订阅规则，并将目标地址设置为同一个 Flashduty AOM 集成推送地址。 Webhook 请求需要使用 AOM 官方的结构化事件格式：

{
  "events": [
    {
      "id": "4346299651651991683",
      "starts_at": 1664001830491,
      "ends_at": 0,
      "timeout": 300000,
      "resource_group_id": "project-id",
      "metadata": {
        "event_name": "Pod memory OOM",
        "event_severity": "Major",
        "event_type": "alarm",
        "resource_provider": "CCE",
        "resource_type": "service",
        "resource_id": "clusterName=production;kind=Pod;namespace=default;name=example;uid=example-uid"
      },
      "annotations": {
        "alarm_probableCause_zh_cn": "Pod 内存不足",
        "message": "pod was OOM killed",
        "alarm_fix_suggestion_zh_cn": "提高容器内存限制"
      }
    }
  ],
  "project_id": "project-id"
}

单次请求最多包含 100 个事件。结构化数据中的 id、starts_at 以及六个核心 metadata 字段必须有有效值。

告警与恢复关联

Flashduty 按以下优先级识别恢复：

接入格式	恢复判断
SMN HTML	优先读取 `上报类型` 或 `Clear Type`；无法识别时再读取 SMN `subject`
SMN JSON	`ends_at > 0` 表示恢复；缺失、空值或 0 时再读取 SMN `subject`
Webhook 数据订阅	`ends_at > 0` 表示恢复

华为云中文模板的 clear_type 枚举值为 触发 和 恢复；英文模板的枚举值为 generated 和 cleared。Flashduty 优先使用这些值判断告警与恢复。

SMN HTML 没有可用的上报类型时，主题中包含“恢复”、_resolved、_recovered 或 _clear 也会被识别为恢复。

告警与恢复必须保持以下字段一致：

metadata.event_type
metadata.event_name
metadata.resource_provider
metadata.resource_type
metadata.resource_id

Flashduty 使用这些字段生成告警指纹。id 会保存为标签，但不参与告警与恢复关联，因此告警通知和恢复通知的 ID 可以不同。如果两个独立告警的上述五个字段完全相同，Flashduty 会将其视为同一告警。请确保 metadata.event_name 或 metadata.resource_id 能区分需要独立处理的告警。

字段与等级映射

常用 AOM 字段会转换为 Flashduty 标签：

AOM 字段	Flashduty 标签
`id`	`event_id`
`metadata.event_name`	`event_name`、`check`
`metadata.event_severity`	`event_severity`
`metadata.resource_provider`	`resource_provider`
`metadata.resource_type`	`resource_type`
`metadata.resource_id`	`resource_id`，并拆分其中的资源键值对
`policy.alarm_rule_name`	`alarm_rule_name`
`annotations.tms_tags`	`tms_tags`
`annotations.generator_url`	`generator_url`
英文 HTML 的 `Notification Rule`	`notification_rule`

告警等级映射如下：

AOM 等级	Flashduty 等级	状态
Critical、Major、紧急、重要	Critical	严重
Minor、Warning、次要、警告	Warning	警告
Info、提示	Info	提醒

常见问题

SMN 订阅为什么一直没有确认？

确认订阅终端使用完整的 HTTPS 集成推送地址，并且地址中的 integration_key 未被修改。Flashduty 仅会自动访问合法的华为云 HTTPS 确认地址。

为什么手动重放 SMN 请求会提示签名无效？

SMN 的 signature 与消息正文、消息 ID、subject、主题、时间和消息类型绑定。修改任一字段后，原签名都会失效。请通过 AOM 和 SMN 发送真实测试通知，不要复制并修改历史请求。

告警为什么没有被恢复？

确认告警规则发送了恢复通知。HTML 模板建议加入 ${clear_type}；SMN JSON 优先读取大于 0 的 ends_at，缺失、空值或 0 时需要确保 subject 能表明恢复；Webhook 数据订阅必须提供大于 0 的 ends_at。同时检查告警和恢复的五个关联字段是否一致。

SMN JSON 和 Webhook 数据订阅有什么区别？

SMN JSON 是 SMN 通知报文中的 message 字段，外层仍包含签名和主题。Webhook 数据订阅直接发送 {“events”:[…]} 结构，不包含 SMN 外层字段。不要把两种外层结构混合在同一个请求中。

快速开始

协作空间

故障管理

故障复盘

状态页

分析看板

集成配置

配置中心

高级功能

集成中心

最佳实践

华为云 AOM 告警集成

在 Flashduty On-call 创建集成

使用专属集成

使用共享集成

接入前准备

方式一：通过 SMN 接入

创建 SMN 主题与订阅

配置 AOM 消息模板

创建告警通知规则

方式二：通过 AOM Webhook 数据订阅

告警与恢复关联

字段与等级映射

常见问题

华为云相关文档

​在 Flashduty On-call 创建集成

​使用专属集成

​使用共享集成

​接入前准备

​方式一：通过 SMN 接入

​创建 SMN 主题与订阅

​配置 AOM 消息模板

​创建告警通知规则

​方式二：通过 AOM Webhook 数据订阅

​告警与恢复关联

​字段与等级映射

​常见问题

​华为云相关文档

在 Flashduty On-call 创建集成

使用专属集成

使用共享集成

接入前准备

方式一：通过 SMN 接入

创建 SMN 主题与订阅

配置 AOM 消息模板

创建告警通知规则

方式二：通过 AOM Webhook 数据订阅

告警与恢复关联

字段与等级映射

常见问题

华为云相关文档