Documentation

Zabbix 使用手册

2 什么是 Zabbix

3 Zabbix 功能

4 Zabbix 概述

5 What's new in Zabbix 7.2.0

6 What's new in Zabbix 7.2.1

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

1 PostgreSQL 插件依赖

2 MongoDB 插件依赖

4 从源代码安装

在 macOS 上构建 Zabbix agent

在Windows上构建Zabbix agent

在Windows中构建Zabbix agent 2

5 从二进制包安装

1 Red Hat 企业版 Linux

2 Debian/Ubuntu/Raspbian

3 SUSE Linux 企业服务器

4 从MSI安装Windows agent

5 从 PKG 安装 Mac OS Agent

6 不稳定版本

6 从容器中安装

7 Web界面安装

1 从源码包升级

2 由二进制包升级

1 Red Hat 企业版 Linux

2 Debian/Ubuntu

3 从容器中升级

1 编译问题

10 Upgrade notes for 7.2.0

10 模板变更

11 Upgrade notes for 7.2.1

5. 快速入门

1 登录和配置用户

3 新增监控项

4 新建触发器

5 接收问题通知

6. Zabbix Appliance

1 主机和主机组

1 配置主机

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 链接/取消链接

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 电子邮箱

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 低级别自动发现的注意事项

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 监控项历史记录

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 Web 场景

4 主机

1 监控项

2 触发器

3 图形

4 自动发现规则

1 监控项原型

2 触发器原型

3 图形原型

4 主机原型

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

API信息

版本

LLD 规则

LLD规则对象

创建

删除

更新

获取

MFA

MFA 对象

创建

删除

更新

获取

Proxy

Proxy 对象

创建

删除

更新

获取

Proxy组

Proxy组对象

创建

删除

更新

获取

Web 场景

Web 场景对象

创建

删除

更新

获取

主机

主机对象

创建

删除

批量删除

批量更新

批量添加

更新

获取

主机原型

主机原型对象

创建

删除

更新

获取

主机接口

主机接口对象

创建

删除

批量删除

批量添加

更新

替换

获取

主机组

主机组对象

传播

创建

删除

批量删除

批量更新

批量添加

更新

获取

事件

事件对象

确认

获取

令牌

令牌对象

创建

删除

更新

生成

获取

仪表盘

仪表盘对象

创建

删除

获取

更新

仪表盘组件字段

1 动作日志

2 时钟

4 发现状态

5 常用图表

6 常用拓扑图

7 仪表盘(Gauge)

8 地理地图(Geomap)

9 图表

10 图表(经典)

11 图表原型

12 蜂窝图

13 Host card

13 主机可用性

14 主机导航器

15 监控项历史

16 监控项导航器

17 监控项值

18 拓扑图

19 拓扑图导航树

20 饼图

21 问题主机

22 问题

23 问题严重性

24 SLA报表

25 系统信息

26 Top主机

27 Top items

27 Top触发器

28 触发器概览

29 URL

30 Web监测

任务

任务对象

创建

获取

值映射

值映射对象

创建

删除

更新

获取

关联

关联对象

创建

删除

更新

获取

动作

动作对象

创建

删除

更新

获取

历史数据

历史数据对象

推送

清理

获取

发现检查

发现检查对象

获取

发现的主机

发现的主机对象

获取

发现的服务

发现的服务对象

获取

发现规则

发现规则对象

创建

删除

更新

获取

告警

告警对象

获取

图像

图像对象

创建

删除

更新

获取

图形原型

图形原型对象

创建

删除

更新

获取

图形监控项

图形监控项对象

获取

图标映射

图标映射对象

创建

删除

更新

获取

图表

图表对象

创建

删除

更新

获取

媒介类型

媒介类型对象

创建

删除

更新

获取

审计日志

审计日志对象

获取

报表

报告对象

创建

删除

更新

获取

拓扑图

拓扑图对象

创建

删除

更新

获取

数据清理

数据清理对象

更新

获取

服务

服务对象

创建

删除

更新

获取

服务水平协议

SLA 对象

创建

删除

更新

获取

获取SLI

模块

模块对象

创建

删除

更新

获取

模板组

模板组对象

传播

创建

删除

批量删除

批量更新

批量添加

更新

获取

模版

模版对象

创建

删除

批量删除

批量更新

批量添加

更新

获取

模版仪表盘

模版仪表盘对象

创建

删除

更新

获取

正则表达式

正则表达式对象

创建

删除

更新

获取

用户

用户对象

创建

删除

更新

检查认证

注销

登录

获取

解锁

配置

重置TOTP

用户宏

用户宏对象

创建

创建全局宏

删除

删除全局宏

更新

更新全局宏

获取

用户目录

用户目录对象

创建

删除

更新

测试

获取

用户组

用户组对象

创建

删除

更新

获取

监控项

监控项对象

创建

删除

更新

获取

监控项原型

监控项原型对象

创建

删除

更新

获取

维护

维护期对象

创建

删除

更新

获取

脚本

脚本对象

创建

删除

执行

更新

根据事件获取脚本

获取脚本

通过主机获取脚本

自动注册

自动注册对象

更新

获取

角色

角色对象

创建

删除

更新

获取

触发器

触发器对象

创建

删除

更新

获取

触发器原型

触发器原型对象

创建

删除

更新

获取

认证

认证对象

更新

获取

设置

设置对象

更新

获取

趋势

趋势对象

获取

连接器

连接器对象

创建

删除

更新

获取

配置

对比导入

导入

导出

问题

问题对象

获取

高可用节点

高可用节点对象

获取

附录 1. 参考说明

附录 2. 从 6.4 到 7.0 的变化

1 可加载模块

2 插件

1 构建可加载插件

2 安装及配置

1 创建数据库

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

3 为数据库升级主键

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

5 安全的连接数据库

1 MySQL加密配置

2 PostgreSQL加密配置

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 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 返回值

6 支持的函数

1 聚合函数

1 Foreach 函数

2 按位运算函数

3 日期和时间函数

4 历史函数

5 趋势函数

6 数学函数

7 运算符函数

8 预测函数

9 字符串函数

7 宏

1 支持的宏

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

9 时间段语法

10 命令执行

11 版本兼容性

12 数据库错误处理

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

开发者中心

模块

模块文件结构

manifest.json

动作

视图

资源

注册新模块

小部件

配置

演示

教程

创建模块（教程）

创建小部件（教程）

示例

插件

示例

创建插件（教程）

扩展开发的变化

Zabbix 手册页

zabbix_web_service

Table of Contents

12 数据库错误处理
- MySQL

12 数据库错误处理

如果 Zabbix 检测到后端数据库不可访问，它将发送一条通知消息并继续尝试连接到数据库。对于某些数据库引擎，可以识别特定的错误代码。

MySQL

CR_CONN_HOST_ERROR
CR_SERVER_GONE_ERROR
CR_CONNECTION_ERROR
CR_SERVER_LOST
CR_UNKNOWN_HOST
ER_SERVER_SHUTDOWN
ER_ACCESS_DENIED_ERROR
ER_ILLEGAL_GRANT_FOR_TABLE
ER_TABLEACCESS_DENIED_ERROR
ER_UNKNOWN_ERROR