警报推送 - 听云Network

Network产品和平台都支持警报推送。平台的推送格式较为固定，且不宜修改。Network产品自己的警报推送分为两种：HTTP推送和UDP推送。一般情况下是使用Network的HTTP推送。

警报推送接口

请参见《基调听云_Network数据字典_警报推送接口使用说明_客密》。

HTTP警报推送模板

越来越多的客户开始使用统一的信息接入平台，来对接第三方服务厂商推送过来的信息，例如警报信息。Network产品实现了模板化的警报推送方式，可以将标准的警报字段按客户需求拼接成所需格式，来满足客户对警报信息的多样化需求。

使用流程

在Network控制台创建监测任务。
客户在平台上配置警报。
客户需要配置基调听云的服务器白名单。


106.75.114.38、106.75.25.50、106.75.108.179

客户提供具体的服务推送地址（把警报信息推送到那里）。
客户提供告警推送的模板格式（或者是客户接入内容的文档）。
基调听云研发人员根据客户需求定制推送服务。

支持的字段

目前仅支持以下字段拼接模板，不支持额外字段的开发。

JSON参数	类型	说明
user_name	string	账号名称。
task_name	string	任务名称。
task_url	string	任务地址。
alarm_id	int	警报ID。
item_seq	int	警报周期序列。
alarm_type	int	警报类型。(0:性能警报，1:错误警报，3：智能告警)
alarm_name	string	警报名称。
alarm_status	string	警报状态。包括警报和正常两种状态。
alarm_status_detail	string	("警报"，"严重警报"，"正常"）
alarm_time	string	警报取样时段。
point_total	string	取样的监测点数。
perf	string	设定的性能指标（性能警报和智能告警才有描述）。
avail	string	可用性（性能警报和智能告警才有描述）。
pointError	string	点数错误描述（错误警报才会有描述）。
errorPercent	string	错误占比描述（错误警报才会有描述）。
triggerOn	string	警报触发原因。性能警报：性能指标及可用性均触发了警告；可用性触发了警告；当性能和可用性越过设定的警告阈值时触发警告；警报解除。错误警报：错误监测点数超过了阈值；错误监测百分比超过了阈值；警报解除。
alarmPoints	散点数据集(集合)。
	tmBase	string	监测时间。
	probeIp	string	监测点IP。
	city	string	监测城市。
	isp	string	监测运营商。
	performance	string	性能数值（性能警报和智能告警才有值）。
	compDesc	string	性能指标名称。
	compUnit	string	性能单位。
	destIp	string	主机IP。
	destCity	string	主机城市。
	destIsp	string	主机运营商。
	errorDesc	string	错误描述。
	domainUrl	string	监测域名(仅仅在域名警报才会有数据)。

请求参数/返回参数/错误代码


内容描述	客户根据自己业务系统，自定义JSON数据结构，请求参数客户定义。
交互规则	HTTP 推送

拼接示例

所需要的字段，应当使用${}来标识。

{

"rule_id":"${alarm_id}",

"state":<#if status = 1||status = 2>"open"<#else>"close"</#if>,

"title":"${alarm_name}",

"content":"警报名称：${alarm_name}告警数据取样时间：${alarm_time}${triggerOn}<#if >${perf}${avail}</#if><#if >${point_total}${pointError}${errorPercent}</#if>"

}

结果示例如下：

{

"rule_id": "19,790",

"state": "open",

"title": "任务_错误警报推送",

"content": "您在基调听云监测平台配置的监测任务:错误警报推送，由于错误监测点数超过了阈值..........."

}