zabbix如何自定义监控项

# Zabbix如何自定义监控项 ## 一、自定义监控项概述 Zabbix作为企业级分布式监控系统，其核心功能之一是通过监控项（Items）采集各类指标数据。当内置监控模板无法满足特定需求时，自定义监控项就成为管理员必须掌握的技能。本文将全面介绍Zabbix自定义监控项的实现方法、配置流程及最佳实践。 ### 1.1 自定义监控项的应用场景 - 监控业务特有指标（如订单处理量） - 采集非标准服务/设备的数据 - 实现应用性能深度监控 - 满足合规性监控需求 ### 1.2 技术实现原理 Zabbix通过以下方式采集自定义数据： - **Agent采集**：执行本地脚本/命令 - **SNMP**：读取设备OID信息 - **JMX**：监控Java应用 - **HTTP/API**：调用RESTful接口 - **IPMI**：硬件级监控 ## 二、Agent方式自定义监控项 ### 2.1 UserParameter配置 在Zabbix Agent端配置`zabbix_agentd.conf`： ```ini # 格式：UserParameter=<key>,<command> UserParameter=mysql.connections, mysqladmin -uroot status | awk '{print $4}' UserParameter=custom.discovery[*], /etc/zabbix/scripts/discovery_$1.sh 

2.2 脚本开发规范

• 脚本存放路径：/etc/zabbix/scripts/
• 执行权限：chmod +x 并设置zabbix用户可执行
• 输出要求：纯文本、单行输出（JSON需转义）

示例脚本（disk_discovery.sh）：

#!/bin/bash disks=$(lsblk -ln | grep disk | awk '{print $1}') echo -n '{"data":[' for disk in $disks; do echo -n "{\"{#DISKNAME}\":\"$disk\"}," done | sed 's/,$//' echo ']}' 

2.3 主动式与被动式监控

模式	数据传输方向	适用场景
被动模式	Server → Agent	默认模式，实时性高
主动模式	Agent → Server	大规模分布式环境

三、SNMP自定义监控

3.1 OID查找方法

snmpwalk -v 2c -c public 192.168.1.1 .1.3.6.1.2.1.1.5 

3.2 SNMP监控项配置

Type: SNMP agent Key: sysName.0 SNMP OID: 1.3.6.1.2.1.1.5.0 SNMP community: ${SNMP_COMMUNITY} 

四、JMX监控配置

4.1 Java应用配置

启动参数添加JMX支持：

-Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=12345 \ -Dcom.sun.management.jmxremote.authenticate=false \ -Dcom.sun.management.jmxremote.ssl=false 

4.2 Zabbix Server配置

JavaGateway=192.168.1.100 StartJavaPollers=5 

五、HTTP监控项

5.1 Web场景监控

Type: HTTP agent URL: http://example.com/api/health Request type: GET Timeout: 30s Required status codes: 200 

5.2 JSON数据处理

使用预处理（Preprocessing）：

JSONPath: $.data.connections 

六、低级别自动发现（LLD）

6.1 发现规则配置

{ "data": [ { "{#FSNAME}": "/", "{#FSTYPE}": "ext4" }, { "{#FSNAME}": "/data", "{#FSTYPE}": "xfs" } ] } 

6.2 监控项原型

Key: vfs.fs.size[{#FSNAME},free] 

七、监控项高级配置

7.1 自定义间隔

Update interval: 30s Flexible intervals: - 00:00-06:00 5m - */30 09:00-18:00 1m 

7.2 值映射（Value mapping）

创建映射表：

0 ⇒ 正常 1 ⇒ 警告 2 ⇒ 严重 

7.3 预处理管道

Steps: 1. Regular expression: ^Total: (\d+)$ 2. Custom multiplier: 1024 3. Delta (speed per second) 

八、调试与排错

8.1 测试命令执行

su - zabbix -s /bin/bash -c "/etc/zabbix/scripts/cpu_temp.sh" 

8.2 日志分析

tail -f /var/log/zabbix/zabbix_agentd.log journalctl -u zabbix-agent -f 

8.3 Zabbix Get工具

zabbix_get -s 127.0.0.1 -k "system.cpu.load[all,avg1]" 

九、性能优化建议

1. 批量采集：单个脚本返回多指标（JSON格式）
2. 缓存机制：对于耗时操作添加本地缓存
3. 主动模式：超过500台主机建议使用主动模式
4. 监控项间隔：根据业务重要性分级设置

十、安全注意事项

1. 最小权限原则：Zabbix用户只赋予必要权限
2. 输入验证：所有脚本参数必须严格过滤
3. 敏感信息：使用宏变量存储密码等数据
4. 审计日志：记录所有自定义监控项变更

结语

通过灵活运用Zabbix自定义监控项功能，企业可以构建完全贴合业务需求的监控体系。建议从简单监控项开始，逐步扩展到自动发现和复杂预处理，同时注意建立完善的监控项命名规范和文档记录。当标准方法无法满足时，可考虑开发自定义模块或通过Zabbix API进行扩展。 “`

该文档包含完整的自定义监控项实现方案，涵盖： 1. 多种数据采集方式（Agent/SNMP/JMX/HTTP） 2. 详细配置示例和代码片段 3. 运维调试技巧 4. 性能与安全最佳实践 可根据实际需求调整具体参数和脚本内容。