关于zabbix自定义监控项和触发器问题

一、自定义监控项配置

1. 基本概念

监控项（Item）：采集数据的最小单位，定义了要监控什么、如何采集数据。

2. 创建自定义监控项的步骤

进入配置页面

配置 → 主机 → 选择主机 → 监控项 → 创建监控项

填写关键参数

• 名称：监控项描述名称
• 键值：唯一的标识符（格式：key[参数]）
• 类型：
  • Zabbix代理
  • Zabbix客户端（主动式）
  • 简单检查
  • 外部检查等
• 信息类型：数值（整数/浮点数）、文本、日志等
• 更新间隔：数据采集频率
• 历史数据保留：历史数据存储时长
• 趋势数据保留：聚合数据存储时长

在Zabbix Agent配置文件（zabbix_agentd.conf）中添加：

# 格式：UserParameter=<key>,<command>
UserParameter=custom.process.count,ps aux | wc -l
UserParameter=custom.file.size[*],du -b $1 | awk '{print $1}'

重启Agent后，在Web界面使用键值：

• custom.process.count
• custom.file.size[/var/log/syslog]

3. 常见监控项类型示例

UserParameter=system.process.count,ps -e | wc -l

UserParameter=directory.size[*],du -s $1 | awk '{print $1}'

UserParameter=service.status[*],systemctl is-active $1

UserParameter=mysql.connections,mysql -u<user> -p<password> -e "SHOW STATUS LIKE 'Threads_connected'" | grep Threads | awk '{print $2}'

二、触发器配置

1. 触发器表达式语法

{<host>:<key>.<function>(<parameter>)}<operator><constant>

2. 创建触发器步骤

进入触发器配置

配置 → 主机 → 选择主机 → 触发器 → 创建触发器

关键配置项

• 名称：触发器描述（可使用宏 {ITEM.VALUE}）
• 表达式：触发条件表达式
• 严重性：信息、警告、一般严重、严重、灾难
• 依赖关系：设置触发器依赖
• 标签：用于事件关联和自动化

3. 触发器表达式示例

# CPU使用率超过90%持续5分钟
{host:system.cpu.util[,system].avg(5m)}>90

# 内存使用率超过80%
{host:vm.memory.size[pavailable].last()}<=20

# 磁盘空间不足（小于10%）
{host:vfs.fs.size[/,pfree].last()}<10

# 服务宕机
{host:net.tcp.service[http].last()}=0

# 连续3次检查失败
{host:icmpping.count(,5m)}>3

# 平均值超过阈值
{host:system.cpu.load[percpu,avg1].avg(10m)}>5

# 多个条件组合
{host:system.cpu.util[,system].avg(5m)}>90 and {host:system.cpu.load[percpu,avg1].last()}>5

4. 函数使用示例

# 最近一次值
last()

# 平均值
avg(5m)       # 5分钟平均值
avg(1h)       # 1小时平均值
avg(#3)       # 最近3次平均值

# 最大值/最小值
max(10m)      # 10分钟内最大值
min(1h)       # 1小时内最小值

# 变化率
delta(1h)     # 1小时内的变化值
change()      # 当前值与前一值的差异

# 计数
count(5m)     # 5分钟内值的数量
count(10m,0)  # 10分钟内值为0的次数

# 时间函数
timeleft(1h,100,0)  # 按当前趋势达到阈值的时间预测

三、实战示例

示例1：监控Nginx状态

Agent配置：

UserParameter=nginx.active.connections,curl -s http://localhost/nginx_status | grep "Active" | awk '{print $3}'
UserParameter=nginx.requests.total,curl -s http://localhost/nginx_status | grep "server accepts" | awk '{print $3}'

监控项键值：

• nginx.active.connections
• nginx.requests.total

触发器：

# Nginx活跃连接数超过1000
{host:nginx.active.connections.last()}>1000

# 5分钟内请求数增长异常（超过平时2倍）
{host:nginx.requests.total.avg(5m)} > {host:nginx.requests.total.avg(1h)} * 2

示例2：监控自定义应用日志

Agent配置：

UserParameter=app.error.count,grep "ERROR" /var/log/app/app.log | wc -l

监控项配置：

• 类型：Zabbix代理
• 键值：app.error.count
• 更新间隔：60s
• 信息类型：数值（无符号整数）

触发器配置：

# 10分钟内错误数超过10次
{host:app.error.count.avg(10m)}>10

# 错误数突然增加（超过前一小时的3倍）
{host:app.error.count.avg(10m)} > {host:app.error.count.avg(1h)} * 3

四、高级技巧

1. 使用LLD（低级别发现）

# 自动发现挂载点
UserParameter=vfs.fs.discovery,lsblk -o MOUNTPOINT -n | grep -v "^$" | awk '{printf "{\"{#MOUNTPOINT}\":\"%s\"},\n", $1}' | sed '$s/,$//' | awk 'BEGIN{print "{\"data\":["}{print $0}END{print "]}"}'

2. 依赖触发器

防止告警风暴：

# 主触发器
{host:agent.ping.nodata(3m)}=1

# 依赖触发器（只在网络连通时触发）
{host:system.cpu.util[,system].avg(5m)}>90 and {host:agent.ping.last()}=1

3. 使用宏和标签

# 在触发器名称中使用宏
CPU使用率超过{$CPU.CRIT}%: {ITEM.VALUE}

# 使用标签分类
标签: application → nginx
标签: component → performance

五、故障排除

常见问题

监控项不采集数据

• 检查Agent配置和日志
• 测试命令是否正常执行
• 检查防火墙/权限

触发器不触发

• 检查表达式语法
• 确认数据已正常采集
• 检查触发器依赖关系

测试监控项

# 在Agent端测试
zabbix_get -s 127.0.0.1 -k "custom.process.count"

最佳实践

需要更具体的监控场景配置，请提供详细需求。