使用告警回调
更新时间 2025-05-22 15:04:23
最近更新时间: 2025-05-22 15:04:23
云监控通知方式除短信、邮件外,还支持webhook回调方式。通过该功能,可以将资源告警信息通知至企微、钉钉或其他自建平台。
操作场景
需要将告警通知信息推送至企微、钉钉、飞书或其他自建平台。
前提条件
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,用作回调结果校验。
请求参数
请求头header参数
无
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
msgtype | 是 | String | 信息类型 | text | |
msg_type | 是 | String | 信息类型(飞书使用) | text | |
context | 是 | Object | 通知内容 | {"text":"云监控告警通知信息"} | |
text | 是 | Object | 通知内容(冗余字段,飞书使用) | {"content":"云监控告警通知信息"} | |
model_id | 是 | String | 规则id | 81b365af-142d-55cf-989e-ba30903e25a3 | |
issue_id | 是 | String | 告警事件id | 6750107b8d4ae01a03632f26 | |
name | 是 | String | 告警规则名称 | 云主机CPU告警 | |
status | 是 | int | 通知类型:0:恢复;1:告警 | 0 | |
level | 是 | int | 告警等级 : 1:紧急2:警示3:普通 | 1 | |
region | 是 | String | 资源池名称 | 贵州15 | |
info | 是 | Array of Object | 告警详情 | InfoNotify | |
ctime | 是 | int | 告警事件创建时间戳 | 1733300347 | |
mtime | 是 | int | 告警事件更新时间戳 | 1733879666 |
表InfoNotify
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
value | 是 | String | 告警数值 | 0.5 | - |
ctime | 是 | int | 告警详情创建时间戳 | 1733300347 | - |
mtime | 是 | int | 告警详情更新时间戳 | 1733879666 | - |
resource | 是 | Array of Object | 告警资源信息 | resource | - |
info_rule | 是 | Object | 触发告警的规则策略信息 | Rule | - |
表 resource
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
name | String | 资源实例标签键 | uuid | |
value | String | 资源实例标签值 | 000f0322-1f4d-8cc8-bb2e-1c30fb****** |
表 Rule
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
metric | String | 监控指标 | mem_util | |
for | Integer | 持续时间,当规则执行结果持续多久符合条件时报警(防抖,evaluationCount*60 | 120 | |
func | String | 本参数表示告警采用算法。取值范围:last:原始值算法。avg:平均值算法。max:最大值算法。min:最小值算法。sum:求和算法。根据以上范围取值。 | avg | |
operator | String | 本参数表示比较符。取值范围:eq:等于。gt:大于。ge:大于等于。lt:小于。le:小于等于。ne:不等于。rg:环比上升。cf:环比下降。rc:环比变化。根据以上范围取值。 | eq | |
value | String | 告警阈值,可以是整数、小数或百分数格式字符串 | 0 | |
period | String | 本参数表示算法统计周期。 | 5m | |
unit | String | 单位,部分资源池不支持,默认为空 | bit |
请求示例
请求url
wehook回调地址
请求头header
无
请求体body
{
"msgtype": "text",
"msg_type": "text",
"content": {
"text": "云监控告警通知信息"
},
"text": {
"content": "云监控告警通知信息"
},
"model_id": "81b365af-142d-55cf-989e-ba30903e25a3",
"issue_id": "7622615f9caaef26d695312f",
"name": "云主机CPU告警",
"status": 1,
"level": 1,
"region": "贵州3",
"info": [
{
"metric": "cpu_util",
"value": "26.0770",
"ctime": 946656000,
"mtime": 946656000,
"resource": [
{
"name": "uuid",
"value": "7dd744ea-5a02-61d3-e627-38f82f******"
},
{
"name": "instancename",
"value": "ecm-af97"
}
],
"info_rule": {
"for": 120,
"func": "last",
"operator": "ge",
"unit": "%",
"value": "0",
"metric": "cpu_util",
"period": ""
}
}
],
"ctime": 946656000,
"mtime": 946656000
}