You need to enable JavaScript to run this app.
导航
告警回调使用说明
最近更新时间:2024.09.04 11:42:47首次发布时间:2022.06.20 15:04:07

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

背景信息

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

说明

如果您之前已创建了告警策略但是没有设置告警回调,则可以编辑已有的告警策略添加告警回调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
    

相关文档