zabbix如何自定义监控项

发布时间：2022-02-19 11:07:20 作者：小新
来源：亿速云阅读：194

# 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]"

九、性能优化建议

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

十、安全注意事项

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

结语

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

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