使用告警回調
更新時間 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
}