告警回调使用说明

云监控告警策略中可以指定告警回调URL，本文主要介绍该URL的使用规范，以及云监控告警回调接口发送的POST请求包含的参数信息。

背景信息

当您创建告警策略时，在创建页面的通知方式区域，除了可以指定告警联系组接收告警通知，还可以设置告警回调URL接收告警通知。页面展示信息如下图所示，关于创建告警策略的具体操作，请参见创建告警策略。

如果您创建的告警策略设置了告警回调，当被监控的云服务触发告警策略时，云监控会发送告警通知至联系组成员，同时还会调用告警回调接口向指定的URL发起一次POST请求并携带告警通知的请求体（application/json）。
告警回调的重试策略为3次，超时时间为8秒。有一定概率出现客户端判定请求超时并触发重试，而服务端能够正常接收请求，导致重复回调的情况，可以根据请求header中的x-volc-trace-id内容判断请求的唯一性，重试请求x-volc-trace-id均相同。

告警回调URL限制条件

告警回调的URL必须符合以下限制条件，才可以成功接收告警通知。

• 云监控服务可以直接访问该URL，即URL必须具备公网访问能力。

• URL的组成字符必须是英文字符（即半角字符），且URL的首尾部不要添加无意义的空格或换行符。

• URL的结构必须符合以下规范：

  schema://host/path#query-param
  

  具体说明如下：

  • schema：请求协议。
    云监控不会主动为告警回调URL添加任何协议，因此您在指定URL时必须手动添加协议。

    说明

    云监控支持HTTP和HTTPS请求协议，如果因协议不正确导致URL无法解析，则云监控无法进行告警回调。

  • host/path：请求域名和路由。
    配置您用于接收告警通知的域名以及路由信息。
  • query-param：请求参数。
    云监控不会修改请求参数的内容，但是会对请求参数进行编码。因此回调的接收方需要对URL中的数据进行解码，以保证获取到正确的参数数据。

    说明

    云监控不推荐使用请求参数；云监控也不会添加任何请求参数。

  示例URL如下：

  http://example.com
  

相关文档

• 如果您想查看云产品的指标告警回调的请求内容，请参见指标告警回调请求内容。
• 如果您想查看云产品的事件告警回调的请求内容，请参见事件告警回调请求内容。