本文档介绍如何使用告警回调。 ## 背景信息您在 [创建告警策略](/docs/83571/1134189) 时，可以配置在互联网上可访问的回调 URL，例如 `https://www.volcengine.com`。当告警被触发时，云拨测通过 POST 请求把 JSON 格式的告警通知发送到您配置的回调 URL。您对收到的告警通知进行处理后，就可以把告警通知接入您的消息机器人或工单系统。 :::tip 回调 URL 不支持 IP 地址。 ::: ## 告警回调参数说明云拨测发送的 JSON 格式告警通知的参数说明如下： |**参数** |**类型** |**说明** | |---|---|---| |task_id |Integer |告警策略 ID。 | |detect_task_name |String |拨测任务名称。 | |detect_task_id |Integer |拨测任务 ID。 | |account_id |Integer |创建告警的火山引擎用户账号。 | |owner |String |* 若创建告警的账号为主账号，则取值为`root`。|\ | | |* 若创建告警的账号为子用户，则为创建告警的火山引擎用户名。 | |name |String |告警的名称。 | |subtask_list |Array of Objects |告警关联的分组列表。具体请参见 [subtask_list](/docs/83571/1149775#cf5b658a)。 | |grade |String |告警级别。|\ | | ||\ | | |* `P0`：严重|\ | | |* `P2`：普通 | |alert_type |String |告警类型。|\ | | ||\ | | |* `alert`：告警|\ | | |* `recovery`：恢复 | ### subtask_list |**参数** |**类型** |**说明** | |---|---|---| |session_id |String |告警事件 ID。 | |filters |Array of Objects |监控维度。具体请参见 [filters](/docs/83571/1149775#b74c2144)。 | |alarm_begin_time |String |告警开始时间。 | |alarm_detail |Array of Objects |告警详细信息。具体请参见 [alarm_detail](/docs/83571/1149775#30015b00)。 | ### filters |**参数** |**类型** |**说明** | |---|---|---| |key |String |监控维度的 key。|\ | | ||\ | | |* `$[client.isp.name]`：运营商|\ | | |* `$[client.province.name]`：地区 | |values |Array of Strings |监控维度的值。 | |type |String |监控维度的类型。固定为 `in`。 | ### alarm_detail |**参数** |**类型** |**说明** | |---|---|---| |name |String |触发告警的监控指标名称。请参见[告警监控指标](/docs/83571/1150780)。 | |metric_key |String |触发告警的监控指标。 | |threshold |Float |触发告警的监控指标阈值。 | |cur_value |Float |触发告警的监控指标的实际值。 | ## 告警回调示例 ```JSON { "task_id": 10010****, "detect_task_id": 2445****, "detect_task_name": "回调测试", "account_id": 200000****, "owner": "root", "name": "回调测试", "subtask_list": [ { "filters": [ { "Key": "$[client.isp.name]", "Values": [ "电信" ], "Type": "in", "name": "节点运营商" }, { "Key": "$[job.id]", "Values": [ "24453858" ], "Type": "in", "name": "拨测任务id" } ], "alarm_begin_time": "2025-07-24T14:31:21+08:00", "alarm_detail": [ { "metric_key": "#[count]", "name": "拨测次数", "threshold": 5, "cur_value": 11 } ], "session_id": "181b97eb-135f-4fee-bb58-418833be****" } ], "grade": "P0", "alert_type": "alert" } ```