# 通过HTTP(S)接收告警通知 在企业运维环境中，告警通知需要对接多种第三方系统，如工单平台、自建监控中心等。传统的邮件、短信渠道灵活性有限，仅能实现人工消息告知，存在无法结构化解析、自动化流转和自定义处理等局限性。通过HTTP/HTTPS渠道接收告警通知，在告警触发时接收JSON格式的告警通知，可按需解析并执行后续逻辑，实现告警与支持HTTP协议的系统的无缝集成，有效提升运维自动化水平与响应效率。 当您在配置告警联系人时，通知渠道选择"HTTP"和"HTTPS"，并填写HTTP(S)的公网地址后，如果资源的监控指标达到告警条件，即可将告警通知发送到您配置的公网地址上。 #### 操作流程 通过HTTP或HTTPS接收告警通知的流程及说明，请参考[表1]。 表1HTTP或HTTPS接收告警通知流程 | 序号 | 步骤 | 说明 | |:---|:---|:---| | 1 | [在联系人中添加HTTP(S)公网地址] | 配置接收告警通知的公网地址，将在告警触发时向该地址发送HTTP(S)请求，推送结构化的告警数据。 | | 2 | [创建告警联系组并添加告警联系人] | 定义告警接收人集合，将HTTP(S)联系人归入联系组，便于在告警规则中统一引用。 | | 3 | [创建通知内容模板] | 自定义创建通知内容模板，确保接收方能够按需解析关键字段，满足对告警消息的结构化处理需求。 | | 4 | [创建告警规则] | 设定触发告警的监控指标、告警策略，将告警规则与联系组、通知模板绑定。 | | 5 | [查看告警通知] | 验证告警是否按预期正确发送和接收。 | #### 在联系人中添加HTTP(S)公网地址 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 在页面左侧导航栏选择"告警 \> 告警通知"，进入告警通知页面。 3. 单击"联系人"页签。 4. 单击"创建联系人"按钮，进入"创建联系人"页面。 图1创建联系人 ![](https://support.huaweicloud.com/bestpractice-ces/zh-cn_image_0000002645439334.png "点击放大") 5. 根据界面提示，配置联系人信息，如[表2]所示。 表2创建联系人参数说明 | 参数名称 | 取值样例 | 参数说明 | |:---|:---|:---| | 联系人名称 | **notification-http** | 联系人名称，输入长度范围为1到42个字符。 | | 选择渠道 | - 选择"**HTTP** "，并在对应渠道输入框中输入公网网址。 例如：http://example.com/notification/action - 选择"**HTTPS** "，并在对应渠道输入框中输入公网网址。 例如：https://example.com/notification/action 说明： 请确保您提供的HTTP(S)地址为公网地址，并保证该地址的网络连通性。 | 联系人的渠道，每种渠道只能设置一个对象。 | 6. 单击"立即创建"，完成创建联系人。 #### 创建告警联系组并添加告警联系人 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 在页面左侧导航栏选择"告警 \> 告警通知"，进入告警通知界面。 3. 单击"联系组"页签。 4. 单击"创建联系组"，进入"创建联系组"页面。 图2创建联系组 ![](https://support.huaweicloud.com/bestpractice-ces/zh-cn_image_0000002687122995.png "点击放大") 5. 根据界面提示，配置联系组信息，如[表3]所示。 表3创建联系组参数说明 | 参数名称 | 取值样例 | 参数说明 | |:---|:---|:---| | 组名称 | **Contact_Group-http** | 联系组名称。只能由中文、英文字母、数字、下划线、 中划线组成，输入长度范围为1到64个字符。 | | 归属企业项目 | **default** | 联系组所属的企业项目。只有拥有该企业项目权限的用户才可以查看和管理该告警联系组。 | | 联系人 | **notification-http** | 单击名称输入框，在下拉列表中选择[在联系人中添加HTTP(S)公网地址]中已创建的联系人，选择渠道会自动填充联系人中配置的通知渠道。 说明： 部分区域目前仅支持单击"选择联系人"按钮选择已创建的联系人，具体请以控制台页面显示为准。 | 6. 在"创建联系组"页面，单击"立即创建"，完成联系组创建。 加入联系组后，对应的订阅终端会收到订阅通知。通过对应程序访问该链接进行确认或将链接复制到Web浏览器，进行订阅确认，确认订阅后，才能正常接收告警信息。 #### 创建通知内容模板 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 在页面左侧导航栏选择"告警 \> 告警通知"，进入告警通知界面。 3. 单击"通知内容模板"页签。 4. 单击"创建通知内容模板"，进入"创建通知内容模板"页面。 5. 根据界面提示，配置通知内容模板信息，如[表4]所示。 表4创建通知模板参数说明 | 参数名称 | 取值样例 | 参数说明 | |:---|:---|:---| | 模板名称 | **noticeTemplate-http(s)** | 通知内容模板的模板名称。系统会随机产生一个通知模板名称，用户也可以进行修改，输入长度范围为1到200个字符。 | | 描述 | **-** | 告警通知模板描述（此参数非必填项）。 | | 渠道类型 | **HTTP/HTTPS** | 在下拉框中选择告警通知的通知方式。 | | 通知类型 | **指标通知或事件通知** | 通知内容模板的通知类型。 在配置告警规则时，可选的通知内容模板取决于告警规则的**告警类型** 。例如：告警类型为指标，则只能选择指标类型的通知内容模板。关于告警类型的更多介绍请参阅[告警规则简介](https://support.huaweicloud.com/usermanual-ces/zh-cn_topic_0015479880.html)。 | | 数据格式 | **JSON** | 告警通知内容的数据格式。 | 6. 单击"立即创建"。在"通知内容模板"页面中可以查看新增的通知内容模板，"模板类型"为"自定义模板"。 #### 创建告警规则 为目标资源设定触发告警的监控指标、告警策略，将告警规则与联系组、通知模板绑定。 请参阅[创建告警规则和通知](https://support.huaweicloud.com/usermanual-ces/zh-cn_topic_0084572213.html)配置告警规则参数，其中，告警通知参数配置如下： 表5告警通知参数 | 参数 | 取值样例 | 参数说明 | |:---|:---|:---| | 发送通知 | **开启** | 通过开关按钮配置是否发告警通知。 | | 通知方式 | **联系组 / Notification_Group-http** | 发送告警通知的通知方式，根据需要选择其中一种通知方式。支持选择通知策略、联系组或主题订阅的方式。 | | 生效时间 | **每日00:00-23:59** | 告警仅在生效时间段发送通知消息。 | | 时区 | **(GMT+08:00) 北京，重庆，香港特别行政区，乌鲁木齐，吉隆坡，新加坡，珀斯，台北，伊尔库茨克，乌兰巴托** | 告警生效时间的时区，默认为客户端浏览器所在时区，支持配置。 | | 触发条件 | **依次勾选"出现告警"、"恢复正常"。** | 当通知方式选择联系组或主题订阅时，需要选择触发告警通知的条件。 - 当告警类型为"指标"时，支持选择"出现告警"、"恢复正常"作为触发条件。 - 当告警类型为"事件"时，只支持选择"出现告警"作为触发条件。 | | 通知内容模板 | **noticeTemplate-http(s)** | 通知内容格式，告警通知通过目标格式发送给告警联系人。 | #### 查看告警通知 当监控指标、事件触发告警规则时，HTTP(S)公网地址将会收到SMN封装的告警通知信息。 具体指标、事件告警通知字段说明如下。 #### 指标类型告警通知字段说明 按照自定义指标通知模板发送告警通知的示例如下： ``` { "version": "v1", "data": { "Namespace": "弹性云服务器", "DimensionName": "云服务器", "MetricName": "CPU使用率", "IsAlarm": true, "AlarmLevel": "重要", "Region": "华北-北京四", "RegionId": "cn-north-4", "AlarmRuleName": "test-zcy", "AccountName": "RDS_test", "LastAlarmLevel": "提示", "ResourceID": "853f8ead-428e-4c54-babc-f1bdae6d34a0", "PrivateIP": "10.0.0.39", "EPName": "default", "ResourceName": "ecs-hce330-test", "PrivateIPV6": "2407:c080:11f0:1115:490e:36fe:ba94:a410", "PublicIP": "100.85.113.106", "CurrentData": "100.00 %", "Count": 1, "IsOriginalValue": true, "Filter": "原始值", "ComparisonOperator": ">=", "Value": "0%", "AlarmTime": "2025/11/17 16:39:42 GMT+08:00", "AlarmDesc": "test", "AlarmRecordID": "ah17223968140068KqpEA3NP", "ResourceDimensionInfos": [ { "MetricName": "CPU使用率", "DimensionInfos": [ { "Name": "云服务器", "Value": "853f8ead-428e-4c54-babc-f1bdae6d34a0" } ] } ], "AlarmNotificationType": "指标", "Unit": "%", "ResourceTags": "_sys_type_hcss_x,test=test", "AlarmDurationTime": "0" } } ``` 表6指标类型告警通知字段 | 字段 | 类型 | 字段说明 | |:---|:---|:---| | Namespace | String | 云服务名称。 | | DimensionName | String | 维度名称。 | | MetricName | String | 指标名称。 | | IsAlarm | Boolean | 告警触发条件，是否为出现告警。 - true：表示出现告警。 - false：表示恢复正常。 | | AlarmLevel | String | 告警级别。取值范围为：紧急、重要、次要、提示。 | | Region | String | 区域名称，例如：华北-北京四。 | | RegionId | String | 区域ID，例如：cn-north-4。 | | AlarmRuleName | String | 告警规则名称。 | | AccountName | String | 主账号用户名。 | | LastAlarmLevel | String | 上次告警级别，取值范围为：紧急、重要、次要、提示。 当同一个指标中配置了多个阈值，且指标数据触发了多个阈值，导致告警级别发生变化时，接收到的告警通知内容中将包含该字段。 | | ResourceID | String | 资源ID，即维度值，当维度为多层级维度时，会展示多个维度的维度名称和维度值。 | | PrivateIP | String | 私网IP。 | | EPName | String | 资源所属的企业项目名称。 | | ResourceName | String | 资源名称。 | | PrivateIPV6 | String | 私网IPV6，当前仅ECS资源支持该字段。 | | PublicIP | String | 公网IP。 | | CurrentData | String | 当前触发告警的指标值。 | | Count | Integer | 告警连续触发次数。 | | IsOriginalValue | Boolean | 告警策略中配置的指标是否采用原始值。 - true：指标数据为原始值。 - false：指标数据为聚合值。 | | Filter | String | 指标值类型，取值范围为：平均值、方差值、最小值、最大值、求和值、原始值。 | | ComparisonOperator | String | 比较检测指标值和阈值的关系，比较关系分为\>、\>=、\<、\<=、=、!=、cycle_increase（环比上升）、cycle_decrease（环比下降）和cycle_wave（环比波动）。 | | Value | String | 告警规则中定义的值。 | | AlarmTime | String | 告警产生的时间。 | | AlarmDesc | String | 告警规则描述。 | | AlarmRecordID | String | 告警流水号。 | | ResourceDimensionInfos | Array of objects | 资源维度信息。请参考[表7]。 | | AlarmNotificationType | String | 告警通知类型，取值范围为：指标、事件。 | | Unit | String | 指标的原始单位。 | | ResourceTags | String | 资源标签。 | | AlarmDurationTime | String | 告警持续时长。 | 表7资源维度信息 | 字段 | 类型 | 字段说明 | |:---|:---|:---| | MetricName | String | 指标名称。 | | DimensionInfos | Array of objects | 维度信息。请参考[表8]。 | 表8维度信息 | 字段 | 类型 | 字段说明 | |:---|:---|:---| | Name | String | 维度名称。 | | Value | String | 维度值。 | #### 事件类型告警通知字段说明 按照自定义事件通知模板发送告警通知的示例如下： ``` { "version": "v1", "data": { "PrivateIPV6": "2407:c080:11f0:1115:490e:36fe:ba94:a410", "AlarmNotificationType": "事件", "AccountName": "RDS_test", "Namespace": "弹性云服务器", "ResourceName": "ecs-abc-test", "ResourceTags": "_sys_type_hcss_x,test=test", "MetricName": "重启虚拟机", "IsAlarm": true, "IsCycleTrigger": false, "AlarmLevel": "重要", "Region": "华北-北京四", "RegionId": "cn-north-4", "ResourceID": "7eb14e5d-8a79-4c94-8f8e-8f5467142490", "PrivateIP": "172.20.1.188", "PublicIP": "100.85.113.106", "EPName": "default", "AlarmRecordID": "ah260110T172316SmCFRcx7X", "AlarmRuleName": "alarm-虚拟机重启-abc-adafhads", "Filter": "平均值", "ComparisonOperator": ">=", "AlarmDesc": "desc-test", "IsOriginalValue": false, "Count": 1, "AlarmTime": "2025/11/17 17:28:37 GMT+08:00", "ShowImpactAndSolution": true, "ImpactScope": "虚拟机重启", "RecommendedSolution": "确认业务是否恢复", "DataPointTime": [ "2025/11/17 17:28:35 GMT+08:00" ], "MonitoringRange": "指定资源" } } ``` 表9事件类型告警通知字段 | 字段 | 类型 | 字段说明 | |:---|:---|:---| | PrivateIPV6 | String | 私网IPV6，当前仅ECS资源支持该字段。 | | AlarmNotificationType | String | 告警通知类型，取值范围为：指标、事件。 | | AccountName | String | 主账号用户名。 | | Namespace | String | 云服务名称。 | | ResourceName | String | 资源名称。 | | ResourceTags | String | 资源标签 | | MetricName | String | 事件名称。 | | IsAlarm | Boolean | 告警触发条件，是否为出现告警。 - true：表示出现告警。 - false：表示恢复正常。 | | IsCycleTrigger | Boolean | 是否持续触发告警。 | | AlarmLevel | String | 告警级别，取值为：紧急、重要、次要、提示。 | | Region | String | 区域名称，例如：华北-北京四。 | | RegionId | String | 区域ID，例如: cn-north-4。 | | ResourceID | String | 资源ID，即维度值，当维度为多层级维度时，会展示多个维度的维度名称和维度值。 | | PrivateIP | String | 私网IP。 | | PublicIP | String | 公网IP。 | | EPName | String | 资源所属的企业项目名称。 | | AlarmRecordID | String | 告警流水号。 | | AlarmRuleName | String | 告警规则名称。 | | Filter | String | 事件场景下无实际含义。 | | ComparisonOperator | String | 事件场景下无实际含义，默认值取值为： \>=。 | | AlarmDesc | String | 告警规则描述。 | | IsOriginalValue | Boolean | 告警策略中配置的指标是否采用原始值。 - true：指标数据为原始值。 - false：指标数据为聚合值。 | | Count | Integer | 告警连续触发次数。 | | AlarmTime | String | 告警产生的时间。 | | ShowImpactAndSolution | Boolean | 事件影响范围和建议处理措施是否有值。 - true：事件影响范围和建议处理措施字段有值。 - false：事件影响范围和建议处理措施字段值为空。 | | ImpactScope | String | 事件影响范围，当前仅部分对接的云服务支持。 | | RecommendedSolution | String | 建议处理措施，当前仅部分对接的云服务支持。 | | DataPointTime | Array of strings | 事件发生时间，当事件告警规则中的告警策略为累计触发时，会显示每次事件的发生时间。 | | MonitoringRange | String | 监控范围，取值范围为：指定资源、全部资源、资源分组。 |