Zabbix 使用手册

2 什么是 Zabbix

3 Zabbix 功能

4 Zabbix 概述

5 What's new in Zabbix 6.4.0

6 What's new in Zabbix 6.4.1

6 What's new in Zabbix 6.4.4

7 What's new in Zabbix 6.4.2

8 What's new in Zabbix 6.4.3

10 What's new in Zabbix 6.4.5

12 What's new in Zabbix 6.4.6

12 What's new in Zabbix 6.4.7

13 What's new in Zabbix 6.4.8

14 What's new in Zabbix 6.4.9

15 What's new in Zabbix 6.4.10

16 What's new in Zabbix 6.4.11

17 What's new in Zabbix 6.4.12

18 What's new in Zabbix 6.4.13

19 What's new in Zabbix 6.4.14

20 What's new in Zabbix 6.4.15

21 What's new in Zabbix 6.4.16

22 What's new in Zabbix 6.4.17

23 What's new in Zabbix 6.4.18

24 What's new in Zabbix 6.4.19

25 What's new in Zabbix 6.4.20

26 What's new in Zabbix 6.4.21

3. Zabbix 进程

1 Server

1 高可用

2 Agent

3 Agent 2

4 Proxy

1 使用源码安装

2 Setup from RHEL packages

3 从 Debian/Ubuntu 包安装

6 Sender

7 Get

8 JS

1 获取 Zabbix

插件

1 PostgreSQL 插件依赖

2 MongoDB 插件依赖

安全设置 Zabbix 的最佳实践

3 从源代码安装

在 macOS 上构建 Zabbix agent

在Windows上构建Zabbix agent

在Windows中构建Zabbix agent 2

4 从二进制包安装

1 Red Hat 企业版 Linux

2 Debian/Ubuntu/Raspbian

3 SUSE Linux 企业服务器

4 从MSI安装Windows代理

5 从 PKG 安装 Mac OS Agent

6 不稳定版本

5 从容器中安装

6 Web界面安装

由二进制包升级

1 Red Hat 企业版 Linux

2 Debian/Ubuntu

Upgrade from containers

从源码包升级

1 Compilation issues

10 Upgrade notes for 6.4.0

11 Upgrade notes for 6.4.1

12 Upgrade notes for 6.4.2

13 Upgrade notes for 6.4.3

13 Upgrade notes for 6.4.4

14 Upgrade notes for 6.4.5

15 Upgrade notes for 6.4.6

17 Upgrade notes for 6.4.7

18 Upgrade notes for 6.4.8

19 Upgrade notes for 6.4.9

20 Upgrade notes for 6.4.10

21 Upgrade notes for 6.4.11

22 Upgrade notes for 6.4.12

23 Upgrade notes for 6.4.13

24 Upgrade notes for 6.4.14

24 Upgrade notes for 6.4.15

26 Upgrade notes for 6.4.16

27 Upgrade notes for 6.4.17

28 Upgrade notes for 6.4.18

29 Upgrade notes for 6.4.19

30 Upgrade notes for 6.4.20

31 Upgrade notes for 6.4.21

5. 快速入门

1 登录和配置用户

3 新增监控项

4 新建触发器

5 接收问题通知

6. Zabbix Appliance

1 主机和主机组

1 配置主机

2 Configuring a host group

2 资产管理

3 批量更新

2 监控项

1 创建监控项

1 监控项键值的格式

2 自定义间隔

2 监控项值预处理

1 使用示例

2 预处理细节

3 JSONPath 功能

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

4 JavaScript 预处理

其他 JavaScript 对象

5 CSV 转换成 JSON 预处理

3 监控项类型

1 Zabbix agent

Windows 特定的监控项键值

Zabbix agent 2

2 SNMP代理

1 动态索引

2 特殊 OIDs

3 MIB文件

3 SNMP 陷阱

4 IPMI 检查

5 简单检查

监控VMware的监控项键值

6 日志文件监控

7 可计算监控项

聚合计算

8 内部检查

9 SSH检查

10 Telnet检查

11 外部检查

12 采集器监控项

13 JMX监控

14 ODBC监控

1 MySQL推荐的UnixODBC设置

2 PostgreSQL数据库推荐的UnixODBC设置

3 Oracle推荐的UnixODBC设置

4 MSSQL数据库推荐的UnixODBC设置

15 从属监控项

16 HTTP 代理

17 Prometheus 数据处理

18 脚本监控项

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 Network maps

1 配置网络地图

2 主机组元素

3 链接指标

3 仪表板

4 主机仪表盘

8 模板

1 配置模板

2 Configuring a template group

2 链接/取消链接

3 嵌套

4 批量更新

9 开箱即用的模板

HTTP template operation

IPMI 模板操作

JMX 模板操作

ODBC模板操作

Zabbix agent 2 模板操作

Zabbix agent 模板操作

网络设备的标准化模板

10 事件通知

1 媒介类型

1 电子邮箱

2 短信

3 自定义告警脚本

4 Webhook

Webhook 脚本范例

2 动作

1 条件

2 操作

1 发送消息

2 远程命令

3 附加操作

4 在消息中使用宏

3 恢复操作

4 更新操作

5 通知升级

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

1 宏函数

2 Secret user macros

2 用户宏

3 带有上下文的用户宏

4 低级发现宏

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的监控项键值

12. 正则表达式

13. Problem acknowledgment

1. Problem suppression

14. 配置导出/导入

1 Template groups

2 模板

3 主机

4 网络拓扑图

1 配置网络发现规则

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

3 底层自动发现

1 监控项原型

2 触发器原型

3 图形原型

4 主机原型

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

5 自动发现规则

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

2 网络接口的自动发现

3 CPU和CPU核心的自动发现

4 Discovery of SNMP OIDs

4 SNMP OID的自动发现

5 JMX对象的自动发现

6 IPMI传感器的自动发现

7 系统服务的自动发现

8 Windows服务的自动发现

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

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

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

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

13 块设备的自动发现

14 主机接口的自动发现

16. 分布式监控

1 Synchronization of monitoring configuration

2 使用预共享秘钥

1 连接类型或权限问题

2 证书问题

3 PSK problems

1 菜单

1 Event menu

1 Host menu

3 Item context menu

1 Dashboards

仪表盘组件

1 Action log

2 Clock

3 Data overview

4 Discovery status

5 Favorite graphs

6 Favorite maps

7 Geomap

8 Graph

9 Graph (classic)

10 Graph prototype

11 Host availability

12 Item value

13 Map

14 Map navigation tree

15 Plain text

16 Problem hosts

17 Problems

18 Problems by severity

19 SLA report

20 System information

21 Top hosts

22 Trigger overview

23 URL

24 Web monitoring

1 监测

2 问题

1 Cause and symptom problems

3 主机

1 图表

2 Web场景

4 最新数据

6 自动发现

8 拓扑图

2 Services

1 Services

3 SLA

4 SLA 报告

3 资产记录

1 概览

2 主机

4 报表

1 系统信息

2 计划报表

3 可用性报表

4 触发器前100

5 Audit log

6 动作日志

7 通知

6 Data collection

1 Template groups

1 主机组

2 模板

1 Items

2 触发器

3 图形

4 自动发现规则

1 Item prototypes

2 Trigger prototypes

3 Graph prototypes

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

6 管理

1 常规

2 Audit log

2 Proxies

3 Housekeeping

5 Macros

9 队列

7 Alerts

5 动作

7 媒介类型

8 脚本

8 Users

3 Users

4 API tokens

4 用户组

5 Authentication

1 HTTP

2 LDAP

3 SAML

5 用户角色

1 全局通知

2 浏览器提示音

5 前端维护模式

7 定义

8 定制主题风格

10 Zabbix使用的cookie

11 时区

13 Resetting password

19. API

API 信息

版本

Connector

> Connector object

connector.create

connector.delete

connector.get

connector.update

LLD 规则

> LLD规则对象

创建

删除

复制

更新

获取

Module

> Module object

module.create

module.delete

module.get

module.update

Proxy

> Proxy 对象

创建

删除

更新

获取

Template group

> Template group object

templategroup.create

templategroup.delete

templategroup.get

templategroup.massadd

templategroup.massremove

templategroup.massupdate

templategroup.propagate

templategroup.update

User directory

> User directory object

userdirectory.create

userdirectory.delete

userdirectory.get

userdirectory.test

userdirectory.update

Web场景

> Web场景对象

创建

删除

更新

获取

主机

> 主机对象

创建

删除

批量更新

批量添加

更新

获取

配置批量删除

主机原型

> 主机原型对象

创建

删除

更新

查询

主机接口

> 主机接口对象

创建

删除

批量删除

批量添加

更新

替换

获取

主机组

> 主机组对象

hostgroup.propagate

创建

删除

批量删除

批量更新

批量添加

更新

获取

事件

> 事件对象

确认

获取

令牌

> 令牌对象

创建

删除

更新

生成

获取

仪表盘

> 仪表盘对象

Dashboard widget fields

1 Action log

2 Clock

3 Data overview

4 Discovery status

5 Favorite graphs

6 Favorite maps

7 Geomap

8 Graph

9 Graph (classic)

10 Graph prototype

11 Host availability

12 Item value

13 Map

14 Map navigation tree

15 Plain text

16 Problem hosts

17 Problems

18 Problems by severity

19 SLA report

20 System information

21 Top hosts

22 Trigger overview

23 URL

24 Web monitoring

创建

删除

更新

获取

任务

> 任务对象

task.create

task.get

值映射

> 值映射对象

创建

删除

更新

获取

关联

> 关联对象

创建

删除

更新

获取

动作

> 动作对象

创建

删除

更新

获取

历史数据

> 历史数据对象

删除历史数据

查询历史数据

发现检查

> 发现检查对象

获取

发现的主机

> 发现的主机对象

dhost.get

发现规则

> 发现规则对象

创建

删除

更新

获取

告警

> 告警对象

获取

图像

> 图像对象

创建

删除

更新

获取

图标映射

> 图标映射对象

iconmap.create

iconmap.delete

更新

获取

图表

> 图表对象

创建

删除

更新

获取

图表原型

> 图表原型对象

创建图表原型

删除图表原型

更新图表原型

查询图表原型

图表监控项

> 图表监控项对象

获取

媒介类型

> 媒介类型对象

创建

删除

更新

获取

审计日志

> 审计日志对象

获取

报告

> 目标：报告

报告.创建

报告.删除

报告.更新

报告.获取

拓扑图

> 拓扑图对象

拓扑图创建

拓扑图删除

更新拓扑图

获取拓扑图

服务

> 服务对象

service.delete

service.get

service.update

创建服务

服务水平协议

> SLA 对象

sla.get

sla.getsli

sla创建

sla删除

sla更新

模版

> 模版对象

template.create

template.delete

批量删除模板

批量更新模板

批量添加模板

更新模板

检索模板

模版仪表盘

> 模版仪表盘对象

创建模板仪表盘

删除模板仪表盘

更新模板仪表盘

检索模板仪表盘

正则表达式

> 目标：正则表达式

正则表达式.创建

正则表达式.删除

正则表达式.更新

正则表达式.获取

用户

> 用户对象

user.provision

创建用户

删除用户

更新用户

查询用户

检查认证

注销用户

登录用户

解锁用户

用户宏

> 用户宏对象

创建全局宏

创建用户宏

删除主机宏

删除全局宏

更新主机宏

更新全局宏

查询用户宏

用户组

> 用户组对象

创建用户组

删除用户组

更新用户组

查询用户组

监控项

> 监控项对象

创建

删除

更新

获取

监控项原型

> 监控项原型对象

创建监控项原型

删除监控项原型

更新监控项原型

获取监控项原型

管家

> 管家对象

更新

查询

维护

> 维护模式对象

创建维护模式

删除维护模式

更新维护期设置

获取维护期

脚本

> 脚本对象

script.getscriptsbyevents

创建

删除

执行

更新

获取

通过主机获取脚本

自动注册

> 自动注册对象

更新

获取

被发现的服务

> 被发现的服务对象

获取

角色

> 角色对象

角色.创建

角色.删除

角色.更新

角色.获取

触发器

> 触发器对象

创建触发器

删除触发器

更新触发器

检索触发器

触发器原型

> 触发器原型对象

triggerprototype.update

创建触发器原型

删除触发器原型

检索触发器原型

认证

> 认证对象

更新

获取

设置

> 设置对象

settings.get

settings.update

趋势

> 趋势对象

检索趋势

配置

configuration.export

configuration.import

configuration.importcompare

问题

> 问题对象

获取

高可用节点

> 高可用节点对象

HA 节点获取

Appendix 2. Changes from 6.2 to 6.4

Zabbix API changes in 6.4

附录 1. 参考说明

2 Plugins

1 构建可加载插件

3 Frontend modules

6 可加载模块

2安装及配置

1 创建数据库

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

3 为数据库升级主键

4 安全的连接数据库

1 MySQL encryption configuration

2 PostgreSQL encryption configuration

5 TimescaleDB 配置

6 Elasticsearch 配置

8 Zabbix在Nginx特定发行版中的注意事项

9 以 root 用户身份运行agent

10 在Microsoft Windows上的 Zabbix agent

11 SAML setup with Microsoft Azure AD

11 配置 Okta 启用 SAML

12 Oracle 数据库配置

13 SAML setup with OneLogin

13 设置定时报表

14 其他前端语言

15 Upgrading to numeric values of extended range

3 后台进程配置

1 Zabbix 服务器

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 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 协议

3 Zabbix agent 2 protocol

4 Zabbix agent 2 plugin protocol

5 Zabbix sender 协议

6 Header标头

7 实时导出协议

5 监控项

2 参数vm.memory.size

3 被动和主动Agent检查

4 捕捉器监控项

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 为 VMware 创建自定义性能计数器名称

17 Return values

6 支持的函数

1 聚合函数

1 Foreach 函数

2 按位运算函数

3 日期和时间函数

4 历史函数

5 Mathematical functions

5 Trend functions

6 Operator functions

7 Prediction functions

8 String functions

7 宏

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

Overview

9 时间段语法

10 命令执行

11 版本兼容性

12 数据库错误处理

13 Zabbix sender Windows 动态链接库

14 Python library for Zabbix API

14 服务监控升级

15 其他问题

16 Agent 和 agent 2 对比

18 Escaping examples

22. Quick reference guides

1. Monitor Linux with Zabbix agent

2 Monitor Windows with Zabbix agent

3. Monitor Apache via HTTP

4. Monitor MySQL with Zabbix agent 2

5 Monitor VMware with Zabbix

Developer Center

Modules

Module file structure

manifest.json

Actions

Views

Assets

Register a new module

Widgets

Configuration

Presentation

Tutorials

Create a module (tutorial)

Create a widget (tutorial)

Examples

插件

Examples

Build a plugin (tutorial)

Plugin interfaces

Zabbix 手册页

zabbix_web_service

Table of Contents

监控项原型

监控项原型

此类用于管理监控项原型。

对象引用:

监控项原型

可用的方法:

itemprototype.create 创建监控项原型
itemprototype.delete 删除监控项原型
itemprototype.get 搜索监控项原型
itemprototype.update 更新监控项原型