1 Zabbix server
概述
本节列出了 Zabbix 服务器配置文件 (zabbix_server.conf) 支持的参数。
这些参数仅列出名称,不包含附加信息。 点击参数可查看完整详情。
| Parameter | Description |
|---|---|
| AlertScriptsPath | 自定义告警脚本的位置。 |
| AllowRoot | 允许服务器以 'root' 身份运行。 |
| AllowSoftwareUpdateCheck | 允许 Zabbix 前端从 zabbix.com 接收有关软件更新的信息。 |
| AllowUnsupportedDBVersions | 允许服务器与不受支持的数据库版本配合工作。 |
| CacheSize | 配置缓存的大小。 |
| CacheUpdateFrequency | 此参数决定 Zabbix 更新配置缓存的频率,单位为秒。 |
| DBHost | Zabbix 数据库的主机(或套接字目录)。 |
| DBName | 数据库名称。 |
| DBPassword | 数据库密码。 |
| DBPort | Zabbix 数据库主机的端口。 |
| 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 | 用于以换行分隔 JSON 格式实时导出事件、历史数据和趋势数据的目录。若设置此项,则会启用实时导出。 |
| ExportFileSize | 每个导出文件的最大大小,单位为字节。 |
| ExportType | 用于实时导出的实体类型列表,以逗号分隔(默认包含所有类型:events、history、trends)。 |
| ExternalScripts | 外部脚本的位置。 |
| Fping6Location | fping6 的位置。 |
| FpingLocation | fping 的位置。 |
| HANodeName | 高可用集群节点名称。 |
| HistoryCacheSize | 历史缓存的大小。 |
| HistoryIndexCacheSize | 历史索引缓存的大小。 |
| HistoryStorageDateIndex | 启用对历史存储中的历史值进行预处理,以便根据日期将值存储到不同索引中。 |
| HistoryStorageURL | 历史存储的 HTTP[S] URL。 |
| HistoryStorageTypes | 要发送到历史存储的值类型列表,以逗号分隔。 |
| HousekeepingFrequency | 此参数决定 Zabbix 执行清理过程的频率,单位为小时。 |
| 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 | 在一个清理周期中的一个任务里,删除的行数不会超过 'MaxHousekeeperDelete' 行(对应 [tablename]、[field]、[value])。 |
| NodeAddress | 用于覆盖前端连接服务器方式的 IP 或主机名,可选带端口。 |
| PidFile | PID 文件名。 |
| ProblemHousekeepingFrequency | 决定 Zabbix 删除已删除触发器对应问题的频率。 |
| ProxyConfigFrequency | 决定 Zabbix 服务器向 Zabbix proxy 发送配置数据的频率。 |
| ProxyDataFrequency | 决定 Zabbix 服务器向 Zabbix proxy 请求历史数据的频率。 |
| ServiceManagerSyncFrequency | 决定 Zabbix 同步服务管理器配置的频率。 |
| SMSDevices | 允许 Zabbix 服务器使用的调制解调器文件列表,以逗号分隔。 |
| SNMPTrapperFile | 用于将数据从 SNMP trap 守护进程传递到服务器的临时文件。 |
| SocketDir | 用于存储内部 Zabbix 服务所使用的 IPC 套接字的目录。 |
| SourceIP | 源 IP 地址。 |
| SSHKeyLocation | 用于 SSH 检查和操作的公钥与私钥位置。 |
| SSLCertLocation | 用于客户端身份验证的 SSL 客户端证书文件位置。 |
| SSLKeyLocation | 用于客户端身份验证的 SSL 私钥文件位置。 |
| SSLCALocation | 覆盖用于 SSL 服务器证书验证的证书颁发机构(CA)文件位置。 |
| StartAgentPollers | 预先 fork 的异步 Zabbix agent poller 实例数量。 |
| StartAlerters | 预先 fork 的 alerter 实例数量。 |
| StartBrowserPollers | 预先 fork 的浏览器监控项 poller 实例数量。 |
| StartConnectors | 预先 fork 的连接器 worker 实例数量。 |
| StartDBSyncers | 预先 fork 的历史同步器实例数量。 |
| StartDiscoverers | 预先 fork 的发现 worker 实例数量。 |
| StartEscalators | 预先 fork 的 escalator 实例数量。 |
| StartHistoryPollers | 预先 fork 的历史 poller 实例数量。 |
| StartHTTPAgentPollers | 预先 fork 的异步 HTTP agent poller 实例数量。 |
| StartHTTPPollers | 预先 fork 的 HTTP poller 实例数量。 |
| StartIPMIPollers | 预先 fork 的 IPMI poller 实例数量。 |
| StartJavaPollers | 预先 fork 的 Java poller 实例数量。 |
| StartLLDProcessors | 预先 fork 的低级别发现(LLD)worker 实例数量。 |
| StartODBCPollers | 预先 fork 的 ODBC poller 实例数量。 |
| StartPingers | 预先 fork 的 ICMP pinger 实例数量。 |
| StartPollersUnreachable | 用于不可达主机的 poller 预先 fork 的实例数量(包括 IPMI 和 Java)。 |
| StartPollers | 预先 fork 的 poller 实例数量。 |
| StartPreprocessors | 预先启动的预处理 worker 实例数量。 |
| StartProxyPollers | 用于被动 proxy 的 poller 预先 fork 的实例数量。 |
| StartReportWriters | 预先 fork 的报告写入器实例数量。 |
| StartSNMPPollers | 预先 fork 的异步 SNMP poller 实例数量。 |
| StartSNMPTrapper | 如果设置为 1,将启动 SNMP trapper 进程。 |
| StartTimers | 预先 fork 的定时器实例数量。 |
| StartTrappers | 预先 fork 的 trapper 实例数量。 |
| StartVMwareCollectors | 预先 fork 的 VMware 收集器实例数量。 |
| StatsAllowedIP | 允许的 IP 地址列表,以逗号分隔,可选使用 CIDR 表示法,或外部 Zabbix 实例的 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 组件之间的加密通信。 |
| TLSKeyFile | 包含服务器私钥的文件完整路径,用于 Zabbix 组件之间的加密通信。 |
| TmpDir | 临时目录。 |
| TrapperTimeout | 指定以下操作的超时时间,单位为秒: - 从 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 服务器的 HTTP[S] URL。 |
| VMwareCacheSize | 用于存储 VMware 数据的共享内存大小。 |
| VMwareFrequency | 从单个 VMware 服务采集数据之间的延迟,单位为秒。 |
| VMwarePerfFrequency | 从单个 VMware 服务检索性能计数器统计信息之间的延迟,单位为秒。 |
| VMwareTimeout | vmware collector 等待 VMware 服务响应的最长时间,单位为秒。 |
| WebDriverURL | WebDriver 接口的 HTTP[S] URL。 |
| WebServiceURL | Zabbix web 服务的 HTTP[S] URL,格式为 <host:port>/report。 |
除非明确说明参数为必填项,否则所有参数均为非必填。
请注意:
- 默认值反映的是守护进程默认值,而不是随软件包提供的配置文件中的值;
- Zabbix 仅支持 UTF-8 编码且不含 BOM 的配置文件;
- 以 "#" 开头的注释仅支持出现在行首。
参数详情
AlertScriptsPath
自定义告警脚本 的位置(取决于编译时安装变量 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
Zabbix 数据库的主机(或 socket 目录)。
对于 MySQL:
localhost或空字符串会使用默认的 UNIX 域 socket。
对于 PostgreSQL:
localhost会通过 DNS 解析(通常解析为 127.0.0.1)。- 空字符串会使用默认的 UNIX 域 socket。
- 路径(例如
/var/run/pgbouncer)会使用该路径下的 UNIX socket。 - 以逗号分隔的列表可以包含多个
host:port值。系统会按顺序尝试每个主机,直到建立读写连接。 示例:DBHost=localhost:5431,127.0.0.1:20051,zabbix.domain,[::1]:30051,[12fc::1]
对于 Oracle,空字符串会使用 Net Service Name 连接方式;在这种情况下,建议使用 TNS_ADMIN 环境变量来指定 tnsnames.ora 文件所在目录。
默认值:localhost
DBName
数据库名称。
对于 Oracle,如果使用 Net Service Name 连接方式,请指定 tnsnames.ora 中的服务名,或者将其设置为空字符串;如果 DBName 设置为空字符串,请设置 TWO_TASK 环境变量。
必填:是
DBPassword
数据库密码。 如果未使用密码,请注释此行。
DBPort
Zabbix 数据库主机的端口(参见 DBHost)。3
对于 Oracle,如果使用 Net Service Name 连接方式,则会忽略此参数;将改用 tnsnames.ora 文件中的端口号。
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,支持以下值:required、verify_ca、verify_full。
对于 MariaDB,从 10.2.6 版本开始,支持required和verify_full值。
默认情况下不设置任何选项,具体行为取决于数据库配置。
DBTLSCAFile
一个包含用于数据库证书验证的Top级别CA证书的file完整路径名。
必选:否(当DBTLSConnect设置为verify_ca或verify_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 服务器上启用全局脚本。
注意:全局脚本执行默认已启用。
但是,对于从 Zabbix 7.0 开始的新安装,EnableGlobalScripts 会显式设置为 0(禁用)。
默认值:1
取值:0 - 禁用;1 - 启用
ExportDir
存储事件、历史和趋势数据的新行分隔JSON格式的real-time export目录 如果设置,将启用实时export。
ExportFileSize
每个exportfile的最大大小(以字节为单位)。
如果设置了ExportDir,则用于轮换。
默认值:1G
范围:1M-1G
ExportType
用于 实时导出 的以逗号分隔的实体类型列表(默认包含所有类型:events、history、trends)。
仅当设置了 ExportDir 时才有效。
注意:如果指定了 ExportType,但未指定 ExportDir,则这是一个配置错误,服务器将无法启动。
history 和 trends 导出的示例:
ExportType=history,trends
仅导出 event 的示例:
ExportType=events
ExternalScripts
外部脚本的位置(取决于编译时安装变量datadir)。
默认值:/usr/local/share/zabbix/externalscripts
Fping6Location
fping6 的位置。
请确保 fping6 二进制文件的所有者为 root,并已设置 SUID 标志。
如果您的 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 执行 housekeeping 过程的频率,单位为小时。
housekeeping 是从数据库中删除过期信息的过程。
注意:为防止 housekeeper 负载过高(例如,当历史数据和趋势数据保留周期大幅缩短时),在每个 housekeeping 周期中,每个监控项删除的过期信息不会超过 HousekeepingFrequency 小时对应的 4 倍。
因此,如果 HousekeepingFrequency 为 1,则每个周期最多删除 4 小时的过期信息(从最早的记录开始)。
注意:为降低服务器启动时的负载,housekeeping 会在服务器启动后延迟 30 分钟执行。
因此,如果 HousekeepingFrequency 为 1,服务器启动后的第一次 housekeeping 过程将在 30 分钟后运行,此后每隔 1 小时重复执行。
可以通过将 HousekeepingFrequency 设置为 0 来禁用自动 housekeeping。
在这种情况下,housekeeping 过程只能通过 housekeeper_execute 运行时控制选项启动,并且在一个 housekeeping 周期中删除的过期信息时段为自上次 housekeeping 周期以来时间长度的 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
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
确定数据库query执行时间超过多少毫秒会被记录。
0 - 不记录慢queries。
该选项在DebugLevel=3及以上级别生效。
默认值:0
范围:0-3600000
LogType
日志输出类型:
- file - 将日志写入由
LogFile参数指定的文件; - system - 将日志写入 syslog;
- console - 将日志写入标准输出。
默认值:file
MaxConcurrentChecksPerPoller
每个HTTP agent轮询器、agent轮询器或SNMP轮询器可同时执行的最大异步检查数量。 参见StartHTTPAgentPollers、StartAgentPollers和StartSNMPPollers。
默认值: 1000
范围: 1-1000
MaxHousekeeperDelete
在一个 housekeeping 周期中,每个任务最多删除 'MaxHousekeeperDelete' 行(对应于 [tablename]、[field]、[value])。
如果设置为 0,则完全不使用限制。
在这种情况下,你必须清楚自己在做什么,以免使数据库过载。2
此参数仅适用于删除已被删除的监控项遗留的数据。
默认值:5000
范围:0-1000000
NodeAddress
用于覆盖前端应如何连接到服务器的 IP 或主机名,可选带端口。
格式:<address>[:<port>]
如果未设置 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 轮询器 的预 fork 实例数量。
参见 MaxConcurrentChecksPerPoller。
默认值:1
范围:0-1000
StartAlerters
alerters 的预 fork 实例数量。
默认值:3
范围:1-100
StartBrowserPollers
浏览器监控项 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
默认值:5
范围:0-1000
StartEscalators
escalators 的预 fork 实例数量。
默认值:1
范围:1-100
StartHistoryPollers
history pollers 的预 fork 实例数量。
仅在计算型检查中需要。
默认值:5
范围:0-1000
StartHTTPAgentPollers
HTTP agent 轮询器 的预 fork 实例数量。 参见 MaxConcurrentChecksPerPoller。
默认值:1
范围:0-1000
StartHTTPPollers
HTTP pollers1 的预 fork 实例数量。
默认值:1
范围:0-1000
StartIPMIPollers
IPMI pollers 的预 fork 实例数量。
默认值:0
范围:0-1000
StartJavaPollers
Java pollers 的预 fork 实例数量1。
默认值: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。
如果已启动常规、IPMI 或 Java poller,则必须至少运行一个不可达主机的 poller。
默认值: 1
范围: 0-1000
StartPollers
默认值:5
范围:0-1000
预启动预处理器
预启动的预处理 worker1 线程数量应设置为不小于可用 CPU 核心数。 如果预处理不受 CPU 限制且包含大量网络请求,则应设置更多 worker。
默认值:16(Zabbix 7.0.6 之前:3)
范围:1-1000
StartProxyPollers
用于被动 proxy 的 poller1 的预 fork 实例数量。
默认值:1
范围:0-250
StartReportWriters
报告写入器 的预 fork 实例数量。
如果设置为 0,则会禁用计划报告生成。
当启动报告写入器时,report manager 进程会自动启动。
默认值:0
范围:0-100
StartSNMPPollers
SNMP pollers 的预 fork 实例数量。 参见 MaxConcurrentChecksPerPoller。
默认值:1
范围:0-1000
StartSNMPTrapper
如果设置为 1,将启动一个 SNMP trapper 进程。
默认值: 0
范围: 0-1
StartTimers
计时器 的预 fork 实例数量。
计时器进程负责维护周期。
默认值:1
范围:1-1000
StartTrappers
trappers1 的预 fork 实例数量。
Trappers 接受来自 Zabbix sender、active agent 和 active proxy 的传入连接。
默认值:5
范围:0-1000
StartVMwareCollectors
预先 fork 的 VMware collector 实例数量。
默认值: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
超时
指定建立与 Zabbix proxy、agent、web 服务以及旧版 SNMP 检查(单个 OID 编号或字符串)连接并交换数据时的等待时间(秒)。
此参数定义了多种通信操作的持续时间:
- 在 Zabbix agent 上执行远程命令
- SSH/Telnet 命令执行
- 向 Zabbix web 服务发起请求
- 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
一个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
指定 vault 提供程序:
- HashiCorp - HashiCorp KV Secrets Engine 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私钥file名称。
私钥file必须采用PEM1格式。
包含此file的目录由配置参数SSLKeyLocation指定。
该选项可省略,但对于CyberArkCCP保险库建议配置。
VaultToken
应专门为 Zabbix 服务器生成的 HashiCorp Vault 身份验证令牌,该令牌应仅对 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 请注意,过多的数据采集进程(pollers、unreachable pollers、ODBC pollers、HTTP pollers、Java pollers、pingers、trappers、proxypollers)以及 IPMI manager、SNMP trapper、预处理 worker 和发现 worker,可能会耗尽预处理 manager 的每进程文件描述符限制。
耗尽文件描述符限制会导致 Zabbix 服务器停止,通常会在启动后不久发生,但有时也可能需要更长时间。 为避免此类问题,请查看 Zabbix 服务器配置文件,以优化并发检查和进程数量。 此外,如有必要,请通过检查和调整系统限制,确保文件描述符限制设置得足够高。
2 当删除大量监控项时,会增加数据库负载,因为 housekeeper 需要删除这些监控项所拥有的所有历史数据。
例如,如果我们只需要从模板中删除 1 个监控项原型,但该模板已链接到 50 个主机,并且对于每个主机,该原型都会展开为 100 个实际监控项,那么总共需要删除 5000 个监控项(1*50*100)。
如果将 500 设置为 MaxHousekeeperDelete(MaxHousekeeperDelete=500),则 housekeeper 进程在一个周期内需要从历史和趋势表中删除最多 2500000 个值(5000*500)。
3 DBSocket 和 DBPort 在服务器配置中互斥。
请只指定其中一个,或者将两者都留空。