配置参数:Zabbix 服务器

概述

配置参数可用于自定义 Zabbix 服务器的行为。

请在配置文件(zabbix_server.conf)中指定参数值。除非明确说明该参数为必填,否则所有参数均为可选

本页结构如下:

  • 参数概览(要查看某个参数的完整详情,请单击其名称)
  • 参数详情
Parameter Description
AlertScriptsPath 指定告警脚本位置。
AllowRoot 允许服务器以 root 身份运行。
AllowSoftwareUpdateCheck 允许接收来自 zabbix.com 的软件更新信息。
AllowUnsupportedDBVersions 允许服务器与不受支持的数据库版本配合工作。
CacheSize 设置配置缓存大小(以字节为单位)。
CacheUpdateFrequency 设置配置缓存更新频率(以秒为单位)。
DBHost 指定数据库主机(或套接字目录)。
DBName 指定数据库名称。必填
DBPassword 指定数据库密码。
DBPort 指定数据库主机的端口。
DBSchema 指定数据库模式名称。用于 PostgreSQL。
DBSocket 指定 MySQL 套接字文件路径。
DBUser 指定数据库用户。
DBTLSConnect 指定一个值以强制与数据库建立 TLS 连接。
DBTLSCAFile 指定包含用于数据库证书验证的顶级 CA 证书的文件完整路径。
DBTLSCertFile 指定包含用于向数据库进行身份验证的 Zabbix 服务器证书的文件完整路径。
DBTLSKeyFile 指定包含用于向数据库进行身份验证的私钥的文件完整路径。
DBTLSCipher 指定 Zabbix 服务器允许用于 TLS v1.2 及以下 TLS 协议的加密套件列表。仅支持 MySQL。
DBTLSCipher13 指定 Zabbix 服务器允许用于 TLS v1.3 协议的加密套件列表。仅支持 MySQL,自 8.0.16 版本起支持。
DebugLevel 设置调试级别。
EnableGlobalScripts 在 Zabbix 服务器上启用全局脚本。
ExportDir 指定一个目录以启用事件、历史数据和趋势数据的实时导出。
ExportFileSize 设置最大导出文件大小(以字节为单位)。
ExportType 指定实时导出的实体类型(事件、历史数据、趋势数据)。
ExternalScripts 指定外部脚本位置。
Fping6Location 指定 fping6 位置。
FpingLocation 指定 fping 位置。
FrontendAllowedIP 指定允许从前端连接的 IP 地址或 CIDR 范围。
HANodeName 指定高可用集群中的节点名称。
HistoryCacheSize 设置历史数据缓存大小。
HistoryIndexCacheSize 设置历史索引缓存大小。
HistoryStorageDateIndex 启用根据日期将历史值存储在不同索引中。
HistoryStorageURL 指定历史存储 URL。
HistoryStorageTypes 指定要发送到历史存储的值类型。
HousekeepingFrequency 设置清理程序执行频率(以小时为单位)。
Include 指定要包含到配置文件中的目录或单个文件。
JavaGateway 指定 Zabbix Java 网关 IP 地址(或主机名)。
JavaGatewayPort 指定 Zabbix Java 网关端口。
ListenBacklog 设置 TCP 队列中待处理连接的最大数量。
ListenIP 指定 trapper 监听的 IP 地址。
ListenPort 指定 trapper 监听端口。
LoadModule 指定服务器启动时要加载的模块。
LoadModulePath 指定服务器模块所在位置的完整路径。
LogFile 指定服务器日志文件。
LogFileSize 设置最大日志文件大小。
LogSlowQueries 设置数据库查询在被记录前允许的最长耗时(以毫秒为单位)。
LogType 指定日志输出类型。
MaxConcurrentChecksPerPoller 设置每个 HTTP agent poller、agent poller 或 SNMP poller 同时可执行的异步检查最大数量。
MaxHousekeeperDelete 设置每个清理周期中每个任务可删除的最大行数。
NodeAddress 指定 IP 或主机名,可选端口,用于覆盖前端连接到服务器的方式。
PidFile 指定 PID 文件。
ProblemHousekeepingFrequency 设置删除已删除触发器对应问题的频率。
ProxyConfigFrequency 设置服务器向 Zabbix proxy 发送配置数据的频率。
ProxyDataFrequency 设置服务器向 Zabbix proxy 请求历史数据的频率。
ServiceManagerSyncFrequency 设置同步服务管理器配置的频率。
SMSDevices 指定允许 Zabbix 服务器使用的调制解调器文件。
SNMPTrapperFile 指定用于将数据从 SNMP trap 守护进程传递到服务器的临时文件。
SocketDir 指定用于存储内部 Zabbix 服务所使用 IPC 套接字的目录。
SourceIP 指定源 IP 地址。
SSHKeyLocation 指定用于 SSH 检查和操作的公钥和私钥位置。
SSLCertLocation 指定用于客户端身份验证的 SSL 客户端证书文件位置。
SSLKeyLocation 指定用于客户端身份验证的 SSL 私钥文件位置。
SSLCALocation 指定用于 SSL 服务器证书验证的证书颁发机构(CA)文件位置。
StartAgentPollers 设置异步 Zabbix agent poller 的预 fork 实例数量。
StartAlerters 设置 alerter 的预 fork 实例数量。
StartBrowserPollers 设置 browser 监控项 poller 的预 fork 实例数量。
StartConnectors 设置 connector worker 的预 fork 实例数量。
StartDBSyncers 设置历史同步器的预 fork 实例数量。
StartDiscoverers 设置发现 worker 的预 fork 实例数量。
StartEscalators 设置 escalator 的预 fork 实例数量。
StartHistoryPollers 设置历史 poller 的预 fork 实例数量。
StartHTTPAgentPollers 设置异步 HTTP agent poller 的预 fork 实例数量。
StartHTTPPollers 设置 HTTP poller 的预 fork 实例数量。
StartIPMIPollers 设置 IPMI poller 的预 fork 实例数量。
StartJavaPollers 设置 Java poller 的预 fork 实例数量。
StartLLDProcessors 设置低级别发现(LLD)worker 的预 fork 实例数量。
StartODBCPollers 设置 ODBC poller 的预 fork 实例数量。
StartPingers 设置 ICMP pinger 的预 fork 实例数量。
StartPollersUnreachable 设置用于不可达主机的 poller 预 fork 实例数量(包括 IPMI 和 Java)。
StartPollers 设置 poller 的预 fork 实例数量。
StartPreprocessors 设置预处理 worker 的预启动实例数量。
StartProxyPollers 设置用于被动 proxy 的 poller 预 fork 实例数量。
StartReportWriters 设置 report writer 的预 fork 实例数量。
StartSNMPPollers 设置异步 SNMP poller 的预 fork 实例数量。
StartSNMPTrapper 设置为 "1" 以启动 SNMP trapper 进程。
StartTimers 设置 timer 的预 fork 实例数量。
StartTrappers 设置 trapper 的预 fork 实例数量。
StartVMwareCollectors 设置 VMware 收集器的预 fork 实例数量。
StatsAllowedIP 指定允许请求统计信息的外部 Zabbix 实例的 IP 地址或 DNS 名称。
Timeout 指定与 Zabbix proxy、agent、web 服务建立连接并交换数据,以及执行 SNMP 检查时的等待时间(以秒为单位,SNMP walk[OID]get[OID] 监控项除外)。
TLSCAFile 指定包含用于对等证书验证的顶级 CA 证书的文件完整路径,用于 Zabbix 组件之间的加密通信。
TLSCertFile 指定包含服务器证书或证书链的文件完整路径,用于 Zabbix 组件之间的加密通信。
TLSCipherAll 指定 GnuTLS 优先级字符串或 OpenSSL(TLS 1.2)加密字符串。覆盖基于证书和 PSK 的加密默认套件选择标准。
TLSCipherAll13 指定 TLS 1.3 中 OpenSSL 1.1.1 或更新版本使用的加密字符串。覆盖基于证书和 PSK 的加密默认套件选择标准。
TLSCipherCert 指定 GnuTLS 优先级字符串或 OpenSSL(TLS 1.2)加密字符串。覆盖基于证书的加密默认套件选择标准。
TLSCipherCert13 指定 TLS 1.3 中 OpenSSL 1.1.1 或更新版本使用的加密字符串。覆盖基于证书的加密默认套件选择标准。
TLSCipherPSK 指定 GnuTLS 优先级字符串或 OpenSSL(TLS 1.2)加密字符串。覆盖基于 PSK 的加密默认套件选择标准。
TLSCipherPSK13 指定 TLS 1.3 中 OpenSSL 1.1.1 或更新版本使用的加密字符串。覆盖基于 PSK 的加密默认套件选择标准。
TLSCRLFile 指定包含已吊销证书的文件完整路径。此参数用于 Zabbix 组件之间的加密通信。
TLSFrontendAccept 指定来自前端的入站连接所使用的加密级别。
TLSFrontendCertIssuer 指定允许的前端证书颁发者。
TLSFrontendCertSubject 指定允许的前端证书主题。
TLSKeyFile 指定包含服务器私钥的文件完整路径,用于 Zabbix 组件之间的加密通信。
TLSListen 要求 trapper 套接字仅接受 TLS 连接。
TmpDir 指定临时目录。
TrapperTimeout 指定以下场景的 trapper 超时时间(秒):
- 从 Zabbix proxy 检索历史数据;
- 向 Zabbix proxy 发送配置数据;
- 在 Zabbix 服务器上执行全局脚本或远程命令。
TrendCacheSize 设置趋势缓存大小。
TrendFunctionCacheSize 设置趋势函数缓存大小。
UnavailableDelay 设置在不可用期间检查主机可用性的频率。
UnreachableDelay 设置在不可达期间检查主机可用性的频率。
UnreachablePeriod 设置在不可达多少秒后将主机视为不可用。
User 将权限降级为系统中某个已存在的特定用户。
ValueCacheSize 设置历史值缓存大小。
Vault 指定 vault 提供程序。
VaultDBPath 指定通过密钥检索数据库凭据的位置。
VaultPrefix 指定 vault 路径或查询的自定义前缀。
VaultTLSCertFile 指定用于客户端身份验证的 SSL 证书文件名。
VaultTLSKeyFile 指定用于客户端身份验证的 SSL 私钥文件名。
VaultToken 指定 HashiCorp vault 身份验证令牌。
VaultURL 指定 vault 服务器 URL。
VMwareCacheSize 设置用于存储 VMware 数据的共享内存大小。
VMwareFrequency 设置从单个 VMware 服务收集数据的频率(以秒为单位)。
VMwarePerfFrequency 设置从单个 VMware 服务检索性能计数器统计信息的频率(以秒为单位)。
VMwareTimeout 设置 vmware collector 等待 VMware 服务响应的最长秒数。
WebDriverURL 指定 WebDriver 接口 URL。
WebServiceURL http[s]://host:port/report 格式指定 web 服务 URL。

请注意:

  • 默认值反映的是守护进程默认值,而不是随软件包提供的配置文件中的值。
  • 值支持环境变量
  • Zabbix 仅支持 UTF-8 编码且不含 BOM 的配置文件。
  • # 开头的注释仅在行首支持。

过多的进程可能会耗尽 preprocessing manager 的每进程文件描述符限制。

此类进程包括由 poller、unreachable poller、ODBC poller、HTTP poller、Java poller、pinger、trapper、proxy poller 以及 IPMI manager、SNMP trapper、preprocessing worker 和 discovery worker 执行的数据采集任务。耗尽文件描述符限制会导致 Zabbix 服务器停止,通常会在启动后不久发生,但有时也可能需要更长时间。

为避免此类问题,请查看 Zabbix 服务器配置文件,以优化并发检查和进程数量。 此外,如有必要,请通过检查和调整系统限制,确保文件描述符限制设置得足够高。

参数详情

AlertScriptsPath

指定 告警脚本 的位置。
取决于编译时安装变量 datadir

默认值:/usr/local/share/zabbix/alertscripts

AllowRoot

允许服务器以 root 身份运行。 如果禁用该选项且服务器由 root 启动,服务器将尝试切换为 zabbix 用户。 如果在普通用户下启动,则无效。

默认值:0
取值:0 - 不允许;1 - 允许

AllowSoftwareUpdateCheck

允许 Zabbix 前端接收来自 zabbix.com 的软件更新信息。

默认值:1
取值:0 - 不允许;1 - 允许

AllowUnsupportedDBVersions

允许服务器使用不受支持的数据库版本工作。

默认值: 0
取值: 0 - 不允许;1 - 允许

CacheSize

设置配置缓存大小(以字节为单位)。 用于存储主机、监控项和触发器数据的共享内存大小。

默认值:32M
范围:128K-64G

CacheUpdateFrequency

设置配置缓存更新频率(以秒为单位)。 另请参见 runtime control 选项。

默认值:10
范围:1-3600

DBHost

指定数据库主机(或套接字目录)。

对于 MySQL:

  • localhost 或空字符串将使用默认的 UNIX 域套接字。

对于 PostgreSQL:

  • localhost 通过 DNS 解析(通常解析为 127.0.0.1)。
  • 空字符串将使用默认的 UNIX 域套接字。
  • 路径(例如 /var/run/pgbouncer)会使用该路径下的 UNIX 套接字。
  • 以逗号分隔的列表可以包含多个 host:port 值。系统会按顺序尝试每个主机,直到建立读写连接。 示例:DBHost=localhost:5431,127.0.0.1:20051,zabbix.domain,[::1]:30051,[12fc::1]

默认值:localhost

DBName

指定数据库名称。

必填:

DBPassword

指定数据库密码。 如果未使用密码,请注释掉这一行。

DBPort

指定 Zabbix 数据库主机的端口(参见 DBHost)。
DBSocket 和 DBPort 在服务器配置中互斥。请仅指定其中一个,或将两者都留空。

MySQL 的默认值:3306

PostgreSQL 的默认值:5432

范围:1024-65535

DBSchema

指定数据库模式名称。 用于 PostgreSQL。

DBSocket

指定 MySQL socket 文件的路径。
DBSocket 和 DBPort 在服务器配置中互斥。请仅指定其中一个,或将两者都留空。

DBUser

指定数据库用户。

DBTLSConnect

指定一个值以强制与数据库建立 TLS 连接:
required - 使用 TLS 连接
verify_ca - 使用 TLS 连接并验证证书
verify_full - 使用 TLS 连接,验证证书,并验证 DBHost 指定的数据库标识是否与其证书匹配

对于 MySQL,从 5.7.11 开始,以及 PostgreSQL,支持以下值:requiredverify_caverify_full
对于 MariaDB,从 10.2.6 版本开始,支持 requiredverify_full 值。
默认情况下不设置任何选项,具体行为取决于数据库配置。

DBTLSCAFile

指定包含用于数据库证书验证的顶级 CA 证书的文件的完整路径名。

必需:否(如果将 DBTLSConnect 设置为 verify_caverify_full,则为是)

DBTLSCertFile

指定包含用于对数据库进行身份验证的 Zabbix 服务器证书的文件的完整路径名。

DBTLSKeyFile

指定包含用于数据库身份验证的私钥文件的完整路径名。

DBTLSCipher

指定 Zabbix 服务器允许用于 TLS 协议(最高至 TLS v1.2)的加密套件列表。 仅支持 MySQL。

DBTLSCipher13

指定 Zabbix 服务器允许用于 TLS v1.3 协议的加密套件列表。 仅支持 MySQL,自 8.0.16 版本起可用。

DebugLevel

设置调试级别:
0 - 关于 Zabbix 进程启动和停止的基本信息
1 - 关键性信息;
2 - 错误信息;
3 - 警告;
4 - 用于调试(会产生大量信息);
5 - 扩展调试(会产生更多信息)。
另请参见 运行时控制 选项。

默认值:3
范围:0-5

EnableGlobalScripts

在 Zabbix 服务器上启用全局脚本。
注意:全局脚本执行默认已启用。 但是,对于从 Zabbix 7.0 开始的新安装,EnableGlobalScripts 会显式设置为 0(禁用)。

默认值:1
取值:0 - 禁用;1 - 启用

ExportDir

指定一个目录以启用事件、历史数据和趋势的实时导出

ExportFileSize

设置最大导出文件大小(以字节为单位)。 当设置了 ExportDir 时,用于轮转。

默认值:1G
范围:1M-1G

ExportType

指定 实时导出 的实体类型(事件、历史数据、趋势)。使用逗号分隔的列表。 默认导出所有类型。 仅在设置了 ExportDir 时有效。
注意,如果指定了 ExportType,但未指定 ExportDir,则这是一个配置错误,服务器将无法启动。

历史数据和趋势导出的示例:

ExportType=history,trends

仅导出事件的示例:

ExportType=events
外部脚本

指定外部脚本的位置。
取决于编译时安装变量 datadir

默认值:/usr/local/share/zabbix/externalscripts

Fping6Location

指定 fping6 的位置。 请确保 fping6 二进制文件的所有者为 root,并已设置 SUID 标志。 如果你的 fping 工具能够处理 IPv6 地址,请将其留空("Fping6Location=")。

默认值:/usr/sbin/fping6

FpingLocation

指定 fping 的位置。 请确保 fping 二进制文件的所有者为 root,并已设置 SUID 标志。

默认值:/usr/sbin/fping

FrontendAllowedIP

指定允许从前端连接的 IP 地址或 CIDR 范围。使用逗号分隔的列表。 默认情况下,前端请求接受所有连接。 如果启用了 IPv6 支持,则 '127.0.0.1'、'::127.0.0.1'、'::ffff:127.0.0.1' 会被视为相同,且 '::/0' 将允许任何 IPv4 或 IPv6 地址。 '0.0.0.0/0' 可用于允许任何 IPv4 地址。

示例:

FrontendAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
HANodeName

指定高可用集群中的节点名称。 当该值为空时,服务器以独立模式运行,并会创建一个名称为空的节点。

HistoryCacheSize

设置历史缓存大小(以字节为单位)。 用于存储历史数据的共享内存大小。

默认值:16M
范围:128K-16G

HistoryIndexCacheSize

设置 history-index 缓存大小(以字节为单位)。 用于为存储在 history cache 中的历史数据建立索引的共享内存大小。 索引缓存大小大约需要 100 字节来缓存一个监控项。

默认值:4M
范围:128K-16G

HistoryStorageDateIndex

启用根据日期将历史值存储到不同的索引中。

默认值:0
取值:0 - 禁用;1 - 启用

HistoryStorageURL

指定历史存储 URL。 此参数用于 Elasticsearch 设置。

HistoryStorageTypes

指定要发送到历史存储的值类型。使用逗号分隔的列表。 此参数用于 Elasticsearch 配置。

默认值:uint,dbl,str,log,text,json

HousekeepingFrequency

设置 housekeeping 过程的频率(以小时为单位)。 Housekeeping 是从数据库中删除过期信息。
Note: 为了防止 housekeeper 负载过高(例如,当 history 和 trend 周期大幅缩短时),在每个 housekeeping 周期中,每个监控项删除的过期信息不会超过 HousekeepingFrequency 小时对应的 4 倍。 因此,如果 HousekeepingFrequency 为 1,则每个周期最多删除 4 小时的过期信息(从最旧的记录开始)。
Note: 为了降低服务器启动时的负载,housekeeping 会在服务器启动后延迟 30 分钟执行。 因此,如果 HousekeepingFrequency 为 1,服务器启动后的第一次 housekeeping 过程将在 30 分钟后运行,之后每隔 1 小时重复执行一次。
可以通过将 HousekeepingFrequency 设置为 0 来禁用自动 housekeeping。 在这种情况下,housekeeping 过程只能通过 housekeeper_execute 运行时控制选项启动,并且在一个 housekeeping 周期中删除的过期信息时长为自上次 housekeeping 周期以来时间的 4 倍,但不少于 4 小时且不超过 4 天。
另请参阅 runtime control 选项以及 housekeeping procedure 的详细信息。

默认值:1
范围:0-24

包含

指定要包含到配置文件中的目录或单个文件。 若要仅包含指定目录中相关的文件,支持使用星号通配符进行模式匹配。 有关限制,请参见 special notes

示例:

Include=/absolute/path/to/config/files/*.conf
JavaGateway

指定 Zabbix Java 网关的 IP 地址或主机名。 仅在启动 Java poller 时才需要。

JavaGatewayPort

指定 Zabbix Java 网关端口。

默认值:10052
范围:1024-32767

ListenBacklog

设置 TCP 队列中待处理连接的最大数量。
默认值是一个硬编码常量,具体取决于系统。
支持的最大值也取决于系统,过高的值可能会被静默截断为“implementation-specified maximum”。

默认值: SOMAXCONN
范围: 0 - INT_MAX

ListenIP

指定 trapper 监听的 IP 地址。使用逗号分隔的列表。
如果未指定此参数,trapper 将监听所有网络接口。

默认值:0.0.0.0

ListenPort

指定 trapper 监听端口。

默认值:10051
范围:1024-32767

LoadModule

指定在服务器启动时加载的模块。 模块用于扩展服务器的功能。 模块必须位于 LoadModulePath 指定的目录中,或者路径必须位于模块名称之前。 如果前面的路径是绝对路径(以 '/' 开头),则会忽略 LoadModulePath。
格式:
LoadModule=<module.so>
LoadModule=<path/module.so>
LoadModule=</abs_path/module.so>
允许包含多个 LoadModule 参数。

LoadModulePath

指定服务器模块所在位置的完整路径。 默认值取决于编译选项。

LogFile

指定服务器日志文件。

必填:是,如果 LogType 设置为 file;否则不是

LogFileSize

设置最大日志文件大小(以 MB 为单位)。
0 - 禁用自动日志轮转。
注意:如果达到日志文件大小限制且文件轮转因任何原因失败,现有日志文件将被截断并重新开始。

默认值:1
范围:0-1024
必填:是,如果 LogType 设置为 file;否则不是

LogSlowQueries

设置数据库查询在被记录之前允许的最长执行时间(以毫秒为单位)。
0 - 不记录慢查询。
此选项从 DebugLevel=3 开始启用。

默认值: 0
范围: 0-3600000

LogType

指定日志输出类型:
file - 将日志写入由 LogFile 参数指定的文件;
system - 将日志写入 syslog;
console - 将日志写入标准输出。

默认值:file

MaxConcurrentChecksPerPoller

设置每个 HTTP agent poller、agent poller 或 SNMP poller 一次可执行的异步检查的最大数量。 请参见 StartHTTPAgentPollersStartAgentPollersStartSNMPPollers

默认值:1000
范围:1-1000

MaxHousekeeperDelete

设置在一次 housekeeping 周期中,每个任务从 historyhistory_strhistory_loghistory_uinthistory_texthistory_binhistory_jsontrendstrends_uintproblem 表中删除的最大行数。
housekeeping 任务以 [housekeeperid][object][objectid] 的格式存在于 housekeeper 表中。
此参数仅适用于删除已删除监控项遗留的数据。
如果设置为 0,则完全不使用限制。
在这种情况下,您必须清楚自己在做什么,以免使数据库过载。
当删除大量监控项时,会增加数据库负载,因为 housekeeper 需要删除这些监控项所对应的所有历史数据。
例如,如果我们只需要从模板中删除 1 个监控项原型,但该模板关联了 50 个主机,并且每个主机上该原型都会展开为 100 个实际监控项,那么总共需要删除 5000 个监控项(1*50*100)。
如果为 MaxHousekeeperDelete 设置为 500(MaxHousekeeperDelete=500),则 housekeeper 进程在一个周期内将需要从 history 和 trends 表中为已删除的监控项删除最多 2500000 个值(5000*500)。

另请参见 housekeeping procedure 的详细信息。

默认值:5000
范围:0-1000000

NodeAddress

指定 IP 或主机名,并可选指定端口,以覆盖前端连接到服务器的方式。
格式:<address>[:<port>]

如果未设置 IP 或主机名,将使用 ListenIP 的值。 如果未设置 ListenIP,将使用 localhost
如果未设置端口,将使用 ListenPort 的值。 如果未设置 ListenPort,将使用 10051

此选项可被前端配置中指定的地址覆盖。

另请参见:HANodeName 参数;启用高可用性

默认值:localhost:10051

PidFile

指定 PID 文件。

默认值:/tmp/zabbix_server.pid

ProblemHousekeepingFrequency

设置删除已删除触发器的问题的频率(以秒为单位)。
另请参阅 housekeeping procedure 的详细信息。

默认值:60
范围:1-3600

ProxyConfigFrequency

设置服务器向 Zabbix proxy 发送配置数据的频率。 仅用于被动模式下的 proxy。

默认值:10
范围:1-604800

ProxyDataFrequency

设置服务器从 Zabbix proxy 请求历史数据的频率。 仅用于被动模式下的 proxy。

默认值:1
范围:1-3600

ServiceManagerSyncFrequency

设置服务管理器配置同步的频率(以秒为单位)。

默认值:60
范围:1-3600

SMSDevices

指定允许 Zabbix 服务器使用的调制解调器文件。以逗号分隔的列表。
如果未设置此参数,则无法发送 SMS。

示例:

SMSDevices=/dev/ttyUSB0,/dev/ttyUSB1
SNMPTrapperFile

指定用于将数据从 SNMP trap 守护进程传递到服务器的临时文件。
必须与 zabbix_trap_receiver.pl 或 SNMPTT 配置文件中的设置相同。

默认值:/tmp/zabbix_traps.tmp

SocketDir

指定用于存储内部 Zabbix 服务所使用的 IPC 套接字的目录。

默认值:/tmp

SourceIP

为以下连接指定源 IP 地址:

  • 到 Zabbix proxy 和 Zabbix agent 的出站连接
  • 无 agent 连接(VMware、SSH、JMX、SNMP、Telnet 和简单检查)
  • HTTP agent 连接
  • 脚本监控项的 JavaScript HTTP 请求
  • 预处理 JavaScript HTTP 请求
  • 发送通知邮件(连接到 SMTP 服务器)
  • webhook 通知(JavaScript HTTP 连接)
  • 连接到 Vault
SSHKeyLocation

指定用于 SSH 检查和操作的公钥和私钥位置。

SSLCertLocation

指定用于客户端身份验证的 SSL 客户端证书文件的位置。
此参数仅用于 web 监控。

SSLKeyLocation

指定用于客户端身份验证的 SSL 私钥文件位置。
此参数仅用于 web 监控。

SSLCALocation

指定用于 SSL 服务器证书验证的 CA(证书颁发机构)文件位置。 如果未设置,将使用系统范围的目录。
请注意,此参数的值将被设置为 libcurl 选项 CURLOPT_CAPATH。 对于 7.42.0 之前的 libcurl 版本,只有在 libcurl 编译时使用了 OpenSSL 的情况下,此参数才会生效。 有关更多信息,请参见 cURL web page
此参数用于 Web 监控和 SMTP 身份验证。

StartAgentPollers

设置 Zabbix agent pollers 的预 fork 实例数量。 请参见 MaxConcurrentChecksPerPoller

默认值:1
范围:0-1000

StartAlerters

设置 alerters 的预 fork 实例数量。

默认值:3
范围:1-100

StartBrowserPollers

设置 browser 监控项 pollers 的预 fork 实例数量。

默认值:1
范围:0-1000

StartConnectors

设置 connector workers 的预 fork 实例数量。 当启动 connector worker 时,connector manager 进程会自动启动。

默认值:0
范围:0-1000

StartDBSyncers

设置 history syncers 的预 fork 实例数量。
注意:更改此值时请谨慎,增加它可能弊大于利。 大致来说,默认值应足以处理最多 4000 NVPS。

默认值:4
范围:1-100

StartDiscoverers

设置 discovery workers1 的预 fork 实例数量。

默认值:5
范围:0-1000

StartEscalators

设置 escalators 的预 fork 实例数量。

默认值:1
范围:1-100

StartHistoryPollers

设置 history pollers 的预 fork 实例数量。
仅在计算型检查中需要。

默认值:5
范围:0-1000

StartHTTPAgentPollers

设置 HTTP agent pollers 的预 fork 实例数量。 请参见 MaxConcurrentChecksPerPoller

默认值:1
范围:0-1000

StartHTTPPollers

设置 HTTP pollers1 的预 fork 实例数量。

默认值:1
范围:0-1000

StartIPMIPollers

设置 IPMI pollers 的预 fork 实例数量。

默认值:0
范围:0-1000

StartJavaPollers

设置 Java pollers1 的预 fork 实例数量。

默认值:0
范围:0-1000

StartLLDProcessors

设置低级别发现(LLD)worker1 的预 fork 实例数量。
当启动 LLD worker 时,LLD 管理器进程会自动启动。

默认值:2
范围:1-100

StartODBCPollers

设置 ODBC pollers1 的预 fork 实例数量。

默认值:1
范围:0-1000

StartPingers

设置 ICMP pingers1 的预 fork 实例数量。

默认值:1
范围:0-1000

StartPollersUnreachable

设置 用于不可达主机的 poller 的预 fork 实例数量(包括 IPMI 和 Java)1
如果已启动常规 poller、IPMI poller 或 Java poller,则必须至少运行一个用于不可达主机的 poller。

默认值:1
范围:0-1000

StartPollers

设置 pollers1 的预先 fork 的实例数量。

默认值:5
范围:0-1000

预启动预处理器

设置预先启动的预处理 worker1 线程数量,应不小于可用 CPU 核心数。 如果预处理不受 CPU 限制且包含大量网络请求,则应设置更多 worker。

默认值:16
范围:1-1000

StartProxyPollers

设置 用于被动 proxy 的 poller1 的预 fork 实例数量。

默认值:1
范围:0-250

StartReportWriters

设置 report writers 的预 fork 实例数量。
如果设置为 0,则会禁用计划报告生成。
当启动 report writer 时,report manager 进程会自动启动。

默认值:0
范围:0-100

StartSNMPPollers

设置 SNMP pollers 的预 fork 实例数量。 参见 MaxConcurrentChecksPerPoller

默认值:1
范围:0-1000

StartSNMPTrapper

设置为 1 以启动 SNMP trapper 进程。

默认值:0
范围:0-1

StartTimers

设置 timers 的预 fork 实例数量。
Timers 进程处理维护周期。

默认值:1
范围:1-1000

StartTrappers

设置 trappers1 的预 fork 实例数量。
Trappers 接受来自 Zabbix sender、active agent 和 active proxy 的传入连接。

默认值:5
范围:0-1000

StartVMwareCollectors

设置预先 fork 的 VMware collector 实例数量。

默认值:0
范围:0-250

StatsAllowedIP

指定允许请求统计信息的外部 Zabbix 实例的 IP 地址(可选使用 CIDR 表示法)或 DNS 名称。以逗号分隔的列表。
如果未设置此参数,将不接受任何统计信息请求。
如果启用了 IPv6 支持,则 '127.0.0.1'、'::127.0.0.1'、'::ffff:127.0.0.1' 会被视为相同,且 '::/0' 将允许任何 IPv4 或 IPv6 地址。 '0.0.0.0/0' 可用于允许任何 IPv4 地址。

示例:

StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
超时

指定与 Zabbix proxy、agent、web service 以及旧版 SNMP 检查(单个 OID 编号或字符串)建立连接并交换数据时的等待时间(秒)。

此参数定义了多种通信操作的持续时间:

  • 在 Zabbix agent 上执行远程命令
  • SSH/Telnet 命令执行
  • 向 Zabbix web service 发起请求
  • mediatype 测试请求和 history.push 方法的通信超时
  • 当 IPMI 接口变为不可用时重新调度监控项
  • 因权限或加密问题导致数据交换失败时,向 Zabbix proxy 发送响应
  • IPC 异步套接字和运行时控制选项的截止时间
  • JMX 连接
  • 从远程 Zabbix proxy 或服务器获取统计信息
  • 向 Zabbix 前端发送响应
  • 异步 poller 的 DNS 请求
  • active check 心跳的响应
  • 从 active agent 获取 Zabbix agent 数据(值)
  • 从 Zabbix sender 获取数据
  • trapper 无法处理请求时的响应
  • 向 Zabbix agent 发送 active check 列表

对于在前端中配置了 flexible timeout 设置的检查(在全局、proxy 或单个监控项级别),不会使用此超时。 例如,SNMP walk[OID]get[OID] 监控项使用前端中配置的超时;旧版 SNMP 检查仍然使用服务器超时值。

默认值:3
范围:1-30

TLSCAFile

指定包含用于对等证书验证的顶级 CA 证书的文件完整路径名,该证书用于 Zabbix 组件之间的加密通信。

TLSCertFile

指定包含服务器证书或证书链的文件的完整路径名,用于 Zabbix 组件之间的加密通信。

TLSCipherAll

指定 GnuTLS 优先级字符串或 OpenSSL(TLS 1.2)密码字符串。 覆盖基于证书和 PSK 的加密的默认密码套件选择条件。

示例:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherAll13

为 OpenSSL 1.1.1 或更新版本在 TLS 1.3 中指定密码字符串。 覆盖基于证书和基于 PSK 的加密的默认密码套件选择标准。

GnuTLS 示例:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509

OpenSSL 示例:

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128
TLSCipherCert

指定 GnuTLS 优先级字符串或 OpenSSL(TLS 1.2)密码套件字符串。 覆盖基于证书的加密的默认密码套件选择标准。

GnuTLS 示例:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509

OpenSSL 示例:

EECDH+aRSA+AES128:RSA+aRSA+AES128
TLSCipherCert13

为 TLS 1.3 指定适用于 OpenSSL 1.1.1 或更新版本的密码字符串。 覆盖基于证书的加密的默认密码套件选择标准。

TLSCipherPSK

指定 GnuTLS 优先级字符串或 OpenSSL(TLS 1.2)密码套件字符串。
覆盖基于 PSK 的加密的默认密码套件选择标准。

GnuTLS 示例:

NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL

OpenSSL 示例:

kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13

为 TLS 1.3 中的 OpenSSL 1.1.1 或更新版本指定密码字符串。 覆盖基于 PSK 的加密所使用的默认密码套件选择标准。

示例:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCRLFile

指定包含已吊销证书的文件的完整路径名。 此参数用于 Zabbix 组件之间的加密通信。

TLSFrontendAccept

指定来自前端的入站连接的加密级别。

可以指定多个值,并用逗号分隔:

  • unencrypted - 接受未加密的连接。
  • cert - 接受使用 TLS 和证书保护的连接。

默认值:unencrypted

TLSFrontendCertIssuer

指定允许的前端证书颁发者。

TLSFrontendCertSubject

指定允许的前端证书主题。

TLSKeyFile

指定包含服务器私钥的文件的完整路径名,用于 Zabbix 组件之间的加密通信。

TLSListen

在 trapper 套接字上仅允许 TLS 连接。

支持的值:

  • required - 仅接受 TLS 连接
TmpDir

指定临时目录。

默认值:/tmp

TrapperTimeout

为以下操作指定 trapper 超时时间(秒):

  • 从 Zabbix proxy 检索历史数据
  • 向 Zabbix proxy 发送配置数据
  • 在 Zabbix 服务器上执行全局脚本或远程命令

默认值:300
范围:1-300

TrendCacheSize

设置趋势缓存大小,单位为字节。
用于存储趋势数据的共享内存大小。

默认值:4M
范围:128K-16G

TrendFunctionCacheSize

设置趋势函数缓存大小,单位为字节。
用于缓存已计算趋势函数数据的共享内存大小。

默认值:4M
范围:128K-2G

UnavailableDelay

设置在 不可用 期间检查主机可用性的频率,单位为秒。

默认值:60
范围:1-3600

UnreachableDelay

设置在 unreachability 期间检查主机可用性的频率,单位为秒。

默认值:15
范围:1-3600

UnreachablePeriod

设置在多少秒的不可达后将主机视为不可用。

默认值:45
范围:1-3600

用户

将权限降级为系统中某个特定的、已存在的用户。
仅在以 'root' 运行且 AllowRoot 被禁用时生效。

默认值:zabbix

ValueCacheSize

设置历史值缓存的大小(以字节为单位)。
用于缓存监控项历史数据请求的共享内存大小。
设置为 0 将禁用值缓存(不推荐)。
当值缓存耗尽共享内存时,服务器日志中会每 5 分钟写入一条警告消息。

默认值:8M
范围:0,128K-64G

Vault

指定 vault 提供程序:
HashiCorp - HashiCorp KV Secrets Engine version 2
CyberArk - CyberArk Central Credential Provider
必须与前端中设置的 vault 提供程序一致。

默认:HashiCorp

VaultDBPath

指定用于按键检索数据库凭据的位置。它是一个 Vault 路径或查询,具体取决于所使用的 Vault。

HashiCorp 使用的键为 'password' 和 'username'。

带有 VaultPrefix=/v1/secret/data/zabbix/ 的路径示例:

database

不带 VaultPrefix 的路径示例:

secret/zabbix/database

CyberArk 使用的键为 'Content' 和 'UserName'。

示例:

AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_server_database

仅当未指定 DBUser 和 DBPassword 时,才能使用此选项。

VaultPrefix

指定 vault 路径或查询的自定义前缀,具体取决于 Vault。 如果未指定,将使用最合适的默认值。
请注意,如果未指定 VaultPrefix,对于 HashiCorp,挂载点后会自动追加 'data'。

Hashicorp 的前缀示例:

v1/secret/data/zabbix/

Cyberark 的前缀示例:

/AIMWebService/api/Accounts?
VaultTLSCertFile

指定用于客户端身份验证的 SSL 证书文件名称。 证书文件必须为 PEM1 格式。
如果证书文件中也包含私钥,请将 SSL 密钥文件字段留空。
包含此文件的目录由配置参数 SSLCertLocation 指定。
此选项可以省略,但建议用于 CyberArkCCP vault。

VaultTLSKeyFile

指定用于客户端身份验证的 SSL 私钥文件名称。 私钥文件必须采用 PEM1 格式。
包含该文件的目录由配置参数 SSLKeyLocation 指定。
此选项可以省略,但建议用于 CyberArkCCP vault。

VaultToken

指定 HashiCorp Vault 身份验证令牌。 HashiCorp Vault 身份验证令牌应仅为 Zabbix 服务器生成,并且对 Vault 宏 中指定的路径具有只读权限,同时对可选的 VaultDBPath 配置参数中指定的路径具有只读权限。
如果同时定义了 VaultToken 和 VAULT_TOKEN 环境变量,则会报错。

必填:是,如果 Vault 设置为 HashiCorp;否则为否

VaultURL

指定 vault 服务器 URL。 如果未指定 SSLCALocation,则将使用系统范围的 CA 证书目录。

默认值:https://127.0.0.1:8200

VMwareCacheSize

设置用于存储 VMware 数据的共享内存大小。 可使用 VMware 内部检查 zabbix[vmware,buffer,...] 来监控 VMware 缓存使用情况(参见 内部检查)。
请注意,如果未配置任何 vmware collector 实例启动,则不会分配共享内存。

默认值:8M
范围:256K-2G

VMwareFrequency

设置从单个 VMware 服务收集数据的频率(以秒为单位)。 此频率应设置为任何 VMware 监控项中最小的更新间隔。

默认值:60
范围:10-86400

VMwarePerfFrequency

设置从单个 VMware 服务检索性能计数器统计信息的频率(以秒为单位)。
此频率应设置为任何使用 VMware 性能计数器的 VMware 监控 监控项 的最小更新间隔。

默认值:60
范围:10-86400

VMwareTimeout

设置 vmware collector 等待来自 VMware 服务(vCenter 或 ESX hypervisor)响应的最长秒数。

默认值:10
范围:1-300

WebDriverURL

指定 WebDriver 接口 URL。

示例(与 Selenium WebDriver standalone server 一起使用):

WebDriverURL=http://localhost:4444
WebServiceURL

http[s]://host:port/report 的格式指定 Web 服务 URL。

示例:

WebServiceURL=http://localhost:10053/report

仅在非 TLS(HTTP)连接中可以省略 http:// 协议;配置了 TLS 时,必须使用 https://