操作场景
需要将告警通知信息推送至企微、钉钉、飞书或其他自建平台。
前提条件
1、注册天翼云账号，并完成实名认证。具体操作，请参见天翼云账号注册流程。
2、需准备好公网URL地址，该地址将填写至告警规则“告警回调”文本框，作为告警消息推送地址。
注意
告警回调需将182.43.5.0/24 、182.43.7.0/24 加入防火墙的白名单。
告警回调的重试策略为3次，超时时间为5秒。
操作步骤
- 登录控制中心。
- 在控制中心页面左上角点击
，选择区域，本文我们选择华东1。 - 依次选择“管理与部署”，单击“云监控”，进入监控概览页面。
- 单击“告警服务”下拉菜单，单击“告警规则”，进入告警规则列表页面。
- 在“告警规则”列表界面，单击“创建告警规则”按钮。
- 在“配置告警通知”模块，将前提条件准备好的URL地址填写至“告警回调”文本框。
- 点击“测试”完成接口连通性测试，同步完成其他告警规则项配置。
- 点击“确定”，即可完成通知方式为告警回调接口的规则配置。
接口约束
1、webhook地址正确，且需要把云监控平台以下公网地址段添加到安全组白名单182.43.5.0/24、182.43.7.0/24。
2、回调接口应当返回json response，内容不限，且http状态码应当为200，用作回调结果校验。
执行结果
发送的POST请求内容如下表所示。
接口约束
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| msgtype | 是 | String | 信息类型 | "text" | |
| msg_type | 是 | String | 信息类型(冗余字段，飞书使用) | "text" | |
| context | 是 | Object | 通知内容 | {"text":"通知内容11111"} | |
| text | 是 | Object | 通知内容(冗余字段，飞书使用) | {"content":"通知内容11111"} | |
| mid | 是 | String | 通知内容id | "11111111" | |
| model_id | 是 | String | 规则id | "222222" | |
| issue_id | 是 | String | 告警事件id | "222222" | |
| name | 是 | String | 规则名称 | "test" | |
| status | 是 | int | 通知类型：0，恢复；1，告警 | 0 | |
| level | 是 | int | 告警等级 ： 1，2，3 | 1 | |
| idc | 是 | String | 资源池标识符 | "guizhou15" | |
| region | 是 | String | 规则id | "3333333333" | |
| info | 是 | Object | 告警详情 | InfoNotify | |
| ctime | 是 | int | 告警事件创建时间戳 | 111111111 | |
| mtime | 是 | int | 告警事件修改时间戳 | 11111111 | |
| project | 是 | string | 告警规则创建类型（区分控制台和计算侧创建） | "console" |
表InfoNotify
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| uuid | 是 | String | 资源uuid | "11111111" | |
| device_type | 是 | String | 设备类型 | "vm" | |
| metirc | 是 | String | 指标 | "cpu_util" | |
| value | 是 | String | 告警数值 | "0.5" | |
| ctime | 是 | int | 告警详情创建时间 | 111111 | |
| mtime | 是 | int | 告警详情修改时间 | 111111 |
POST请求示例：
{
"msgtype":"text",
"msg_type":"text",
"content": {"text": "消息说明: 该消息由webhook测试功能发出，收到该消息说明您填写的webhook可以被天翼云云监控正常调用。 以下各字段均为示例。\n\n尊敬的天翼云用户，云监控告警提醒：告警状态变为\"告警\"\n规则ID：6437615f9caaef26d695312f\n告警名称：webhook测试\n监控指标：cpu_util\n告警描述：无描述\n资源池名称：贵州POC\n首次触发时间：2000-01-01 00:00:00\n当前告警数据时间：2000-01-01 00:00:00\n告警详情：\n【1】监控对象：2265e931-3a0b-40a4-9a33-66f8c1bff623\n告警数据值：26.0770"},
"text": {"content": "消息说明: 该消息由webhook测试功能发出，收到该消息说明您填写的webhook可以被天翼云云监控正常调用。 以下各字段均为示例。\n\n尊敬的天翼云用户，云监控告警提醒：告警状态变为\"告警\"\n规则ID：6437615f9caaef26d695312f\n告警名称：webhook测试\n监控指标：cpu_util\n告警描述：无描述\n资源池名称：贵州POC\n首次触发时间：2000-01-01 00:00:00\n当前告警数据时间：2000-01-01 00:00:00\n告警详情：\n【1】监控对象：2265e931-3a0b-40a4-9a33-66f8c1bff623\n告警数据值：26.0770"},
"mid": "6437615f9caaef26d695312f",
"model_id": "6437615f9caaef26d695312f",
"issue_id": "7622615f9caaef26d695312f",
"name": "webhook测试",
"status": 1,
"level": 1,
"idc": "gz03",
"region": "贵州3",
"info": {
"uuid": "2265e931-3a0b-40a4-9a33-66f8c1bff623",
"device_type": "vm",
"metric": "cpu_util",
"value": "26.0770",
"ctime": 946656000,
"mtime": 946656000,
},
"ctime": 946656000,
"mtime": 946656000,
"project": "console",
}
