Table of Contents
2 Zabbix proxy
默认值仅代表守护进程的默认值, 而不是已加载的配置文件中的值.
Zabbix proxy支持的参数如下::
| Parameter | Mandatory | Range | Default | Description |
|---|---|---|---|---|
| AllowRoot | no | 0 | 允许 proxy 以 'root'身份运行. 如果禁止，但 proxy 仍以'root'身份启动, proxy 会切换为'zabbix' 用户. 对于普通用户启动的proxy，没有任何影响. 0 - 禁止 1 - 允许 Zabbix 2.2.0. 以后的版本都支持该参数 |
|
| CacheSize | no | 128K-8G | 8M | 配置缓存大小，单位字节 共享内存大小，用于存储主机和监控项数据 Zabbix 2.2.3的最大值为2GB |
| ConfigFrequency | no | 1-604800 | 3600 | proxyg从server端检索配置数据的频率，单位秒 。 主动proxy 参数， 被动 proxies忽略此项 (参看 ProxyMode 参数)。 |
| DBHost | no | localhost | 数据库主机名。 如果是 localhost 或 空字符串 会使用 socket， 如果是 PostgreSQL 只有空字符串会使用 socket。 |
|
| DBName | yes | 数据库名称。 对于 SQLite3 必须提供数据库文件路径. 数据库用户名和密码可以忽略。 警告: 不要尝试使用跟Zabbix server相同的数据库。 |
||
| DBPassword | no | 数据库登陆密码. SQLite可忽略 如果没有密码请注释掉此行. |
||
| DBSchema | no | Schema 名字. IBM DB2 和 PostgreSQL使用. | ||
| DBSocket | no | 3306 | MySQL socket的路径 数据库端口（不使用本地socket）， SQLiteg不使用该参数. |
|
| DBUser | 数据库用户名. SQLite可不需要. | |||
| DataSenderFrequency | no | 1-3600 | 1 | Proxy 每 N 秒向server端发送一次采集到的数据. 主动proxy 参数， 被动 proxies忽略此项 (参看 ProxyMode 参数)。 |
| DebugLevel | no | 0-5 | 3 | 指定调试等级: 0 - Zabxxi进程起停的基本信息 1 - 重要信息 2 - 错误信息 3 - 警告信息 4 - 调试 (产生大量信息) 5 - 扩展调试 (产生更多信息) |
| 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 | Location of fping. 确保fping的宿主是root用户，并且设置了SUID!! |
|
| HeartbeatFrequency | no | 0-3600 | 60 | 心跳消息的频率，单位秒 用于监视服务器端代理的可用性。 0 - 禁用心跳消息 主动proxy 参数，被动 proxies忽略此参数 (参见ProxyMode参数). |
| HistoryCacheSize | no | 128K-2G | 16M | 历史缓存数据大小, 单位字节 存储历史数据. |
| HistoryIndexCacheSize | no | 128K-2G | 4M | 历史索引缓存大小, 单位字节. 用于索引历史缓存中历史数据的共享内存大小. 缓存一个item大概需要索引的大小为100字节. 该参数在Zabbix 3.0.0.后都支持 |
| Hostname | no | Set by HostnameItem | 唯一的, 区分大小写的， 确保server端知道其g名称! 允许的符号: 字母数字, '.', ' ', '_' 和 '-'。 最大长度: 64 |
|
| HostnameItem | no | system.hostname | 如果主机名没有定义，该参数用来获得主机名 (和agent运行是一样的). 不支持用户自定义参数、计数器和别名，但支持 system.run[]. Hostname参数为设置时，该参数设置无效。 这个参数在Zabbix 1.8.6之后得到了支持。 |
|
| HousekeepingFrequency | no | 0-24 | 1 | Zabbix 执行 housekeeping 的频率 (单位小时)。 从数据库中删除过期的信息。 注意: 为了防止 housekeeper 过载 (for example, when configuration parameters ProxyLocalBuffer or ProxyOfflineBuffer are greatly reduced), 对于每一个item，不会在一个housek周期内删除超过4倍HousekeepingFrequency 的过时信息。因此, 如果 HousekeepingFrequency 是 1, 一个周期内不会删除超过4小时的过时信息 (starting from the oldest entry) 。 备注: 为降低 server压力， housekeeping 延后 server启动30 分。因此, 如果 HousekeepingFrequency 是1，proxy启动30分后执行第一次 housekeeping , 一小时后重复， Zabbix 2.4.0以后有了这种延迟行为。 从Zabbix 3.0.0开始，可以设置HousekeepingFrequency为0来禁止自动housekeeping.。 此时 housekeeping 只能通过 housekeeper_execute 启动，在一个housuekeeping周期内删除的过时信息的周期是最后一次housekeeping以来的时间的4倍,不少于4小时不大于4天。 |
| 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 | proxy端启动时加载的模块，这些模块用来扩展proxy的功能。 格式: LoadModule=<module.so> 这些模块必须在LoadModulePath参数指定的路径中。 允许多个 LoadModule 参数。 |
||
| LoadModulePath | no | proxy 模块路径。 默认值在编译时指定。 |
||
| LogFile | yes, if LogType is set to file, otherwise no |
日志文件名称. | ||
| LogFileSize | no | 0-1024 | 1 | 日志文件大小，单位 MB。 0 - 禁止日志文件自动回滚。 注意: 如果日志文件达到限定的大小，文件回滚失败, 不管是什么原因, 现有的日志会被截断，并重新记录日志。 |
| LogType | no | file | 日志输出类型: file - 写入LogFile 参数指定的日志文件中, system -写入系统日志, console - 控制台输出。 Zabbix 3.0.0后支持该参数。 |
|
| LogSlowQueries | no | 0-3600000 | 0 | 数据库查询时间，大于该时间会记入日志 (毫秒)。 0 - 不记录慢查询日志。 DebugLevel=3时该选项可用. Zabbix 1.8.2支持该参数。 |
| PidFile | no | /tmp/zabbix_proxy.pid | PID文件名称. | |
| ProxyLocalBuffer | no | 0-720 | 0 | proxy将在本地保存数据N个小时，即使数据已经与服务器同步了。 如果第三方应用程序使用本地数据，则可以使用该参数。 |
| ProxyMode | no | 0-1 | 0 | Proxy 工作模式. 0 - 主动模式proxy 1 - 被动模式proxy 这个参数在Zabbix 1.8.3之后得到了支持。 备注 当使用主动proxy时，可以访问Zabbix服务器trapper端口的进程能得到那些(敏感的)proxy配置数据。 这是可能的，因为任何人都可能假装是一个主动proxy，并请求配置数据;身份验证此时没有起作用。 |
| ProxyOfflineBuffer | no | 1-720 | 1 | 如果没有与Zabbix服务器的连接，proxy将保持N小时的数据。 旧数据将会丢失。 |
| ServerPort | no | 1024-32767 | 10051 | Zabbix server监听的端口. 主动代理参数，被动代理时忽略此参数(参见ProxyMode参数)。 |
| Server | yes | Zabbix server的IP地址（或主机名）. 主动proxy将从服务器获取配置数据。 主动代理参数，被动代理时忽略此参数(参见ProxyMode参数)。 |
||
| SNMPTrapperFile | no | /tmp/zabbix_traps.tmp | 用于从SNMP捕捉守护进程传递数据到proxy的临时文件。 必须和 zabbix_trap_receiver.pl 或 SNMPTT 配置文件中的值一样。 这个参数在Zabbix 2.0.0之后得到了支持。 |
|
| SocketDir | no | /tmp | 用于存储内部Zabbix服务使用的IPC套接字的目录 | |
| SourceIP | no | 对外连接的源IP地址。 | ||
| SSHKeyLocation | no | SSH检查和操作的公钥和私钥的位置。 | ||
| SSLCertLocation | no | 用于客户端身份验证的SSL客户端证书文件的位置。 该参数只用于web监控，Zabbix 2.4.0后支持该参数。 |
||
| SSLKeyLocation | no | 用于客户端身份验证的SSL 私钥文件的位置。 该参数只用于web监控，Zabbix 2.4.0后支持该参数。 |
||
| 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。 |
| StartHTTPPollers | no | 0-1000 | 1 | HTTP 轮询器子进程实例个数。 |
| 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。 |
| StartSNMPTrapper | no | 0-1 | 0 | 如果设置为1，则将启动SNMP trapper进程。 这个参数在Zabbix 2.0.0之后得到了支持。 |
| StartTrappers | no | 0-1000 | 5 | trappers进程实例数量。 Trappers接受来自Zabbix发送者、主动agents的传入连接。 在版本1.8.5之前，上限是255。 |
| StartVMwareCollectors | no | 0-250 | 0 | vmware 采集器的子进程实例个数。 Zabbix 2.2.0后支持该参数。 |
| Timeout | no | 1-30 | 3 | agent, SNMP 设备或外部检查的超时时长(单位秒)。 |
| TLSAccept | yes, if TLS certificate or PSK parameters are defined (even for unencrypted connection), otherwise no | 接受什么类型的连接， 用于被动检查。 可以指定多个值， 用逗号隔开即可: unencrypted - 接受未加密的连接 (默认) psk - 接受TLS 和预共享密钥 (PSK) 的连接 cert - 接受TLS 和证书的连接 Zabbix 3.0.0后支持该参数。 |
||
| TLSCAFile | no | 包含用于对等证书验证的顶级CA证书的文件的完整路径名， 用于加密Zabbix各组件间的通信。 Zabbix 3.0.0后支持该参数。 |
||
| TLSCertFile | no | 包含证书（证书链）的文件的完整路径名， 用于加密Zabbix各组件间的通信。 Zabbix 3.0.0后支持该参数。 |
||
| TLSConnect | yes, if TLS certificate or PSK parameters are defined (even for unencrypted connection), otherwise no | proxy连接server的方式， 用于主动检查。 只能指定一个值: unencrypted - 连接不加密 (默认) psk - 连接加密方式为TLS和预共享密钥(PSK) cert - 连接加密方式为 TLS 和 证书 Zabbix 3.0.0后支持该参数。 |
||
| TLSCRLFile | no | 包含证书吊销的文件的完整路径名， 用于加密Zabbix各组件间的通信。 Zabbix 3.0.0后支持该参数。 |
||
| TLSKeyFile | no | 包含私钥的文件的完整路径名。 Zabbix 3.0.0后支持该参数。 |
||
| TLSPSKFile | no | 包含proxy预共享key的文件的完整路径名，用于加密Zabbix各组件间的通信。 Zabbix 3.0.0后支持该参数。 |
||
| TLSPSKIdentity | no | 预共享密钥身份字符串， 用于加密和server间的通信。 Zabbix 3.0.0后支持该参数。 |
||
| TLSServerCertIssuer | no | 允许的服务器证书发行者。 Zabbix 3.0.0后支持该参数。 |
||
| TLSServerCertSubject | no | 允许的服务器证书主体。 Zabbix 3.0.0后支持该参数。 |
||
| TmpDir | no | /tmp | 临时目录. | |
| TrapperTimeout | no | 1-300 | 300 | 指定捕捉器处理新数据的时间。 |
| User | no | zabbix | 降低权限为系统中存在的指定用户。\\仅当系统以'root'身份运行且AllowRoot禁止时，该参数才起作用。 Zabbix 2.4.0后支持该参数。 |
|
| UnavailableDelay | no | 1-3600 | 60 | 在不可用期间， 主机多少秒检查一次是否可用。 |
| UnreachableDelay | no | 1-3600 | 15 | 在 不可达期间，主机多少秒检查一次是否可用。 |
| UnreachablePeriod | no | 1-3600 | 45 | 在多少秒 不可达后，即视为主机不可用。 |
| 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编码。
注释只能以 “#” 开始..