HertzBeat监控系统中的阈值触发表达式详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00269/article/details/148487096

HertzBeat监控系统中的阈值触发表达式详解

hertzbeat An open source, real-time monitoring system with custom-monitoring, high performance cluster, prometheus-like and agentless. 项目地址: https://gitcode.com/gh_mirrors/he/hertzbeat

什么是阈值触发表达式

在HertzBeat监控系统中，阈值触发表达式是配置告警规则的核心组成部分。它定义了当监控指标达到什么条件时，系统应该触发告警。表达式基于监控指标值和预设条件进行逻辑判断，为运维人员提供了灵活多样的告警配置方式。

表达式基础语法

HertzBeat的阈值触发表达式支持多种运算符和函数，可以满足各种复杂的告警场景需求。

比较运算符

| 运算符类型 | 表达式写法 | 适用数据类型 | 说明 | |------------------|----------------------|--------------------|--------------------------| | 等于 | equals(str1,str2) | 字符串 | 判断字符串是否相等 | | 不等于 | !equals(str1,str2) | 字符串 | 判断字符串是否不等 | | 包含 | contains(str1,str2) | 字符串 | 判断是否包含子串 | | 不包含 | !contains(str1,str2) | 字符串 | 判断是否不包含子串 | | 正则匹配 | matches(str1,str2) | 字符串 | 正则表达式匹配 | | 正则不匹配 | !matches(str1,str2) | 字符串 | 正则表达式不匹配 | | 存在 | exists(obj) | 字符串/数字/时间 | 判断值是否存在 | | 不存在 | !exists(obj) | 字符串/数字/时间 | 判断值是否不存在 |

数学运算符

对于数值和时间类型的比较，可以使用标准的数学运算符：

> 大于
< 小于
>= 大于等于
<= 小于等于
!= 不等于
== 等于

逻辑运算符

&& 逻辑与
|| 逻辑或
! 逻辑非

其他运算符

三元运算符：condition ? trueExpression : falseExpression
算术运算符：+, -, *, /, %
数组访问：array[n]
括号：() 用于改变运算优先级

环境变量使用

在HertzBeat中，环境变量是表达式能够引用监控指标的关键。它们分为两类：

非固定环境变量：根据选择的监控指标动态变化。例如：
- 网站监控中的响应时间变量：responseTime
- CPU监控中的使用率变量：usage
固定环境变量：
- instance：表示监控实例的值，常用于区分不同实例的监控数据

实用函数库

HertzBeat提供了一些实用函数来简化表达式编写：

toDouble(str)：字符串转双精度浮点数
toBoolean(str)：字符串转布尔值
toInteger(str)：字符串转整数

典型应用场景示例

基础数值比较

网站响应时间告警：
```
responseTime >= 400
```
当网站响应时间超过400毫秒时触发告警
API响应时间告警：
```
responseTime > 3000
```
API响应时间超过3秒触发告警

多条件组合

特定实例告警：
```
equals(instance,"https://baidu.com") && responseTime > 200
```
仅当百度网站的响应时间超过200毫秒时触发告警
数据库线程数告警：
```
threads_running > 7
```
MySQL运行线程数超过7时触发告警

复杂逻辑判断

组合条件告警：
```
(cpu_usage > 90 || memory_usage > 90) && disk_usage > 95
```
CPU或内存使用率超过90%，同时磁盘使用率超过95%时触发告警
正则匹配告警：
```
matches(error_message, ".*timeout.*")
```
当错误信息中包含"timeout"时触发告警