HertzBeat监控告警阈值表达式详解

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)：值不存在判断

逻辑运算符

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

数学运算符

• +、-、*、/、%：基础数学运算
• ()：运算优先级控制

环境变量使用

在HertzBeat中，环境变量是连接监控指标与告警表达式的桥梁：

动态环境变量

这些变量名称与监控指标名称一致，例如：

• 网站监控中的responseTime
• MySQL监控中的threads_running
• 系统监控中的cpu_usage

固定环境变量

• instance：表示监控实例标识，常用于区分不同监控目标

实用表达式示例

基础场景

1. 响应时间告警

   responseTime > 500
   

   当响应时间超过500毫秒时触发告警

2. 错误率告警

   errorRate >= 0.05
   

   当错误率达到5%时触发告警

复合条件场景

1. 特定实例告警

   equals(instance,"db-master") && cpu_usage > 90
   

   仅当实例为"db-master"且CPU使用率超过90%时触发

2. 多条件组合告警

   (cpu_usage > 90 || memory_usage > 85) && disk_usage > 95
   

   CPU或内存高使用率且磁盘空间不足时触发

高级运算场景

1. 计算型告警

   (success_count / total_count) < 0.99
   

   成功率低于99%时触发

2. 正则匹配告警

   matches(error_message, ".*timeout.*")
   

   当错误信息包含"timeout"时触发

最佳实践建议

1. 阈值设置原则：建议基于历史监控数据设置合理的阈值，避免频繁误报

2. 表达式复杂度控制：避免过于复杂的表达式，建议拆分为多个简单条件

3. 测试验证：配置后应进行充分测试，确保表达式按预期工作

4. 文档记录：为每个表达式添加注释说明，便于后续维护

5. 渐进式调整：初次设置可适当放宽阈值，后续根据实际情况逐步收紧

通过合理运用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