Documentation

Zabbix 使用手册

2 什么是 Zabbix

3 Zabbix 功能

4 Zabbix 概述

5 What's new in Zabbix 7.4.0

6 What's new in Zabbix 7.4.x

3. Zabbix 进程

1 Server

1 高可用

2 Agent

3 Agent 2

4 Proxy

1 使用源码安装

2 从 RHEL 包安装

3 从 Debian/Ubuntu 包安装

6 Sender

7 Get

8 JS

1. 获取 Zabbix

4 从源代码安装

在 macOS 上构建 Zabbix agent

在Windows上构建Zabbix agent

在Windows中构建Zabbix agent 2

5 从二进制包安装

4 从MSI安装Windows agent

5 从 PKG 安装 Mac OS Agent

6 不稳定版本

6 从容器中安装

7 Web界面安装

1 从源码包升级

2 由二进制包升级

1 Red Hat 企业版 Linux

2 Debian/Ubuntu

3 从容器中升级

1 编译问题

2 Escaping-related upgrade issues

10 Upgrade notes for 7.4.0

10 模板变更

11 Upgrade notes for 7.4.x

5. 快速入门

1 登录和配置用户

3 新增监控项

4 新建触发器

5 接收问题通知

6. Zabbix Appliance

1 主机和主机组

1 Host Wizard

1 配置主机

2 Configuring a host group

2 资产管理

3 批量更新

2 监控项

1 创建监控项

1 监控项键值的格式

2 自定义时间间隔

2 监控项值预处理

1 预处理测试

2 预处理细节

3 预处理示例

4 JSONPath 功能

1 从JSONPath 中的 LLD 宏值中转义特殊字符

5 JavaScript 预处理

1 其他 JavaScript 对象

2 浏览器项目 JavaScript 对象

6 CSV 转换成 JSON 预处理

3 监控项类型

1 Zabbix agent

1 Zabbix agent 2

2 Windows Zabbix agent

2 SNMP代理

1 动态索引

2 特殊 OIDs

3 MIB文件

3 SNMP 陷阱

4 IPMI 检查

5 简单检查

1 监控VMware的监控项键值

6 日志文件监控

7 可计算监控项

1 聚合计算

8 内部检查

9 SSH检查

10 Telnet检查

11 外部检查

12 采集器监控项

13 JMX监控

14 ODBC监控

15 依赖监控项

16 HTTP 代理

17 Prometheus 数据处理

18 脚本监控项

19 Browser监控项

4 历史数据与趋势数据

5 用户自定义参数

1 扩展Zabbix Agents

6 Windows 性能计数器

7 批量更新

8 值映射

9 队列

10 值缓存

11 立刻检查

12 限制agent检查

3 触发器

1 配置一个触发器

2 触发器表达式

3 触发器依赖关系

4 触发器严重性

5 自定义触发器严重性

6 批量更新

7 触发器预测函数

4 事件

1 触发器事件生成

2 其他事件来源

3 问题的手动关闭

1 触发器事件关联

2 全局事件关联

6 标签化

7 可视化

1 图形

1 简单的图形

2 自定义图形

3 Ad-hoc图形

4 聚合图形

2 网络拓扑图

1 配置网络拓扑图

2 主机组元素

3 链接指标

3 仪表板

8 模板及模板组

1 配置模板

2 Configuring a template group

2 链接/取消链接

3 嵌套

4 批量更新

9 开箱即用的模板

1 Zabbix agent模板操作

2 Zabbix agent 2 模板操作

3 HTTP template operation

4 IPMI模板操作

5 JMX模板操作

6 ODBC模板操作

7 网络设备的标准化模板

8 VMware template operation

10 事件通知

1 媒介类型

1 电子邮箱

1 Automated Gmail/Office365 media types

2 短信

3 自定义告警脚本

4 Webhook

1 Webhook 脚本范例

2 动作

1 条件

2 操作

1 发送消息

2 远程命令

3 附加操作

4 在消息中使用宏

3 恢复操作

4 更新操作

5 通知升级

3 接收不受支持的监控项的通知

1 宏函数

2 用户宏

3 上下文用户宏

4 加密用户宏

5 低级别自动发现宏

6 表达式宏

12 用户和用户组

1 配置用户

2 权限

3 用户组

13 存储密钥

1 CyberArk配置

2 HashiCorp配置

14 定时报表

15 数据导出

1 导出到文件

2 流式传输到外部系统

3 SNMP 网关

8. 服务监控

2 服务级别协议SLA

1 Web 监控项

10. 虚拟机监控

1 VMware监控项键值

2 虚拟机发现规则键值字段

3 VMware监控项的JSON示例

4 VMware监控配置示例

12. 正则表达式

13 问题确认

14. 配置导入导出

1 模板组

3 模板

4 主机

5 网络拓扑图

1 配置网络发现规则

2 agent（主动模式）自动注册

3 低级别自动发现

1 监控项原型

2 触发器原型

3 图形原型

4 主机原型

5 Discovery prototypes

5 低级别自动发现的注意事项

6 自动发现规则

1 自动发现已挂载的文件系统

2 自动发现网络接口

3 自动发现CPU和CPU核心

4 自动发现SNMP OIDs

5 自动发现 SNMP OIDs (旧版)

6 自动发现JMX对象

7 自动发现IPMI传感器

8 自动发现系统服务

9 自动发现Windows服务

10 自动发现Windows性能计数器实例

11 利用WMI查询执行自动发现

12 利用ODBC SQL查询执行自动发现

13 利用Prometheus数据执行自动发现

14 自动发现块设备

15 自动发现Zabbix主机接口

7 自定义 LLD 规则

16. 分布式监控

1 监控配置同步

2 Proxy 负载均衡和高可用

2 使用预共享秘钥

1 连接类型或权限问题

2 证书问题

3 PSK 问题

1 菜单

1 事件菜单

2 主机菜单

3 监控项菜单

1 仪表板

仪表盘组件

1 操作日志

2 时钟

4 自动发现状态

5 常用图表

6 常用拓扑图

7 仪表

8 地理地图

9 图表

10 图表（经典）

11 图形原型

12 蜂窝

13 Host card

13 主机可用性

14 主机导航器

15 Item card

15 监控项历史记录

16 监控项导航器

17 监控项值

18 拓扑图

19 拓扑图导航树

20 饼图

21 问题主机

22 问题

23 问题严重性

24 SLA 报表

25 系统信息

26 Top 主机

27 Top items

27 Top 触发器

28 触发器概述

29 网址

30 Web 监控

2. 监测

1 问题

1 根因和症状问题

2 主机

1 图表

2 主机仪表盘

3 Web场景

3 最新数据

4 拓扑图

5 自动发现

3 服务

1 服务

2 SLA

3 SLA 报表

4 资产

1 概述

2 主机

5 报表

1 系统信息

2 计划报表

3 可用性报表

4 触发器前100

5 审计日志

6 动作日志

7 通知

6 数据收集

1 模板组

2 主机组

3 模板

1 监控项

2 触发器

3 图形

4 自动发现规则

1 监控项原型

2 触发器原型

3 图形原型

4 主机原型

5 Discovery prototypes

5 Web 场景

4 主机

1 监控项

2 触发器

3 图形

4 自动发现规则

1 监控项原型

2 触发器原型

3 图形原型

4 主机原型

5 Discovery prototypes

5 Web 场景

5 维护

6 事件关联

7 自动发现

7 告警

1 动作

2 媒介类型

3 脚本

8 用户

1 用户组

2 用户角色

3 用户

4 API 令牌

5 认证

1 HTTP

2 LDAP

3 SAML

4 MFA

9 管理

1 常规

2 审计日志

3 管家

4 Proxy代理

5 Proxy组

6 宏

7 队列

1 全局通知

2 浏览器提示音

5 前端维护模式

7 定义

8 定制主题风格

10 Zabbix使用的cookie

11 时区

12 重置密码

13 时间段选择器

19 Best practices

1 Security best practices

1 Access control

1 Securing MySQL/MariaDB

2 Securing PostgreSQL/TimescaleDB

2 Cryptography

3 Web server

2 Configuration best practices

19. API

info

apiinfo.version

LLD规则

LLD规则 object

discoveryrule.create

discoveryrule.delete

discoveryrule.get

discoveryrule.update

LLD规则原型

LLD规则原型 object

发现规则原型.create

发现规则原型.delete

发现规则原型.get

发现规则原型.update

MFA

多因素认证 object

mfa.create

mfa.delete

mfa.get

mfa.update

Proxy

Proxy object

proxy.create

proxy.delete

proxy.get

proxy.update

proxy 组

proxy 组 object

proxygroup.create

proxygroup.delete

proxygroup.get

proxygroup.update

Web场景

Web场景 object

httptest.create

httptest.delete

httptest.get

httptest.update

主机

主机 object

host.create

host.delete

host.get

host.massadd

host.massremove

host.massupdate

host.update

主机原型

主机原型 object

hostprototype.create

hostprototype.delete

hostprototype.get

hostprototype.update

主机接口

主机接口 object

hostinterface.create

hostinterface.delete

hostinterface.get

hostinterface.massadd

hostinterface.massremove

hostinterface.replacehostinterfaces

hostinterface.update

主机组

主机组 object

hostgroup.create

hostgroup.delete

hostgroup.get

hostgroup.massadd

hostgroup.massremove

hostgroup.massupdate

hostgroup.propagate

hostgroup.update

事件

事件 object

event.acknowledge

event.get

令牌

令牌对象

创建

删除

更新

生成

获取

仪表盘

仪表板 object

dashboard.create

dashboard.delete

dashboard.get

dashboard.update

仪表板小部件字段

1 操作日志

2 时钟

3 发现状态

4 常用图形

5 常用地图

6 仪表盘

7 地理地图

8 图形

9 图形（经典）

10 图形原型

11 蜂窝图

12 主机可用性

13 主机卡片

14 主机导航器

15 监控项卡片

16 监控项历史

17 监控项导航器

18 监控项值

19 地图

20 地图导航树

21 饼图

22 问题主机

23 问题

24 按严重程度分类的问题

25 SLA报告

26 系统信息

27 Top 主机

28 Top 监控项

29 Top 触发器

30 触发器概览

31 URL

32 Web监控

任务

任务对象

task.create

task.get

值映射

值映射对象

创建

删除

更新

获取

关联

相关性 object

correlation.create

correlation.delete

correlation.get

correlation.update

动作

动作 object

action.create

action.delete

action.get

action.update

历史数据

历史 object

history.clear

history.get

历史记录.推送

发现检查

发现检查 object

dcheck.get

发现规则

发现规则 object

drule.create

drule.delete

drule.get

drule.update

告警

告警 object

alert.get

图像

图像 object

image.create

image.delete

image.get

image.update

图标映射

图标映射 object

iconmap.create

iconmap.delete

iconmap.get

iconmap.update

图表

图表 object

graph.create

graph.delete

graph.get

graph.update

图表原型

图原型 object

graphprototype.create

graphprototype.delete

graphprototype.get

graphprototype.update

图表监控项

图表监控项 object

graphitem.get

地图

映射 object

map.create

map.delete

map.get

map.update

媒介类型

媒介类型 object

mediatype.create

mediatype.delete

mediatype.get

mediatype.update

审计日志

审计日志 object

auditlog.get

已发现主机

已发现主机 object

dhost.get

已发现服务

发现的服务 object

dservice.get

报告

报告 object

report.create

report.delete

report.get

report.update

数据清理

Housekeeping object

housekeeping.get

housekeeping.update

服务

服务 object

service.create

service.delete

service.get

service.update

服务等级协议

SLA object

sla.create

sla.delete

sla.get

sla.getsli

sla.update

模块

模块 object

module.delete

module.get

module.update

模块创建

模板组

模板组对象

传播

创建

删除

批量删除

批量更新

批量添加

更新

获取

模版

模版对象

创建

删除

批量删除

批量更新

批量添加

更新

获取

模版仪表盘

模版仪表盘对象

创建

删除

更新

获取

正则表达式

正则表达式 object

regexp.create

regexp.delete

regexp.get

regexp.update

用户

用户对象

创建

删除

更新

检查认证

注销

登录

获取

解锁

配置

重置TOTP

用户宏

用户宏对象

创建

创建全局宏

删除

删除全局宏

更新

更新全局宏

获取

用户目录

用户目录对象

创建

删除

更新

测试

获取

用户组

用户组对象

创建

删除

更新

获取

监控项

监控项 object

item.create

item.delete

item.get

item.update

监控项原型

监控项原型 object

itemprototype.create

itemprototype.delete

itemprototype.get

itemprototype.update

维护

维护 object

maintenance.create

maintenance.delete

maintenance.get

maintenance.update

脚本

脚本 object

script.create

script.delete

script.execute

script.get

script.getscriptsbyevents

script.getscriptsbyhosts

script.update

自动注册

自动注册 object

autoregistration.get

autoregistration.update

角色

角色 object

role.create

role.delete

role.get

role.update

触发器

触发器对象

创建

删除

更新

获取

触发器原型

触发器原型对象

创建

删除

更新

获取

认证

认证 object

authentication.get

authentication.update

设置

设置 object

settings.get

settings.update

趋势

趋势对象

获取

连接器

连接器 object

connector.create

connector.update

连接器删除

连接器获取

配置

configuration.export

configuration.import

configuration.importcompare

问题

问题 object

problem.get

高可用节点

高可用性节点 object

hanode.get

附录 1. 参考说明

附录2. 从7.2到7.4的变更

附录3. 7.4版本变更内容

1 可加载模块

2 插件

1 构建可加载插件

2 安装及配置

1 创建数据库

2 修复Zabbix 数据库的字符集及字符序

3 为数据库升级主键

4 准备用于分区的审计日志表

5 安全的连接数据库

1 MySQL加密配置

2 PostgreSQL加密配置

6 Secure connection to the frontend

6 TimescaleDB 配置

7 Elasticsearch 配置

8 Zabbix在Nginx特定发行版安装时的注意事项

9 以 root 用户身份运行agent

10 在Microsoft Windows上运行 Zabbix agent

11 使用Microsoft Azure AD设置SAML

12 使用 Okta 设置 SAML

13 使用 OneLogin 设置 SAML

15 设置定时报表

16 其他前端语言

1 Zabbix server

2 Zabbix proxy

3 Zabbix agent (UNIX)

4 Zabbix agent 2 (UNIX)

5 Zabbix agent （Windows）

6 Zabbix agent 2（Windows）

7 Zabbix agent 2 插件

1 Ceph 插件

2 Docker 插件

3 Ember+ 插件

4 Memcached 插件

5 Modbus 插件

6 MongoDB 插件

7 MQTT 插件

8 MSSQL 插件

9 MySQL 插件

10 NVIDIA GPU plugin

10 Oracle 插件

11 PostgreSQL 插件

12 Redis 插件

13 Smart 插件

8 Zabbix Java网关

9 Zabbix web 服务

10 Environment variables

10 包含

4 协议

1 Server-proxy 数据交换协议

2 Zabbix agent/agent2 协议

4 Zabbix agent 2 插件协议

5 Zabbix sender 协议

6 Header 标头

7 以换行符分隔的 JSON 导出协议

5 监控项

1 vm.memory.size 参数

2 被动和主动 Agent 检查

3 Windows agent 监控项的最低权限级别

4 返回值的编码

5 大文件支持

6 传感器

7 proc.mem 监控项中内存参数类型

8 在 proc.mem 和 proc.num items 监控项中选择进程

9 net.tcp.service 和 net.udp.service 检查

10 proc.get 参数

11 不可达/不可用主机接口设置

12 远程监控 Zabbix 状态

13 使用 Zabbix 配置 Kerberos 监控

14 modbus.get 参数

15 为 VMware 创建自定义性能计数器名称

16 system.sw.packages.get返回值

17 net.dns.get 返回值

18 Notes on system.cpu.util items on Windows

6 支持的函数

1 聚合函数

1 Foreach 函数

2 按位运算函数

3 日期和时间函数

4 历史函数

5 趋势函数

6 数学函数

7 运算符函数

8 预测函数

9 字符串函数

7 宏

1 支持的宏

2 支持用户自定义宏的位置

9 时间段语法

10 命令执行

11 版本兼容性

13 适用于Windows的 Zabbix sender 动态链接库

14 Zabbix API 的 Python 库

15 服务监控升级

16 其他问题

17 Agent 和 Agent 2 对比

18 转义示例

22. 快速参考指南

1 使用 Zabbix agent 监控Linux

2 使用 Zabbix agent 监控 Windows

3 通过HTTP监控Apache

4 使用 Zabbix agent 2 监控MySQL

5 使用Zabbix监控VMware

6 使用Zabbix监控网络流量

7 使用主动检查监控网络流量

8 Monitor websites with Browser items

9 Monitor website certificates with Zabbix agent 2 (passive)

10 Monitor a network switch or router with Zabbix

11 Monitor Windows event log using active checks

1 Deploy Zabbix with Zabbix Cloud

2 Node configuration

4 Key differences between Zabbix Cloud and on-premises

开发者中心

模块

模块文件结构

manifest.json

动作

视图

资产

注册新模块

小部件

配置

展示

教程

创建一个模块（教程）

创建一个 widget (tutorial)

示例

插件

示例

创建插件（教程）

扩展开发的变更

Zabbix 手册页

zabbix_web_service

Table of Contents

插件接口

插件接口

本节介绍可用的插件接口。

插件导出器

Exporter 是最简单的接口，用于执行轮询并返回一个值（多个值）、无结果或错误。它接受预解析的监控项键、参数和上下文。访问所有其他插件接口是独占的，如果插件已在执行任务，则无法调用任何方法。此外，每个插件的并发 Export() 调用上限为100次，可根据每个插件的需求进一步降低。

插件配置器

Configurator 接口从 Zabbix agent 2 配置文件提供插件配置参数。

插件运行器

Runner 接口提供了在插件启动（激活）时执行初始化以及在插件停止（停用）时执行反初始化的方法。例如，插件可以通过实现 Runner 接口来启动/停止某些后台 goroutine。