2022 Zabbix中国峰会
2022 Zabbix中国峰会
Table of Contents

1 Zabbix server

默认值仅代表守护进程的默认值, 而不是已加载的配置文件中的值.

Zabbix服务端支持的参数如下:

参数 必 范围 默认值 描述
AlertScriptsPath usr/local/share/zabbix/alertscripts 定义报警脚本位置 (依赖编译安装时的参数设置 datadir).
AllowRoot 许服务器以 'root'身份运行. 如果禁止,并且服务器仍以root身份启动,服务端会切换到用户 'zabbix' 。 对于以普通用户启动的,该参数没什么影响。
0 - 禁止
1 - 允许
Zabbix 2.2.0.以后的版本都支持这个参数
CacheSize no 128K-8G 8M 缓存大小, 单位字节.
用于存储主机、监控项、触发器数据的共享内存大小.
Zabbix2.2.3版本前最大可配置值为2GB。
CacheUpdateFrequency no 1-3600 60 Zabbix 缓存更新频率, 单位秒.
另外参考 runtime control options.
DBHost no localhost 数据库主机名.
如果是 localhost 或 空字符串 会使用 socket. 如果是 PostgreSQL
只有空字符串会使用 socket.
DBName yes 数据库名称.
对于 SQLite3 必须提供数据库文件路径. 数据库用户名和密码可以忽略.
DBPassword no 数据库登陆密码. SQLite可忽略.
如果没有密码请注释掉此行.
DBPort no 1024-65535 3306 不适用本地 socket时的数据库连接端口. 如果使用 SQLite请忽略此项.
DBSchema no Schema 名字. IBM DB2 和 PostgreSQL使用.
DBSocket no /tmp/mysql.sock MySQL socket的路径。
DBUser no 数据库用户名. SQLite可不需要.
DebugLevel no 0-5 3 指定调试等级:
0 - Zabxxi进程起停的基本信息
1 - 重要信息
2 - 错误信息
3 - 警告信息
4 - 调试 (产生大量信息)
5 - 扩展调试 (产生更多信息)
另外见 runtime control 选项.
ExternalScripts no /usr/local/share/zabbix/externalscripts 外部脚本位置 (依赖编译安装时的变量datadir).
Fping6Location no /usr/sbin/fping6 fping6路径.
确保fping6的宿主是root用户,并且设置了SUID。
如果使用fping6可以处理ipv6地址,就置空("Fping6Location=") .
FpingLocation no /usr/sbin/fping fping路径.
确保fping的宿主是root用户,并且设置了SUID!
HistoryCacheSize no 128K-2G 16M 历史缓存数据大小, 单位字节.
存储历史数据.
HistoryIndexCacheSize no 128K-2G 4M 历史索引缓存大小, 单位字节.
用于索引历史缓存中历史数据的共享内存大小.\\缓存一个item大概需要索引的大小为100字节.
该参数在Zabbix 3.0.0.后都支持
HousekeepingFrequency no 0-24 1 Zabbix 执行 housekeeping 的频率 (单位小时).
从数据库中删除过期的信息.
注意: 为了防止 housekeeper 过载 (例如, 当历史和趋势周期大大减小时), 对于每一个item,不会在一个housek周期内删除超过4倍HousekeepingFrequency 的过时信息. 因此, 如果 HousekeepingFrequency 是 1, 一个周期内不会删除超过4小时的过时信息 (starting from the oldest entry) .
备注: 为降低 server压力, housekeeping 延后 server启动30 分。 因此, 如果 HousekeepingFrequency 是1,serverg启动30分后执行第一次 housekeeping , 一小时后重复. Zabbix 2.4.0以后有了这种延迟行为.
从Zabbix 3.0.0开始,可以设置HousekeepingFrequency为0来禁止自动housekeeping. 此时 housekeeping 只能通过 housekeeper_execute 启动, 在一个housuekeeping周期内删除的过时信息的周期是最后一次housekeeping以来的时间的4倍,不少于4小时不大于4天.
也可参见允许g控制 选项.
Include no 可以在配置文件中指定单个文件或者指定一个目录(所有文件在该目录中).
只有在指定的目录中包含相关文件, 才可以使用正则匹配的通配符. 例如: /absolute/path/to/config/files/*.conf. Zabbix 2.4.0后都支持模式匹配.
参看关于限制条件特例.
JavaGateway no Zabbix Java 网关的IP 地址 (或主机名) .
Java 轮询器启动时才需要该参数.
Zabbix 2.0.0后的所有版本支持该参数.
JavaGatewayPort no 1024-32767 10052 Zabbix Java 网关监听端口.
Zabbix 2.0.0后的所有版本支持该参数。
ListenIP no 0.0.0.0 监听的Ip地址,多个Ip用逗号分开.
如果没有该参数,会监听所有网络接口.
Zabbix 1.8.3支持多Ip地址.
ListenPort no 1024-32767 10051 监听端口.
LoadModule no server端启动时加载的模块,这些模块用来扩展server的功能。
格式: LoadModule=<module.so>
这些模块必须在LoadModulePath参数指定的路径中.
允许多个 LoadModule 参数.
LoadModulePath no server 模块路径.
默认值在编译时指定.
LogFile yes, if LogType is set to file, otherwise
no
日志文件名称.
LogFileSize no 0-1024 1 日志文件大小,单位 MB.
0 - 禁止日志文件自动回滚.
注意: 如果日志文件达到限定的大小,文件回滚失败, 不管是什么原因, 现有的日志会被截断,并重新记录日志.
LogType no file 日志输出类型:
file - 写入LogFile 参数指定的日志文件中,
system - 写入Windows事件日志,
console - 控制台输出.
Zabbix 3.0.0后支持该参数
LogSlowQueries no 0-3600000 0 数据库查询时间,大于该时间会记入日志 (毫秒).
0 - 不记录慢查询日志.
DebugLevel=3时该选项可用.
Zabbix 1.8.2支持该参数
MaxHousekeeperDelete no 0-1000000 5000 一个housekeeping周期内,一个任务删除的最大行数 (相应的表名,字段名,值)。
SQLite3 不使用该参数, 删除所有相应的行。
如果设置为0,不再限制删除的行数,这种情况,你必须清楚自己在做什么!
Zabbix 1.8.2 以后支持该参数,仅删除已经删除的监控项的历史和趋势数据。
PidFile no /tmp/zabbix_server.pid PID文件名称.
ProxyConfigFrequency no 1-604800 3600 Zabbix server 多少秒向Zabbix proxy 发送一次配置数据,用于被动模式的proxies 。
Zabbix 1.8.3后支持该参数。
ProxyDataFrequency no 1-3600 1 Zabbix server 多少秒向Zabbix proxy请求一次历史数据, 用于被动模式的proxies。\\Zabbix 1.8.3后支持该参数。
SenderFrequency no 5-3600 30 Zabbix重新发送失败报警的频率 (单位秒).
SNMPTrapperFile no /tmp/zabbix_traps.tmp 临时文件, 用于传递 SNMP扑捉守护进程的数据给server.
必须和 zabbix_trap_receiver.pl或 SNMPTT 配置文件中的保持一致。
Zabbix 2.0.0后支持该参数。
SocketDir no /tmp Directory to 存储 IPC sockets的目录, Zabbix 内部服务直接通信使用.
SourceIP no 对外连接的源IP地址.
SSHKeyLocation no SSH检查和操作的公钥和私钥的位置。
SSLCertLocation no 用于客户端身份验证的SSL客户端证书文件的位置。
该参数只用于web监控,Zabbix 2.4后支持该参数。
SSLKeyLocation no 用于客户端身份验证的SSL 私钥文件的位置。
该参数只用于web监控,Zabbix 2.4后支持该参数。
SSLCALocation no 为SSL服务器证书验证覆盖证书颁发机构(CA)文件的位置。如果不设置,系统范围的目录将被使用。
注意,这个参数的值将被设置为libcurl选项curloptcapath, 在7.42.0之前的libcurl版本中,只有使用OpenSSL编译libcurl才会有效。 更多信息见 cURL 网页.
这个参数在Zabbix 2.4.0之后的web监控和自Zabbix 3.0.0之后的SMTP身份验证中使用。
StartDBSyncers no 1-100 4 数据库同步子进程的实例数量。
在版本1.8.5之前,上限是64。
这个参数在Zabbix 1.8.3之后得到了支持。
StartDiscoverers no 0-250 1 自动发现子进程实例个数。
1.8.5以前最大数值为255。
StartEscalators no 1-100 1 Number of pre-forked instances of escalators.
Zabbix 3.0.0后支持该参数。
StartHTTPPollers no 0-1000 1 HTTP 轮询器子进程实例个数。
1.8.5以前最大数值为255。
StartIPMIPollers no 0-1000 0 IPMI 轮询器子进程实例个数。
1.8.5以前最大数值为255。
StartJavaPollers no 0-1000 0 Java 轮询器子进程实例个数。
Zabbix 2.0.0后支持该参数。
StartPingers no 0-1000 1 ICMP pingers进程实例数量
1.8.5以前最大数值为255。
StartPollersUnreachable no 0-1000 1 不可达主机 (包括IPMI 和 Java)的轮询器实例数量。
从Zabbix 2.4.0开始,如果有规律的、IPMI或Java轮询器启动,那么至少有一个针对不可访问主机的轮询器必须运行。\\在版本1.8.5之前,上限是255。
这个参数在Zabbix 1.8.3之后得到了支持。
StartPollers no 0-1000 5 轮询器实例数量。
在版本1.8.5之前,上限是255。
StartProxyPollers no 0-250 1 被动 proxies的轮询器数量。
在版本1.8.5之前,上限是255。
这个参数在Zabbix 1.8.3之后得到了支持。
StartSNMPTrapper no 0-1 0 如果设置为1,则将启动SNMP trapper进程。
这个参数在Zabbix 2.0.0之后得到了支持。
StartTimers no 1-1000 1 计时器子进程实例数量。
计时器处理基于时间的触发器函数和维护周期。
只有第一个计时器进程处理维护周期
这个参数在Zabbix 2.2.0之后得到了支持。
StartTrappers no 0-1000 5 trappers进程实例数量。
Trappers接受来自Zabbix发送者、主动agents和主动proxies的传入连接。
至少要运行一个trapper进程来显示前端的服务器可用性和视图队列。
在版本1.8.5之前,上限是255。
StartVMwareCollectors no 0-250 0 vmware 采集器的子进程实例个数\\Zabbix 2.2.0后支持该参数。
Timeout no 1-30 3 agent, SNMP 设备或外部检查的超时时长(单位秒)。
TLSCAFile no 包含用于对等证书验证的顶级CA证书的文件的完整路径名, 用于加密Zabbix各组件间的通信。
Zabbix 3.0.0后支持该参数。
TLSCertFile no 包含证书(证书链)的文件的完整路径名, 用于加密Zabbix各组件间的通信。
Zabbix 3.0.0后支持该参数。
TLSCRLFile no 包含证书吊销的文件的完整路径名, 用于加密Zabbix各组件间的通信。
Zabbix 3.0.0后支持该参数。
TLSKeyFile no 包含私钥的文件的完整路径名,用于加密Zabbix各组件间的通信。
Zabbix 3.0.0后支持该参数。
TmpDir no /tmp 临时目录。
TrapperTimeout no 1-300 300 指定捕捉器处理新数据的时间。
TrendCacheSize no 128K-2G 4M 趋势缓存的大小,单位字节。
用于存储趋势数据的共享内存大小。
UnavailableDelay no 1-3600 60 不可用期间,主机多少秒检查一次是否可用。
UnreachableDelay no 1-3600 15 不可达期间 ,主机多少秒检查一次是否可用。
UnreachablePeriod no 1-3600 45 在多少秒 不可用 后,即视为主机不可用。
User no zabbix 降低权限为系统中存在的指定用户。
仅当系统以'root'身份运行且AllowRoot禁止时,该参数才起作用。
Zabbix 2.4.0后支持该参数。
ValueCacheSize no 0,128K-64G 8M 历史数据缓存大小, 单位bytes.
缓存item历史数据请求的共享内存大小.
0即禁止缓存 (不建议).
当缓存大小超过共享内存时,每5分钟会向服务器日志写入一条警告信息.
该参数 Zabbix 2.2.0以后的版本中都支持.
VMwareCacheSize no 256K-2G 8M 存储VMware数据的共享内存大小。
VMware内部检查[vmware,buffer,...] 可以用来监控VMware缓存使用情况 (参见 内部检查).
注意,如果没有配置好启动的vmware收集器实例,那么共享内存就不会被分配。\\这个参数在Zabbix 2.2.0之后得到了支持。
VMwareFrequency no 10-86400 60 在单个VMware服务的数据收集之间延迟几秒。
此延迟应该设置为任一VMware监视项的最小更新间隔。
这个参数在Zabbix 2.2.0之后得到了支持。
VMwarePerfFrequency no 10-86400 60 从一个VMware服务的性能计数器数据检索中延迟几秒。
该延迟应该设置为任一VMware监控的 监控项(使用VMware性能计数器)最小更新间隔。
Zabbix 2.2.9, 2.4.4后支持该参数。
VMwareTimeout no 1-300 10 vmware采集器等等 VMware 服务(vCenter or ESX 管理程序)响应的最大时长.
Zabbix 2.2.9, 2.4.4后支持该参数。

Zabbix 支持的配置文件是无BOM的utf-8编码.

注释只能在行的开头以 "#" 开始.