报警回调--边缘计算节点-火山引擎

文档中心

立即注册

导航

报警回调

最近更新时间：2024.05.29 10:16:55首次发布时间：2024.05.24 14:41:14

功能简介

边缘监控提供报警回调功能。报警回调功能适用于以下场景：您自建运维系统或报警通知系统，需要将边缘监控服务中的报警信息整合到自建系统。

当您使用回调功能后，边缘监控会定期向您指定的回调URL推送报警信息。您可以对报警信息做进一步处理。

当前，报警回调功能仅覆盖指标类报警。

功能使用说明

使用报警回调功能时，请您关注以下事项：

您指定的回调URL可通过公网访问。
边缘监控将使用以下两个IP地址向您推送报警信息：220.243.131.172 和 220.243.131.173。请确保您的防火墙放行来自这两个IP地址的请求。
边缘监控会通过POST请求向您指定的回调URL推送报警信息。POST请求使用HTTP/HTTPS协议，数据以JSON格式发送。
报警规则被触发后，边缘监控会每隔30秒推送一次数据，直至报警解除。
如果报警信息推送失败，边缘监控最多会重试3次。每次推送请求的超时等待时间为5秒。

功能配置指引

您可以在创建报警规则或者编辑报警规则时，配置回调URL。具体操作，请参考创建报警规则或编辑报警规则。

数据格式说明

以下表格描述了边缘监控发送的报警数据的内容。

参数解释

参数	类型	示例值	描述
account_id	Int64	210000****	火山引擎账号ID。
alert_type	String	metric	报警类型： metric：指标类报警。
category	String	VEEN	监控模块： VEEN：边缘计算节点 — 基础监控 VEEN_AGENT：边缘计算节点 — 操作系统监控 EIP：弹性公网IP LB4：四层负载均衡 LB7：七层负载均衡 NAT_GATEWAY：NAT网关 NAS：文件存储 CLOUD_DISK：云盘 VEECC：边缘容器 VEEF：边缘函数 VEECP_CLUSTER：边缘托管 — 集群 VEECP_NODE：边缘托管 — 节点 VEECP_NAMESPACE：边缘托管 — 命名空间 VEECP_POD：边缘托管 — Pod
rule	Rule	参见Rule	报警规则的详细定义，包括报警规则的名称、规则触发条件等。
value	Float64	0.5	报警规则中指定的监控指标的值。
instance_id	String	veen042419444120292****	实例 ID。监控模块不同，实例指代的对象不同。例如，如果监控模块是边缘计算节点，实例指代的是边缘实例；如果监控模块是NAT网关，实例指代的是NAT网关。
labels	Map[String]String	参见Labels	附加信息。监控模块不同，附加信息也会存在差异。
created_time	Int64	1712913172	规则的触发时间，以UNIX时间戳表示。单位：秒。
duration	Int64	1117	报警的持续时间。单位：秒
status	String	firing	报警状态： firing：报警中。 recovering：恢复中。 closed：已恢复。

Rule

参数	类型	示例值	描述
id	Int64	1971	报警规则ID。
name	String	test	报警规则名称。
metric_name	String	cpu_usage	监控指标名称。详细说明，请参考监控指标说明。
operator	String	>	报警阈值采用的运算符： >、>= <、<= ==、!= between
threshold	Float64	1	运算符不是between时的阈值。
min	Float64	1	运算符是between时的阈值。
max	Float64	4	运算符是between时的阈值。
unit	String	%	监控指标的单位。详细说明，请参考监控指标说明。
level	String	Notice	规则等级： Notice：通知。 Warn：警告。 Fatal：严重。

Labels

下表列出了您可以通过labels获取的信息。不同监控模块对应的labels的值不同。

监控模块	参数	类型	示例值	描述
VEEN_AGENT	region	String	CentralChina	区域。
	city	String	410100	城市。
	isp	String	CMCC	运营商。
	cluster	String	**ct03	节点。
	cloud_server	String	cloudserver-bfrhpxrqc28****	边缘服务。
	device	String	eth0	设备。报警规则中指定网络相关指标时，该参数代表网卡。报警规则中指定磁盘相关指标时，该参数代表硬盘。报警规则中指定GPU相关指标时，该参数代表GPU。
VEEN	region	String	CentralChina	区域。
	city	String	410100	城市。
	isp	String	CMCC	运营商。
	cluster	String	**ct03	节点。
	cloud_server	String	cloudserver-bfrhpxrqc28****	边缘服务。
VEECC	region	String	CentralChina	区域。
	city	String	410100	城市。
	isp	String	CMCC	运营商。
	cluster	String	**ct03	节点。
	workload_name	String	res-330222366	工作负载的名称。
	app_name	String	veecc-3309092052209022****	边缘应用的ID。
LB4	region	String	CentralChina	区域。
	city	String	410100	城市。
	cluster	String	**ct03	节点。
	listener_id	String	667f4df0bca157e66a2f163ac9d8****	监听器ID。
LB7	region	String	CentralChina	区域。
	city	String	410100	城市。
	isp	String	CMCC	运营商。
	cluster	String	**ct03	节点。
EIP	region	String	CentralChina	区域。
	city	String	410100	城市。
	isp	String	CMCC	运营商。
	cluster	String	**ct03	节点。
NAT_GATEWAY	region	String	CentralChina	区域。
	city	String	410100	城市。
	isp	String	CMCC	运营商。
	cluster	String	**ct03	节点。
VEECP_CLUSTER	cluster	String	test_01	边缘集群。
VEECP_CLUSTER	region	String	cn-beijing	地域。
VEECP_NODE	cluster	String	test_01	边缘集群。
	region	String	cn-beijing	地域。
	node	String	node-2w6u****	节点。
VEECP_NAMESPACE	cluster	String	test_01	边缘集群。
	region	String	cn-beijing	地域。
	namespace	String	default	命名空间。
VEECP_POD	cluster	String	test_01	边缘集群。
	region	String	cn-beijing	地域。
	namespace	String	default	命名空间。
	pod	String	nginx-deploy****	Pod。

示例数据

{
    "account_id": 210000****,
    "alert_type": "metric",
    "category": "VEEN",
    "rule": {
        "id": 1971,
        "name": "测试webhook",
        "metric_name": "cpu_usage",
        "operator": ">=",
        "threshold": 80,
        "min": 0,
        "max": 0,
        "unit": "%",
        "level": "Notice"
    },
    "value": 0,
    "instance_id": "veen0424194441202921****",
    "labels": {
        "account": "210000****",
        "category": "VEEN",
        "city": "ZJ_NingBo",
        "cloud_server": "cloudserver-9qzbkjvf2dk***",
        "cluster": "nbct05",
        "isp": "CTCC",
        "name": "veen0424194441202921****",
        "region": "EastChina"
    },
    "created_time": 1712920829,
    "duration": 1140,
    "status": "firing"
}