插件为扩展Zabbix监控能力提供了选项。 插件采用Go编程语言编写,仅由Zabbix agent 2支持。 插件为扩展Zabbix功能提供了替代loadable modules(C语言编写)和other methods的方案。
以下特性为agent 2及其插件所特有:
自Zabbix 6.0起,插件无需直接集成到agent 2中,可作为可加载插件添加,从而简化了用于收集新监控指标的附加插件的创建过程。
本页面列出了Zabbix原生及可加载插件,并从用户角度描述了插件配置原则。
关于编写自定义插件的指导,请参阅Developer center和Example plugin for Zabbix agent 2。
有关Zabbix agent 2与可加载插件间的通信流程及指标收集过程的详细信息,请参见连接图。
本节提供插件配置的通用原则与最佳实践。
所有插件均通过Plugins.*参数进行配置,这些参数可以是Zabbix agent 2configuration file的组成部分,也可以是插件自身的configuration file。 若插件使用独立的file配置文件,则应在Zabbix agent 2的file配置文件中通过Include参数指定该文件路径。
典型插件参数结构如下:
Plugins.<插件名称>.<参数>=<值>
此外还存在两类特殊参数组:
所有参数命名需符合以下要求:
例如,若需在agent重启后立即执行没有Schedulingupdate interval的被动与主动检查(仅针对Uptime插件),请在configuration file中设置Plugins.Uptime.System.ForceActiveChecksOnStart=1
。 同理,要为CPU插件设置检查并发性的自定义限制,请在configuration file中配置Plugins.CPU.System.Capacity=N
。
您可以在配置file中设置连接相关参数(URI、用户名、密码等)的默认值,格式如下:
例如 Plugins.Mysql.Default.Username=zabbix
、Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017
等。
如果在监控项键或命名会话参数中未提供此类参数的值,插件将使用默认值。 如果默认参数也未定义,则将使用硬编码的默认值。
如果监控项键没有任何参数,Zabbix agent 2将尝试使用默认参数部分定义的值来收集指标。
命名会话代表插件参数的附加层级,可用于为每个被监控实例指定独立的认证参数集。 每个命名会话参数应具有以下结构:
会话名称可作为connString 监控项键参数使用,无需单独指定URI、用户名和/或密码。
在监控项键中,第一个参数可以是connString或URI。 如果第一个键参数不匹配任何会话名称,它将被视为URI处理。 请注意监控项键不支持传递嵌入式URI凭证,应改用命名会话参数。
可用named session parameters列表取决于具体插件。
可通过在监控项键参数中指定新值来覆盖会话参数(参见示例)。
如果命名会话中未定义某个参数,Zabbix agent 2将使用默认插件参数中定义的值。
Zabbix agent 2插件按以下顺序查找与连接相关的参数值:
监控两个实例“MySQL1”和“MySQL2”。
配置参数:
Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306
Plugins.Mysql.Sessions.MySQL1.User=mysql1_user
Plugins.Mysql.Sessions.MySQL1.Password=unique_password
Plugins.Mysql.Sessions.MySQL2.Uri=tcp://192.0.2.0:3306
Plugins.Mysql.Sessions.MySQL2.User=mysql2_user
Plugins.Mysql.Sessions.MySQL2.Password=different_password
此配置的结果是,每个会话名称都可以用作item key中的connString,例如,mysql.ping[MySQL1]
或 mysql.ping[MySQL2]
。
在监控项键中提供部分参数.
配置参数:
Plugins.PostgreSQL.Sessions.Session1.Uri=tcp://192.0.2.234:5432
Plugins.PostgreSQL.Sessions.Session1.User=old_username
Plugins.PostgreSQL.Sessions.Session1.Password=session_password
Item key: pgsql.ping[session1,new_username,,postgres]
此配置的结果是,agent将使用以下参数连接到PostgreSQL:
192.0.2.234:5432
new_username
session_password
postgres
使用默认配置参数收集指标.
配置参数:
Plugins.PostgreSQL.Default.Uri=tcp://192.0.2.234:5432
Plugins.PostgreSQL.Default.User=zabbix
Plugins.PostgreSQL.Default.Password=password
Item key: pgsql.ping[,,,postgres]
此配置的结果是,agent将使用以下参数连接到PostgreSQL:
192.0.2.234:5432
zabbix
password
postgres
部分插件支持同时从多个实例采集指标。 可同时监控本地和远程实例。 支持TCP和Unix套接字连接。
建议配置插件保持与实例的连接处于开启状态。 优势在于通过减少连接数来降低网络拥塞、延迟以及CPU和memory的使用率。 客户端库会处理这一机制。
未使用连接保持开启状态的时长可通过Plugins.<PluginName>.KeepAlive参数设定。 例如:Plugins.Memcached.KeepAlive
所有 Zabbix agent 2 支持的指标均由插件收集。
以下插件可开箱即用于Zabbix agent 2. 点击插件名称可跳转至包含更多信息的插件仓库.
插件名称 | 描述 | Supported item keys | 备注 |
---|---|---|---|
Agent | 被使用的Zabbix agent指标. | agent.hostname, agent.ping, agent.version | 支持的键具有与Zabbix agent keys相同的参数. |
Ceph | Ceph监控. | ceph.df.details, ceph.osd.stats, ceph.osd.discovery, ceph.osd.dump, ceph.ping, ceph.pool.discovery, ceph.status |
|
CPU | 系统CPU监控(CPU数量/CPU核心数,发现的CPU,利用率百分比). | system.cpu.discovery, system.cpu.num, system.cpu.util | 支持的键具有与Zabbix agent keys相同的参数. |
Docker | Docker容器监控. | docker.container_info, docker.container_stats, docker.containers, docker.containers.discovery, docker.data_usage, docker.images, docker.images.discovery, docker.info, docker.ping |
另见: Configuration parameters |
File | 文件指标收集. | vfs.file.cksum, vfs.file.contents, vfs.file.exists, vfs.file.md5sum, vfs.file.regexp, vfs.file.regmatch, vfs.file.size, vfs.file.time |
支持的键具有与Zabbix agent keys相同的参数. |
Kernel | 内核监控. | kernel.maxfiles, kernel.maxproc | 支持的键具有与Zabbix agent keys相同的参数. |
Log | 日志file监控. | log, log.count, logrt, logrt.count | 支持的键具有与Zabbix agent keys相同的参数. 另见: 插件配置参数(Unix/Windows) |
Memcached | Memcached服务器监控. | memcached.ping, memcached.stats | |
Modbus | 读取Modbus数据. | modbus.get | 支持的键具有与Zabbix agent keys相同的参数. |
MQTT | 接收MQTT主题的发布值. | mqtt.get | 要配置到MQTT代理的加密连接,请在agent配置file中将TLS参数指定为命名会话或默认参数.目前,TLS参数不能作为监控项键参数传递. |
MySQL | MySQL及其分支的监控. | mysql.custom.query, mysql.db.discovery, mysql.db.size, mysql.get_status_variables, mysql.ping, mysql.replication.discovery, mysql.replication.get_slave_status, mysql.version |
要配置到数据库的加密连接,请在agent配置file中将TLS参数指定为命名会话或默认参数.目前,TLS参数不能作为监控项键参数传递. |
NetIf | 网络接口监控. | net.if.collisions, net.if.discovery, net.if.in, net.if.out, net.if.total | 支持的键具有与Zabbix agent keys相同的参数. |
Oracle | Oracle数据库监控. | oracle.diskgroups.stats, oracle.diskgroups.discovery, oracle.archive.info, oracle.archive.discovery, oracle.cdb.info, oracle.custom.query, oracle.datafiles.stats, oracle.db.discovery, oracle.fra.stats, oracle.instance.info, oracle.pdb.info, oracle.pdb.discovery, oracle.pga.stats, oracle.ping, oracle.proc.stats, oracle.redolog.info, oracle.sga.stats, oracle.sessions.stats, oracle.sys.metrics, oracle.sys.params, oracle.ts.stats, oracle.ts.discovery, oracle.user.info, oracle.version |
使用插件前请安装Oracle Instant Client. |
Proc | 进程CPU利用率百分比. | proc.cpu.util | 支持的键具有与Zabbix agent key相同的参数. |
Redis | Redis服务器监控. | redis.config, redis.info, redis.ping, redis.slowlog.count | |
Smart | S.M.A.R.T.监控. | smart.attribute.discovery, smart.disk.discovery, smart.disk.get | smartctl version的最低要求版本为7.1. 执行Zabbix agent 2的用户需要sudo/root访问权限才能使用smartctl.插件仅使用以下命令: /usr/sbin/smartctl -a * /usr/sbin/smartctl --scan * /usr/sbin/smartctl -j -V 支持的keys只能在Linux/Windows上与Zabbix agent 2一起使用,既可作为被动检查也可作为主动检查. 另见: Configuration parameters |
SW | 已安装软件包列表. | system.sw.packages, system.sw.packages.get | 支持的键具有与Zabbix agent key相同的参数. |
Swap | 交换空间大小(字节/百分比). | system.swap.size | 支持的键具有与Zabbix agent key相同的参数. |
SystemRun | 运行指定命令. | system.run | 支持的键具有与Zabbix agent key相同的参数. 另见: 插件配置参数(Unix/Windows) |
Systemd | systemd服务监控. | systemd.unit.discovery, systemd.unit.get, systemd.unit.info | |
TCP | TCP连接可用性检查. | net.tcp.port | 支持的键具有与Zabbix agent key相同的参数. |
UDP | UDP服务可用性和性能监控. | net.udp.service, net.udp.service.perf | 支持的键具有与Zabbix agent keys相同的参数. |
Uname | 系统信息检索. | system.hostname, system.sw.arch, system.uname | 支持的键具有与Zabbix agent keys相同的参数. |
Uptime | 系统运行时间指标收集. | system.uptime | 支持的键具有与Zabbix agent key相同的参数. |
VFSDev | VFS指标收集. | vfs.dev.discovery, vfs.dev.read, vfs.dev.write | 支持的键具有与Zabbix agent keys相同的参数. |
WebCertificate | TLS/SSL网站证书监控. | web.certificate.get | |
WebPage | 网页监控. | web.page.get, web.page.perf, web.page.regexp | 支持的键具有与Zabbix agent keys相同的参数. |
ZabbixAsync | 异步指标收集. | net.tcp.listen, net.udp.listen, sensor, system.boottime, system.cpu.intr, system.cpu.load, system.cpu.switches, system.hw.cpu, system.hw.macaddr, system.localtime, system.sw.os, system.swap.in, system.swap.out, vfs.fs.discovery |
支持的键具有与Zabbix agent keys相同的参数. |
ZabbixStats | Zabbix server/proxy内部指标或队列中延迟监控项的数量. | zabbix.stats | 支持的键具有与Zabbix agent keys相同的参数. |
ZabbixSync | 同步指标收集. | net.dns, net.dns.record, net.tcp.service, net.tcp.service.perf, proc.mem, proc.num, system.hw.chassis, system.hw.devices, system.sw.packages, system.users.num, vfs.dir.count, vfs.dir.size, vfs.fs.get, vfs.fs.inode, vfs.fs.size, vm.memory.size. |
支持的键具有与Zabbix agent keys相同的参数. |
Zabbix agent 2的可加载插件不随系统预装,需单独安装:
点击插件名称可跳转至包含更多信息的插件仓库。
插件名称 | 描述 | 支持的监控项键值 | 备注 |
---|---|---|---|
Ember+ | Ember+监控 | ember.get | 目前仅支持从源码构建(适用于Unix和Windows) 另见参数 |
MongoDB | MongoDB服务器及集群监控(基于文档的分布式数据库) | mongodb.collection.stats, mongodb.collections.discovery, mongodb.collections.usage, mongodb.connpool.stats, mongodb.db.stats, mongodb.db.discovery, mongodb.jumbo_chunks.count, mongodb.oplog.stats, mongodb.ping, mongodb.rs.config, mongodb.rs.status, mongodb.server.status, mongodb.sh.discovery, mongodb.version |
配置数据库加密连接时,需在agent配置file中以命名会话参数形式指定TLS参数 当前不支持通过监控项键值参数传递TLS参数 另见参数 |
MSSQL | MSSQL数据库监控 | mssql.availability.group.get, mssql.custom.query, mssql.db.get, mssql.job.status.get, mssql.last.backup.get, mssql.local.db.get, mssql.mirroring.get, mssql.nonlocal.db.get, mssql.perfcounter.get, mssql.ping, mssql.quorum.get, mssql.quorum.member.get, mssql.replica.get, mssql.version | 配置数据库加密连接时,需在agent配置file中以命名会话或默认值参数形式指定TLS参数 当前不支持通过监控项键值参数传递TLS参数 另见参数 |
PostgreSQL | PostgreSQL及其分支监控 | pgsql.autovacuum.count, pgsql.archive, pgsql.bgwriter, pgsql.cache.hit, pgsql.connections, pgsql.custom.query, pgsql.dbstat, pgsql.dbstat.sum, pgsql.db.age, pgsql.db.bloating_tables, pgsql.db.discovery, pgsql.db.size, pgsql.locks, pgsql.oldest.xid, pgsql.ping, pgsql.queries, pgsql.replication.count, pgsql.replication.process, pgsql.replication.process.discovery, pgsql.replication.recovery_role, pgsql.replication.status, pgsql.replication_lag.b, pgsql.replication_lag.sec, pgsql.uptime, pgsql.version, pgsql.wal.stat |
配置数据库加密连接时,需在agent配置file中以命名会话或默认值参数形式指定TLS参数 当前不支持通过监控项键值参数传递TLS参数 另见参数 |
可加载插件运行时:
- -V --version
- 打印插件version及许可证信息
- -h --help
- 打印帮助信息