Documentation

Zabbix 使用手册

2 什么是 Zabbix

3 Zabbix 功能

4 Zabbix 概述

5 Zabbix 7.0.0新功能

6 Zabbix 7.0.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 插件依赖

3 从源代码安装

在 macOS 上构建 Zabbix agent

在Windows上构建Zabbix agent

在Windows中构建Zabbix agent 2

3 安全设置 Zabbix 的最佳实践

1 访问控制

1 MySQL/MariaDB

2 PostgreSQL/TimescaleDB

3 Oracle

2 加密

3 Web 服务器

4 从二进制包安装

1 Red Hat 企业版 Linux

2 Debian/Ubuntu/Raspbian

3 SUSE Linux 企业服务器

4 从MSI安装Windows代理

5 从 PKG 安装 Mac OS Agent

6 不稳定版本

6 从容器中安装

7 Web界面安装

由二进制包升级

1 Red Hat 企业版 Linux

2 Debian/Ubuntu

1 从源码包升级

3 从容器中升级

1 编译问题

10 模板变更

11 升级说明 7.0.0

12 Upgrade notes for 7.0.1

5. 快速入门

1 登录和配置用户

3 新增监控项

4 新建触发器

5 接收问题通知

6. Zabbix Appliance

1 主机和主机组

1 配置主机

2 资产管理

3 批量更新

2 监控项

1 创建监控项

1 监控项键值的格式

2 自定义间隔

2 监控项值预处理

1 预处理测试

2 预处理细节

3 JSONPath 功能

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

3 预处理示例

4 JavaScript 预处理

2 浏览器项目 JavaScript 对象

其他 JavaScript 对象

5 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 简单检查

监控VMware的监控项键值

6 日志文件监控

7 可计算监控项

1 聚合计算

8 内部检查

9 SSH检查

10 Telnet检查

11 外部检查

12 采集器监控项

13 JMX监控

14 ODBC监控

15 从属监控项

16 HTTP 代理

17 Prometheus 数据处理

18 脚本监控项

19 Browser items

4 历史数据与趋势数据

5 用户自定义参数

1 扩展Zabbix Agents

7 Windows 性能计数器

8 批量更新

9 值映射

10 队列

11 值缓存

12 立刻检查

13 限制代理检查

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模板操作

网络设备的标准化模板

10 事件通知

1 媒介类型

1 电子邮箱

2 短信

3 自定义告警脚本

4 Webhook

Webhook 脚本范例

2 动作

1 条件

2 操作

1 发送消息

2 远程命令

3 附加操作

4 在消息中使用宏

3 恢复操作

4 更新操作

5 通知升级

3 接收不受支持的项目的通知

1 宏函数

2 用户宏

3 带语境的用户宏

4 秘密用户宏

5 低级别自动发现宏

5 表达式宏

12 用户和用户组

1 配置用户

2 权限

3 用户组

13 存储密钥

CyberArk configuration

HashiCorp configuration

14 定时报表

1 Export to files

2 Streaming to external systems

8. 服务监控

1 服务树

3 服务级别协议SLA

1 Web 监控项

10. 虚拟机监控

1 虚拟机自动发现相关键值字段

4 VMware monitoring setup example

JSON examples for VMware items

监控VMware的监控项键值

11 维护行为

12. 正则表达式

13 问题确认

14. 配置导出/导入

3 模板

4 主机

4 网络拓扑图

1 配置网络发现规则

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

3 低级别自动发现

1 监控项原型

2 触发器原型

3 图形原型

4 主机原型

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

5 自动发现规则

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 时钟

3 数据概览

4 自动发现状态

5 常用图表

6 常用拓扑图

7 仪表

8 地理地图

9 图表

10 图表（经典）

11 图形原型

12 蜂窝

13 主机可用性

14 主机导航器

15 项目历史记录

16 项目导航器

17 项目值

18 拓扑图

19 拓扑图导航树

20 饼图

21 问题主机

22 问题

23 问题严重程度

24 SLA 报告

25 系统信息

26 Top 主机

27 Top 触发器

28 触发器概述

29 网址

30 网络监控

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 Data collection

1 主机组

1 模板组

2 模板

1 监控项

2 触发器

3 图形

4 自动发现规则

1 监控项原型

2 触发器原型

3 图形原型

4 主机原型

5 Web 场景

3 主机

1 Items

2 触发器

3 图形

4 自动发现规则

1 Item prototypes

2 Trigger prototypes

3 Graph prototypes

4 主机原型

5 Web 场景

5 Maintenance

6 Event correlation

7 Discovery

7 Alerts

5 动作

7 媒介类型

8 脚本

8 Users

3 Users

4 API tokens

4 用户组

5 Authentication

1 HTTP

2 LDAP

3 SAML

4 MFA

5 用户角色

9 管理

1 常规

2 审计日志

3 管家

4 Proxy代理

5 Proxy组

6 宏

7 队列

1 全局通知

2 浏览器提示音

5 前端维护模式

7 定义

8 定制主题风格

10 Zabbix使用的cookie

11 时区

13 Resetting password

14 Time period selector

19. API

API信息

版本

LLD 规则

> LLD规则对象

创建

删除

复制

更新

获取

MFA

MFA 对象

mfa.创建

mfa.删除

mfa.更新

mfa.获取

Module

模块对象

模块.创建

模块.删除

模块.更新

模块.获取

Proxy

Proxy 对象

proxy.create

proxy.delete

proxy.get

proxy.update

Proxy组

Proxy组对象

proxygroup.create

proxygroup.delete

proxygroup.get

proxygroup.update

Script

Script object

script.getscriptsbyevents

script.getscriptsbyhosts

创建

删除

执行

更新

获取

Service

Service object

service.create

service.delete

service.get

service.update

Settings

Settings object

settings.get

settings.update

Web 场景

Web 场景对象

创建

删除

更新

获取

主机

主机对象

创建主机

删除主机

批量删除主机

批量更新主机

批量添加主机

更新主机

获取主机

主机原型

主机原型对象

hostprototype.create

hostprototype.delete

hostprototype.get

hostprototype.update

主机接口

主机接口对象

hostinterface.create

hostinterface.delete

hostinterface.get

hostinterface.massadd

hostinterface.massremove

hostinterface.replacehostinterfaces

hostinterface.update

主机组

主机组对象

hostgroup.create

hostgroup.delete

hostgroup.get

hostgroup.massadd

hostgroup.massremove

hostgroup.massupdate

hostgroup.propagate

hostgroup.update

事件

> 事件对象

确认

获取

令牌

令牌对象

创建

删除

更新

生成

获取

仪表盘

仪表盘对象

创建

删除

获取

更新

仪表盘组件字段

1 动作日志

2 时钟

3 数据概览

4 发现状态

5 常用图表

6 常用拓扑图

7 仪表盘(Gauge)

8 地理地图(Geomap)

9 图表

10 图表(经典)

11 图表原型

12 蜂窝图

13 主机可用性

14 主机导航器

15 监控项历史

16 监控项导航器

17 监控项值

18 拓扑图

19 拓扑图导航树

20 饼图

21 问题主机

22 问题

23 问题严重性

24 SLA报表

25 系统信息

26 TOP主机

27 TOP触发器

28 触发器概览

29 URL

30 Web监测

任务

任务对象

创建

获取

值映射

值映射对象

创建

删除

更新

获取

关联

> 关联对象

关联创建

关联删除

关联更新

关联获取

动作

动作对象

创建

删除

更新

获取

历史数据

历史数据对象

历史数据推送

查询历史数据

清理历史数据

发现检查

> 发现检查对象

获取

发现的主机

发现的主机对象

获取

发现规则

> 发现规则对象

创建

删除

更新

获取

告警

告警对象

获取

图像

图像对象

image.create

image.delete

image.get

image.update

图标映射

图标映射对象

iconmap.create

iconmap.delete

iconmap.get

iconmap.update

图表

> 图表对象

创建

删除

更新

获取

图表原型

图表原型对象

创建图表原型

删除图表原型

更新图表原型

查询图表原型

图表监控项

图表监控项对象

获取图表监控项

媒介类型

媒介类型对象

删除媒介

媒介类型创建

更新

获取媒介类型

审计日志

审计日志对象

获取

报表

报告对象

report.create

report.get

report.update

报告.删除

拓扑图

拓扑图对象

拓扑图创建

拓扑图删除

更新拓扑图

获取拓扑图

数据清理

数据清理对象

housekeeping.get

housekeeping.update

服务水平协议

SLA 对象

创建

删除

更新

获取

获取SLI

模板组

模板组对象

templategroup.create

templategroup.delete

templategroup.get

templategroup.massadd

templategroup.massremove

templategroup.massupdate

templategroup.propagate

templategroup.update

模版

模版对象

创建

删除

批量删除模板

批量更新模板

批量添加模板

更新

获取

模版仪表盘

> 模版仪表盘对象

创建模板仪表盘

删除模板仪表盘

更新模板仪表盘

检索模板仪表盘

正则表达式

正则表达式对象

regexp.create

regexp.delete

regexp.get

regexp.update

用户

> 用户对象

创建

删除

更新

查询

检查认证

注销

登录

解锁

配置

重置TOTP

用户宏

> 用户宏对象

创建

创建全局宏

删除

删除全局宏

更新

更新全局宏

查询

用户目录

> 用户目录对象

创建

删除

更新

查询

测试

用户组

> 用户组对象

创建

删除

更新

查询

监控项

监控项对象

item.create

删除

更新

获取

监控项原型

监控项原型对象

创建

删除

更新

获取

维护

维护模式对象

创建维护模式

删除维护模式

更新维护期设置

获取维护期

自动注册

自动注册对象

更新

获取

被发现的服务

> 被发现的服务对象

获取

角色

Role object

role.create

role.delete

role.get

role.update

触发器

> 触发器对象

创建触发器

删除触发器

更新触发器

检索触发器

触发器原型

> 触发器原型对象

triggerprototype.update

创建触发器原型

删除触发器原型

检索触发器原型

认证

认证对象

更新

获取

趋势

> 趋势对象

检索趋势

连接器

连接器对象

创建

删除

更新

获取

配置

对比导入

导入

导出

问题

问题对象

problem.get

高可用节点

高可用节点对象

HA 节点获取

附录 1. 参考说明

附录 2. 从 6.4 到 7.0 的变化

附录3. 7.0版本中的更改

1 可加载模块

2 插件

1 构建可加载插件

1 常见问题/疑难解答

2安装及配置

1 创建数据库

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

3 为数据库升级主键

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

4 安全的连接数据库

1 MySQL encryption configuration

2 PostgreSQL encryption configuration

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

14 Oracle 数据库设置

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+ plugin

3 Memcached 插件

4 Modbus 插件

5 MongoDB 插件

6 MQTT 插件

7 MSSQL plugin

7 MySQL plugin

8 Oracle 插件

9 PostgreSQL plugin

10 Redis 插件

11 Smart 插件

8 Zabbix Java网关

9 Zabbix web 服务

10 包含

4 协议

1 Server-proxy数据交换协议

2 Zabbix agent/agent2 协议

4 Zabbix agent 2插件协议

5 Zabbix sender协议

6 Header标头

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

5 监控项

2 参数vm.memory.size

3 被动和主动Agent检查

5 Minimum permission level for Windows agent items

5 返回值的编码

6 大文件支持

7 传感器

8 proc.mem 监控项中memtype参数类型的注意事项

9 在proc.mem和proc.num项目中选择进程的注意事项

10 net.tcp.service 和 net.udp.service 检查的实现细节

11 proc.get parameters

12 不可达/不可用主机设置

13 远程监控Zabbix状态

14 使用Zabbix配置Kerberos监控

15 modbus.get 参数

16 Return values for system.sw.packages.get

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

17 Return values for net.dns.get

6 支持的函数

1 聚合函数

1 Foreach 函数

2 按位运算函数

3 日期和时间函数

4 History functions

5 Mathematical functions

5 Trend functions

7 Prediction functions

8 String functions

函数详情

7 宏

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

Overview

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 使用主动检查监控网络流量

开发者中心

Modules

Module file structure

manifest.json

动作

Views

Assets

Register a new module

Widgets

Configuration

Presentation

Tutorials

Create a module (tutorial)

Create a widget (tutorial)

示例

插件

Examples

Build a plugin (tutorial)

Plugin interfaces

扩展开发的变化

Zabbix 手册页

zabbix_web_service

2022 Zabbix中国峰会

2022 Zabbix中国峰会

Table of Contents

扩展开发的变化

扩展开发的变化

此页面列出了开发自定义Zabbix扩展的所有变更内容。

从6.4到7.0的变更

模块

ZBXNEXT-8086

在manifest.json文件的widget参数中，对象键template_support已不再受支持。由于从Zabbix 7.0开始，模板仪表盘支持所有小部件，因此不再需要确定小部件是否应在模板仪表盘上可用。更多信息，请参见：模板仪表盘上扩展的小部件可用性。

ZBXNEXT-8683 创建了一个新的表单字段类 CWidgetFieldMultiSelectItemPattern。此类允许添加一个特别设计用于选择项目模式的多选字段，以便在仪表盘中使用。

7.0的变化