这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

1 Zabbix server

概述

本节列出了Zabbix server配置文件file(zabbix_server.conf)支持的参数。

参数列表不包含额外信息。 点击参数可查看完整详情。

参数 描述
AlertScriptsPath 自定义告警脚本的位置。
AllowRoot 允许服务器以'root'身份run。
AllowSoftwareUpdateCheck 允许Zabbix UI从zabbix.com接收软件更新信息。
AllowUnsupportedDBVersions 允许服务器使用不受支持的数据库版本。
CacheSize configuration cache的大小。
CacheUpdateFrequency 该参数决定Zabbix执行configuration cacheupdate的频率(秒)。
DBHost 数据库主机名。
DBName 数据库名称。
DBPassword 数据库密码。
DBPort 不使用本地套接字时的数据库端口。
DBSchema 数据库模式名称(用于PostgreSQL)。
DBSocket MySQL套接字file的路径。
DBUser 数据库用户。
DBTLSConnect 将此选项设置为指定值将强制使用TLS连接数据库。
DBTLSCAFile 包含Top级CA证书的file的完整路径名,用于数据库证书验证。
DBTLSCertFile 包含Zabbix server证书的file的完整路径名,用于数据库认证。
DBTLSKeyFile 包含私钥的file的完整路径名,用于数据库认证。
DBTLSCipher Zabbix server允许的TLS v1.2及以下协议的加密密码列表(仅MySQL支持)。
DBTLSCipher13 Zabbix server允许的TLS v1.3协议的加密套件列表(仅MySQL支持,从version 8.0.16开始)。
DebugLevel 指定调试级别。
EnableGlobalScripts 在Zabbix server上启用全局脚本。
ExportDir 用于实时export事件、历史和趋势数据的目录(以换行符分隔的JSON格式)。设置后将启用实时export。
ExportFileSize 每个exportfile的最大大小(字节)。
ExportType 实时export的逗号分隔实体类型列表(默认为所有类型:events, history, trends)。
ExternalScripts 外部脚本的位置。
Fping6Location fping6的位置。
FpingLocation fping的位置。
HANodeName 高可用集群节点名称。
HistoryCacheSize history cache的大小。
HistoryIndexCacheSize 历史index cache的大小。
HistoryStorageDateIndex 启用历史存储中历史值的预处理,根据日期将值存储到不同的indices。
HistoryStorageURL 历史存储HTTP[S] URL。
HistoryStorageTypes 要发送到历史存储的值类型的逗号分隔列表。
HousekeepingFrequency 该参数决定Zabbix执行housekeeping程序的频率(小时)。
Include 可以在配置file中包含单个文件或目录中的所有文件。
JavaGateway Zabbix Java网关的IP地址(或主机名)。
JavaGatewayPort Zabbix Java网关监听的端口。
ListenBacklog TCP队列中待处理连接的最大数量。
ListenIP trapper应监听的逗号分隔IP地址列表。
ListenPort trapper的监听端口。
LoadModule 服务器启动时加载的模块。
LoadModulePath 服务器模块位置的完整路径。
LogFile 日志file的名称。
LogFileSize 日志file的最大大小。
LogSlowQueries 确定数据库query在被记录前允许的最长时间(毫秒)。
LogType 日志输出的类型。
MaxConcurrentChecksPerPoller 每个HTTPagent轮询器、agent轮询器或SNMP轮询器一次可执行的异步检查的最大数量。
MaxHousekeeperDelete 每个housekeeping周期中,每个任务删除的行数(对应[表名],[字段],[值])不超过'MaxHousekeeperDelete'。
NodeAddress 带有可选端口的IP或主机名,用于覆盖前端如何连接到服务器。
PidFile PIDfile的名称。
ProblemHousekeepingFrequency 确定Zabbixdelete已删除触发器问题的频率。
ProxyConfigFrequency 确定Zabbix server向Zabbix proxy发送配置数据的频率。
ProxyDataFrequency 确定Zabbix server从Zabbix proxy请求历史数据的频率。
ServiceManagerSyncFrequency 确定Zabbix同步服务管理器配置的频率。
SMSDevices 允许使用Zabbix server的逗号分隔调制解调器文件列表。
SNMPTrapperFile 用于从SNMP trap守护进程向服务器传递数据的临时file。
SocketDir 存储Zabbix内部服务使用的IPC套接字的目录。
SourceIP 源IP地址。
SSHKeyLocation SSH检查和操作使用的公钥和私钥位置。
SSLCertLocation 用于客户端认证的SSL客户端证书文件位置。
SSLKeyLocation 用于客户端认证的SSL私钥文件位置。
SSLCALocation 覆盖用于SSL服务器证书验证的证书颁发机构(CA)文件位置。
StartAgentPollers 异步Zabbix agent轮询器的预派生实例数量。
StartAlerters 告警器的预派生实例数量。
StartBrowserPollers 浏览器监控项轮询器的预派生实例数量。
StartConnectors 连接器工作进程的预派生实例数量。
StartDBSyncers 历史同步器的预派生实例数量。
StartDiscoverers 发现工作进程的预派生实例数量。
StartEscalators 升级器的预派生实例数量。
StartHistoryPollers 历史轮询器的预派生实例数量。
StartHTTPAgentPollers 异步HTTPagent轮询器的预派生实例数量。
StartHTTPPollers HTTP轮询器的预派生实例数量。
StartIPMIPollers IPMI轮询器的预派生实例数量。
StartJavaPollers Java轮询器的预派生实例数量。
StartLLDProcessors 低级发现(LLD)工作进程的预派生实例数量。
StartODBCPollers ODBC轮询器的预派生实例数量。
StartPingers ICMP ping器的预派生实例数量。
StartPollersUnreachable 不可达主机(包括IPMI和Java)轮询器的预派生实例数量。
StartPollers 轮询器的预派生实例数量。
StartPreprocessors 预处理工作进程的预启动实例数量。
StartProxyPollers 被动proxies轮询器的预派生实例数量。
StartReportWriters 报告写入器的预派生实例数量。
StartSNMPPollers 异步SNMP轮询器的预派生实例数量。
StartSNMPTrapper 如果设置为1,将启动SNMP trap进程。
StartTimers 定时器的预派生实例数量。
StartTrappers trap接收器的预派生实例数量。
StartVMwareCollectors VMware收集器的预派生实例数量。
StatsAllowedIP 逗号分隔的IP地址列表(可选CIDR表示法)或外部Zabbix实例的DNS名称。仅接受来自此处列出地址的统计请求。
Timeout 指定与Zabbix proxy、agent、web服务建立连接和交换数据的等待时间(秒),以及SNMP检查(SNMPwalk[OID]get[OID]监控项除外)和icmpping[*]监控项的等待时间。
TLSCAFile 包含Top级CA证书的file的完整路径名,用于Zabbix组件间加密通信的对等证书验证。
TLSCertFile 包含服务器证书或证书链的file的完整路径名,用于Zabbix组件间的加密通信。
TLSCipherAll GnuTLS优先级string或OpenSSL(TLS 1.2)密码string。覆盖基于证书和PSK加密的默认密码套件选择标准。
TLSCipherAll13 OpenSSL 1.1.1或更新版本在TLS 1.3中的密码string。覆盖基于证书和PSK加密的默认密码套件选择标准。
TLSCipherCert GnuTLS优先级string或OpenSSL(TLS 1.2)密码string。覆盖基于证书加密的默认密码套件选择标准。
TLSCipherCert13 OpenSSL 1.1.1或更新版本在TLS 1.3中的密码string。覆盖基于证书加密的默认密码套件选择标准。
TLSCipherPSK GnuTLS优先级string或OpenSSL(TLS 1.2)密码string。覆盖基于PSK加密的默认密码套件选择标准。
TLSCipherPSK13 OpenSSL 1.1.1或更新版本在TLS 1.3中的密码string。覆盖基于PSK加密的默认密码套件选择标准。
TLSCRLFile 包含吊销证书的file的完整路径名。该参数用于Zabbix组件间的加密通信。
TLSKeyFile 包含服务器私钥的file的完整路径名,用于Zabbix组件间的加密通信。
TmpDir 临时目录。
TrapperTimeout 指定超时时间(秒):
- 从Zabbix proxy检索历史数据;
- 向Zabbix proxy发送配置数据;
- 在Zabbix server上执行全局脚本或远程命令。
TrendCacheSize trend cache的大小。
TrendFunctionCacheSize 趋势函数缓存的大小。
UnavailableDelay 确定在不可用期间检查主机可用性的频率。
UnreachableDelay 确定在不可达期间检查主机可用性的频率。
UnreachablePeriod 确定在多少秒不可达后将一个主机视为不可用。
User 将权限降级为系统上特定的现有用户。
ValueCacheSize 历史value cache的大小。
Vault 指定保险库提供程序。
VaultDBPath 指定通过密钥检索数据库凭据的位置。
VaultPrefix 保险库路径或query的自定义前缀。
VaultTLSCertFile 用于客户端认证的SSL证书file名称。
VaultTLSKeyFile 用于客户端认证的SSL私钥file名称。
VaultToken HashiCorp保险库认证令牌。
VaultURL 保险库服务器HTTP[S] URL。
VMwareCacheSize 用于存储VMware数据的共享memory大小。
VMwareFrequency 从单个VMware服务收集数据之间的延迟(秒)。
VMwarePerfFrequency 从单个VMware服务检索性能计数器统计信息之间的延迟(秒)。
VMwareTimeout vmware收集器等待VMware服务响应的最长时间(秒)。
WebDriverURL WebDriver接口HTTP[S] URL。
WebServiceURL Zabbix web服务的HTTP[S] URL,格式为<主机:端口>/report。

除非明确说明参数是强制性的,否则所有参数都是非强制性的。

注意:

  • 默认值反映守护进程默认值,而非配置文件中提供的值;
  • Zabbix仅支持UTF-8编码的配置文件,不带BOM
  • 以"#"开头的注释仅在行首有效。

参数详情

AlertScriptsPath

custom alert scripts的位置(取决于编译时安装变量datadir)。

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

AllowRoot

允许服务器以'root'用户身份run。 如果禁用且服务器由'root'启动,服务器将尝试切换至'zabbix'用户。 若以普通用户启动则无效。

默认值: 0
可选值: 0 - 不允许; 1 - 允许

AllowSoftwareUpdateCheck

允许Zabbix UI从zabbix.com接收软件更新信息

默认值: 1
可选值: 0 - 不允许; 1 - 允许

AllowUnsupportedDBVersions

允许服务器与不受支持的数据库版本协同工作

默认值: 0
可选值: 0 - 不允许; 1 - 允许

CacheSize

configuration cache的大小,以字节为单位。 用于存储主机、监控项及触发器数据的共享memory大小

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

CacheUpdateFrequency

该参数决定Zabbix执行configuration cacheupdate的频率(以秒为单位)。 另请参阅运行时控制选项。

默认值:10
范围:1-3600

DBHost

数据库主机名.
对于MySQL localhost或空string将使用套接字连接. 对于PostgreSQL 只有空string会尝试使用套接字连接. 对于连接建立 空string将使用Net服务名连接方式; 这种情况下建议使用TNS_ADMIN环境变量来指定tnsnames.orafile的目录.

默认值: localhost

DBName

数据库名称。
使用连接建立时,若采用Net Service Name连接方式,需指定tnsnames.ora中的服务名或设为空string;若DBName设为空string,需设置TWO_TASK环境变量。

必填项:是

DBPassword

数据库密码。 如果未使用密码,请注释此行。

DBPort

当不使用本地套接字时的数据库端口。3
使用连接建立时,如果采用Net Service Name连接方式,此参数将被忽略;将改用tnsnames.orafile中的端口号。

MySQL默认值:3306

PostgreSQL默认值:5432

范围:1024-65535

DBSchema

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

DBSocket

MySQL套接字路径file.3

DBUser

数据库用户。

DBTLSConnect

将此选项设置为以下值将强制使用TLS连接数据库:
required - 使用TLS连接
verify_ca - 使用TLS连接并验证证书
verify_full - 使用TLS连接,验证证书并验证DBHost指定的数据库身份与其证书匹配

对于MySQL(从5.7.11开始)和PostgreSQL,支持以下值:requiredverify_caverify_full
对于mariadb(从version 10.2.6开始),支持requiredverify_full值。
默认情况下不设置任何选项,行为取决于数据库配置。

DBTLSCAFile

一个包含用于数据库证书验证的Top级别CA证书的file完整路径名。

必选:否(当DBTLSConnect设置为verify_caverify_full时为是)

DBTLSCertFile

包含用于数据库认证的Zabbix server证书的file完整路径名。

DBTLSKeyFile

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

DBTLSCipher

The list of encryption ciphers that Zabbix server permits for TLS protocols up through TLS v1.2. 仅支持MySQL。

DBTLSCipher13

Zabbix server允许用于TLS v1.3协议的加密套件列表 仅支持MySQL,从version 8.0.16版本开始。

DebugLevel

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

默认值:3
范围:0-5

EnableGlobalScripts

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

默认值:1
可选值:0 - 禁用;1 - 启用

ExportDir

存储事件、历史和趋势数据的新行分隔JSON格式的real-time export目录 如果设置,将启用实时export。

ExportFileSize

每个exportfile的最大大小(以字节为单位)。 如果设置了ExportDir,则用于轮换。

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

ExportType

real-time export设置的以逗号分隔的实体类型列表(events, history, trends),默认为所有类型。 仅在ExportDir设置时有效。
注意:如果指定了ExportType但未设置ExportDir,这将导致配置错误且服务器无法启动。

针对history和trends的export示例:

ExportType=history,trends

仅针对event的export示例:

ExportType=events
ExternalScripts

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

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

Fping6Location

fping6的位置。 确保fping6二进制文件具有root所有权并设置了SUID flag。 如果您的fping工具能够处理IPv6地址,请留空("Fping6Location=")。

默认值: /usr/sbin/fping6

FpingLocation

fping的安装路径。 确保fping二进制文件具有root所有权并设置了SUID flag。

默认值: /usr/sbin/fping

HANodeName

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

HistoryCacheSize

history cache的大小,以字节为单位。 用于存储历史数据的共享memory大小。

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

HistoryIndexCacheSize

历史数据index cache的大小,以字节为单位。 用于索引存储在history cache中的历史数据的共享memory大小。 index cache大小大约需要100字节来缓存一个监控项。

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

HistoryStorageDateIndex

在历史存储中启用历史值的预处理功能,根据日期将值存储到不同的indices中。

默认值:0
可选值:0 - 禁用;1 - 启用

HistoryStorageURL

历史存储HTTP[S] URL。 此参数用于Elasticsearch设置。

HistoryStorageTypes

发送至历史存储的数值类型逗号分隔列表 该参数用于Elasticsearch配置

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

HousekeepingFrequency

此参数决定Zabbix执行数据库清理程序的频率(以小时为单位)。 清理程序会从数据库中移除过时信息。
注意:为防止清理进程过载(例如当历史和趋势数据保留周期大幅缩短时),每次清理周期内每个监控项最多只删除相当于4倍HousekeepingFrequency时长的过时信息(从最旧的记录开始删除)。 因此若HousekeepingFrequency设为1,每个周期最多删除4小时的过时信息。
注意:为降低服务器启动时的负载,清理程序会在服务器启动后延迟30分钟执行。 因此若HousekeepingFrequency设为1,服务器启动后的首次清理将在30分钟后run,之后按1小时间隔重复执行。
通过将HousekeepingFrequency设为0可禁用自动清理功能。 此时只能通过housekeeper_execute运行时控制选项触发清理程序,且单次清理周期内删除的过时信息时长为上次清理至今时长的4倍(但不少于4小时且不超过4天)。
另见运行时控制选项。

默认值:1
范围:0-24

Include

您可以在配置file中包含单个文件或目录中的所有文件。 为了仅包含指定目录中的相关文件,支持使用星号通配符进行模式匹配。 有关限制,请参阅special notes

示例:

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

Zabbix Java网关的IP地址(或主机名)。 仅在启动Java轮询器时需要。

JavaGatewayPort

Zabbix Java网关监听的端口。

默认值:10052
范围:1024-32767

ListenBacklog

TCP队列中待处理连接的最大数量。
默认值为硬编码常量,具体取决于系统。
支持的最大值也取决于系统,过高的值可能会被静默截断为'实现指定的最大值'。

默认值:SOMAXCONN
范围:0 - INT_MAX

ListenIP

一个逗号分隔的IP地址列表,trapper应监听的地址。
如果未指定此参数,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

日志的名称file.

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

LogFileSize

日志file的最大大小(单位:MB)。
0 - 禁用自动日志轮转。
注意:如果日志file达到大小限制且file轮转失败(无论何种原因),现有日志file将被截断并重新开始记录。

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

LogSlowQueries

确定数据库query执行时间超过多少毫秒会被记录。
0 - 不记录慢queries。
该选项在DebugLevel=3及以上级别生效。

默认值:0
范围:0-3600000

LogType

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

默认值: file

MaxConcurrentChecksPerPoller

每个HTTP agent轮询器、agent轮询器或SNMP轮询器可同时执行的最大异步检查数量。 参见StartHTTPAgentPollersStartAgentPollersStartSNMPPollers

默认值: 1000
范围: 1-1000

MaxHousekeeperDelete

每个housekeeping周期内,每个任务删除的行数(对应[表名]、[字段]、[值])不得超过'MaxHousekeeperDelete'。
若设置为0则表示完全不限制。 此时您必须清楚操作后果,以避免overload the database! 2
此参数仅适用于删除已移除监控项的历史数据和趋势数据。

默认值:5000
取值范围:0-1000000

NodeAddress

用于覆盖前端如何连接服务器的IP地址或主机名(可选端口)。
格式:<地址>[:<端口>]

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

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

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

默认值:localhost:10051

PidFile

PID名称file.

默认值: /tmp/zabbix_server.pid

ProblemHousekeepingFrequency

确定Zabbix以秒为单位对已删除触发器的问题进行delete的频率.

默认值: 60
范围: 1-3600

ProxyConfigFrequency

确定Zabbix server向Zabbix proxy发送配置数据的频率(以秒为单位)。 仅适用于被动模式下的proxies。

默认值:10
范围:1-604800

ProxyDataFrequency

确定Zabbix server从Zabbix proxy请求历史数据的频率(以秒为单位)。 仅在被动模式下用于proxies。

默认值:1
范围:1-3600

ServiceManagerSyncFrequency

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

默认值:60
范围:1-3600

SMSDevices

允许使用Zabbix server的逗号分隔调制解调器文件列表 该参数自Zabbix 7.0.0版本起支持
若未设置此参数则无法发送SMS短信

示例:

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

用于从SNMP trap守护进程向服务器传递数据的临时file.
必须与zabbix_trap_receiver.pl或SNMPTT配置中的file保持一致.

默认值: /tmp/zabbix_traps.tmp

SocketDir

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

默认值:/tmp

SourceIP

源IP地址用于:

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

SSH检查与操作所需的公钥和私钥存放位置。

SSLCertLocation

用于客户端认证的SSL客户端证书文件位置。
此参数仅用于网页监控。

SSLKeyLocation

用于客户端认证的SSL私钥文件位置。
该参数仅用于网页监控。

SSLCALocation

覆盖用于SSL服务器证书验证的证书颁发机构(CA)文件位置。 若未设置,将使用系统全局目录。
注意该参数值将作为libcurl选项CURLOPT_CAPATH进行设置。 对于7.42.0之前的libcurl版本,仅当libcurl编译时使用OpenSSL才生效。 更多信息请参阅cURL web page
该参数用于Web监控和SMTP认证场景。

StartAgentPollers

预分叉的Zabbix agent实例数量服务器进程类型与线程。 参见MaxConcurrentChecksPerPoller

默认值:1
范围:0-1000

StartAlerters

预分叉实例数量 服务器进程类型与线程.

默认值: 3
范围: 1-100

StartBrowserPollers

浏览器 监控项 服务器进程类型与线程 的预派生实例数量.

默认值: 1
范围: 0-1000

StartConnectors

预分叉的服务器进程类型与线程实例数量. 当连接器工作进程启动时,连接器管理器进程会自动启动.

默认值: 0
范围: 0-1000

StartDBSyncers

服务器进程类型与线程的预派生实例数量。
注意: 修改此值需谨慎,增加该值可能弊大于利。 默认值通常足以处理约4000 NVPS的负载。

默认值: 4
范围: 1-100

StartDiscoverers

服务器进程类型与线程1的预派生实例数量

默认值:5
范围: 0-1000

StartEscalators

预分叉实例的数量服务器进程类型与线程.

默认值: 1
范围: 1-100

StartHistoryPollers

预分叉的服务器进程类型与线程实例数量。
仅计算型检查需要。

默认值:5
范围:0-1000

StartHTTPAgentPollers

HTTP agent 服务器进程类型与线程的预派生实例数量。 参见MaxConcurrentChecksPerPoller

默认值: 1
范围: 0-1000

StartHTTPPollers

服务器进程类型与线程1的预派生实例数量.

默认值: 1
范围: 0-1000

StartIPMIPollers

预分叉的服务器进程类型与线程实例数量.

默认值: 0
范围: 0-1000

StartJavaPollers

预分叉的服务器进程类型与线程1实例数量.

默认值: 0
范围: 0-1000

StartLLDProcessors

低级发现(LLD)服务器进程类型与线程1的预派生实例数量。
当启动LLD工作进程时,LLD管理器进程会自动启动。

默认值:2
范围:0-100

StartODBCPollers

服务器进程类型与线程1的预派生实例数量.

默认值: 1
范围: 0-1000

StartPingers

预分叉的服务器进程类型与线程1实例数量.

默认值: 1
范围: 0-1000

StartPollersUnreachable

预分叉的服务器进程类型与线程实例数量(包括IPMI和Java)1
如果启动了常规、IPMI或Java轮询器,则必须至少运行一个用于不可达主机的轮询器。

默认值:1
范围:0-1000

StartPollers

预分叉的服务器进程类型与线程1实例数量.

默认值: 5
范围: 0-1000

StartPreprocessors

预处理服务器进程类型与线程1线程的预启动实例数量应设置为不少于可用CPU核心数。 如果预处理不受CPU限制且有大量网络请求,则应设置更多工作线程。

默认值:16 (Zabbix 7.0.6之前版本:3)
范围:1-1000

StartProxyPollers

预分叉的服务器进程类型与线程1实例数量.

默认值: 1
范围: 0-250

StartReportWriters

服务器进程类型与线程的预派生实例数量。
如果设置为0,则禁用计划报告生成功能。
当启动报告写入器时,报告管理器进程会自动启动。

默认值: 0
范围: 0-100

StartSNMPPollers

SNMP预派生实例数量服务器进程类型与线程。 参见MaxConcurrentChecksPerPoller

默认值:1
范围:0-1000

StartSNMPTrapper

如果设置为1,将启动一个服务器进程类型与线程进程。

默认值:0
范围:0-1

StartTimers

服务器进程类型与线程的预派生实例数量。
定时器进程维护周期。

默认值:1
范围:1-1000

StartTrappers

服务器进程类型与线程1的预派生实例数量.
Trappers接收来自Zabbix sender、主动agents和主动proxies的传入连接.

默认值: 5
范围:1-1000

StartVMwareCollectors

预分叉的服务器进程类型与线程实例数量。

默认值:0
范围:0-250

StatsAllowedIP

以逗号分隔的IP地址列表(可选CIDR表示法)或外部Zabbix实例的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
Timeout

指定与Zabbix proxy、agent、Web服务、传统SNMP检查(单OID编号或string)以及icmpping[*] 监控项建立连接和交换数据的等待时间(秒)。

该参数定义以下各类通信操作的超时时长:

  • 在Zabbix agent上执行远程命令;
  • SSH/Telnet命令执行;
  • 向Zabbix Web服务发起的请求;
  • 媒介类型测试请求和history.push方法的通信超时;
  • IPMI接口不可用时监控项的重新调度;
  • 因权限或加密问题导致数据交换失败时向Zabbix proxy发送响应;
  • ICMP ping探测;
  • IPC异步套接字和运行时控制选项的截止时间;
  • JMX连接;
  • 从远程Zabbix proxy或服务器获取统计信息;
  • 向Zabbix前端发送响应;
  • 异步轮询器的DNS请求;
  • 主动检查心跳的响应;
  • 从主动agents获取Zabbix agent数据(值);
  • 从Zabbix sender获取数据;
  • trapper处理请求失败时的响应;
  • 向Zabbix agent发送主动检查列表。

该超时设置不适用于在前端(全局、proxy或单个监控项级别)具有可配置超时设置的检查项。例如,SNMP walk[OID]get[OID] 监控项使用前端配置的超时;传统SNMP检查仍使用服务器超时值。

默认值:3
取值范围:1-30

TLSCAFile

一个file的完整路径名,包含用于对等证书验证的Top级CA证书,用于Zabbix组件之间的加密通信。

TLSCertFile

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

TLSCipherAll

GnuTLS优先级string或OpenSSL(TLS 1.2)加密套件string。 覆盖基于证书和PSK加密的默认加密套件选择标准。

示例:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherAll13

OpenSSL 1.1.1或更高版本在TLS 1.3中使用的密码套件string。 覆盖基于证书和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优先级string或OpenSSL(TLS 1.2)加密套件string。 覆盖基于证书加密的默认加密套件选择标准。

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

OpenSSL 1.1.1或更高版本在TLS 1.3中使用的密码套件string。 覆盖基于证书加密的默认密码套件选择标准。

TLSCipherPSK

GnuTLS优先级string或OpenSSL(TLS 1.2)加密套件string。 覆盖基于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

OpenSSL 1.1.1或更高版本中TLS 1.3的密码套件string。 覆盖基于PSK加密的默认密码套件选择标准。

示例:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCRLFile

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

TLSKeyFile

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

TmpDir

临时目录。

默认值:/tmp

TrapperTimeout

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

  • 从Zabbix proxy获取历史数据;
  • 向Zabbix proxy发送配置数据;
  • 在Zabbix server上执行全局脚本或远程命令。

默认值:300
范围:1-300

TrendCacheSize

trend cache的大小,以字节为单位。
用于存储趋势数据的共享memory大小。

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

TrendFunctionCacheSize

趋势函数缓存的大小,以字节为单位。
用于缓存计算趋势函数数据的共享memory大小。

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

UnavailableDelay

确定在不可用接口周期内(以秒为单位)检查主机可用性的频率。

默认值:60
范围:1-3600

UnreachableDelay

确定在不可达接口期间(以秒为单位)检查主机可用性的频率。

默认值:15
范围:1-3600

UnreachablePeriod

确定在不可达接口持续多少秒后将一个主机视为不可用

默认值: 45
范围: 1-3600

User

将权限降级为系统中特定的现有用户。
仅当以'root'身份运行run且AllowRoot被禁用时生效。

默认值: zabbix

ValueCacheSize

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

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

Vault

指定密钥库提供商:
HashiCorp - HashiCorp KV密钥引擎 version 2
CyberArk - CyberArk中央凭据提供商
必须与前端设置的密钥库提供商匹配。

默认值:HashiCorp

VaultDBPath

根据Vault类型,用于通过密钥从数据库凭据存储路径或query获取数据库凭证的路径。

用于检索数据库凭据的密钥是'password'和'username'。

当VaultPrefix=/v1/secret/data/zabbix/时的示例路径:

database

未设置VaultPrefix时的示例路径:

secret/zabbix/database

用于数据库凭据的密钥是'Content'和'UserName'。

示例:

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

此选项仅在未指定DBUser和DBPassword时可用。

VaultPrefix

用于Vault路径或query的自定义前缀,具体取决于所使用的Vault类型。 若未指定,系统将自动采用最合适的默认值。
注意:对于HashiCorp Vault,若未指定VaultPrefix参数,系统会自动在挂载点后追加'data'。

HashiCorp示例前缀:

v1/secret/data/zabbix/

Cyberark示例前缀:

/AIMWebService/api/Accounts?
VaultTLSCertFile

用于客户端认证的SSL证书file名称
证书file必须为PEM1格式
若证书file已包含私钥,请将SSL密钥file字段留空
包含此file的目录由配置参数SSLCertLocation指定
该选项可省略,但推荐用于CyberArkCCP保险库

VaultTLSKeyFile

用于客户端认证的SSL私钥file名称。
私钥file必须采用PEM1格式。
包含此file的目录由配置参数SSLKeyLocation指定。
该选项可省略,但对于CyberArkCCP保险库建议配置。

VaultToken

专为Zabbix server生成的HashiCorp Vault认证令牌,该令牌应仅对配置中指定的路径具有只读权限,并对可选的VaultDBPath配置参数中指定的路径具有只读权限。
若同时定义VaultToken和VAULT_TOKEN环境变量将导致错误。

必填项:是(当Vault设置为HashiCorp时);否则为否

VaultURL

保险库服务器HTTP[S] URL。 若未指定SSLCALocation参数,将使用系统全局CA证书目录。

默认值:https://127.0.0.1:8200

VMwareCacheSize

用于存储VMware数据的共享memory大小。
可使用VMware内部检查项zabbix[vmware,buffer,...]来监控vmware cache使用情况(参见Internal checks)。
注意:如果未配置任何要启动的vmware采集器实例,则不会分配共享memory。

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

VMwareFrequency

从单个VMware服务收集数据之间的延迟时间(秒)。
该延迟应设置为任何VMware监控监控项的最小update间隔。

默认值:60
范围:10-86400

VMwarePerfFrequency

从单个VMware服务获取性能计数器统计数据的间隔秒数。 该延迟应设置为使用VMware性能计数器的任何VMware监控item中最小的update间隔。

默认值: 60
范围: 10-86400

VMwareTimeout

vmware采集器等待VMware服务(vCenter或ESX虚拟机监控程序)响应的最大秒数。

默认值:10
范围:1-300

WebServiceURL

Zabbix网页服务的HTTP[S] URL,格式为http[s]://host:port/report

示例:

WebServiceURL=http://localhost:10053/report

注意:仅非TLS(HTTP)连接时可省略协议头(http://);若配置了TLS,则必须使用https://

WebDriverURL

WebDriver接口HTTP[S] URL.

示例(与Selenium WebDriver独立服务器配合使用):

WebDriverURL=http://localhost:4444

脚注

1 注意,过多的数据采集进程(轮询器、不可达轮询器、ODBC轮询器、HTTP轮询器、Java轮询器、Ping检测器、捕获器、代理轮询器)与IPMI管理器、SNMP捕获器、预处理工作进程和发现工作进程一起运行,可能会耗尽预处理管理器每个进程的file描述符限制。

耗尽file描述符限制将导致Zabbix server停止,通常在启动后不久发生,但有时可能需要更长时间。 为避免此类问题,请查阅Zabbix server configuration file以优化并发检查和进程数量。 此外,如有必要,通过检查和调整系统限制,确保file描述符限制设置得足够高。

2 当大量监控项被删除时,会增加数据库负载,因为管家进程需要移除这些监控项的所有历史数据。 例如,如果我们只需要从模板中移除1个监控项原型,但该模板链接到50个主机,并且每个主机的原型会扩展为100个实际的监控项,那么总共需要移除5000个监控项(1*50*100)。 如果MaxHousekeeperDelete设置为500(MaxHousekeeperDelete=500),管家进程将需要在一个周期内从历史和趋势表中移除多达2500000条(5000*500)被删除监控项的值。

3 DBSocket和DBPort在服务器配置中是互斥的。 只能指定其中一个,或者两者都不定义。