The default values reflect daemon defaults, not the values in the shipped configuration files.
The parameters supported in a Zabbix agent (Windows) configuration file:
Parameter | Mandatory | Range | Default | Description |
---|---|---|---|---|
Alias | no | 设置Item key的别名. 用短的、简单的词来替换长的,复杂的item key. 可以存在多个 别名 参数. 而且也允许多个参数使用一个 别名 . 不同的别名 也可以指向同一个 item key. 别名可以用于HostMetadataItem 但不能用在 HostnameItem 和 PerfCounter 参数中. 例如: 1. 检索服务器虚拟内存使用率. Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] 简写的key pg_usage 可以用来检索数据. 2. 使用默认参数和g自定义参数得到 CPU 负载. Alias=cpu.load:system.cpu.load Alias=cpu.load[*]:system.cpu.load[*] 使用 cpu.load key 可以得到默认情况下 CPU使用率 , 等同于使用g指定参数的cpu.load[percpu,avg15] 来得到CPU负载. 3. 允许多个 低级别发现 规则 处理同一个发现项. Alias=vfs.fs.discovery[*]:vfs.fs.discovery 使用 vfs.fs.discovery即可启动不同参数如 vfs.fs.discovery[foo],vfs.fs.discovery[bar],等的发现规则. |
||
BufferSend | no | 1-3600 | 5 | 缓存区保存数据的最长时间(单位s). |
BufferSize | no | 2-65535 | 100 | 数据缓存区大小. 如果缓存区满,agent会发送 所有采集到的数据给 Zabbix server 或者 proxy . |
DebugLevel | no | 0-5 | 3 | 指定调试等级: 0 - Zabxxi进程起停的基本信息 1 - 重要信息 2 - 错误信息 3 - 警告 4 - 调试 (产生大量信息) 5 - 扩展调试 (产生更多信息) |
EnableRemoteCommands | no | 0 | 是否允许server远程执行命令. 0 - 禁止 1 - 允许 |
|
HostMetadata | no | 0-255 characters | 可选参数用来定义主机元数据,只有主机自动注册时才用到主机元数据。 如果没有定义,该值通过 HostMetadataItem 获得。\\如果指定的值超过限制或者不是UTF-8编码的字符串, agent 会给出一个错误或者不启动。 2.2.0 或更高版本支持该参数。 |
|
HostMetadataItem | no | 可选参数定义 Zabbix agent 监控项, 用来得到主机元数据。 HostMetadata没有定义时,使用该参数。 支持 用户自定义参数, 性能计数器和别名。支持 system.run[] ,EnableRemoteCommands 值对该参数没有影响。\\只有主机自动注册时才用到主机元数据。 在一个自动注册请求过程中,如果返回值超过255个字符,agent 会记录一条警告信息。 监控项返回值必须为 UTF-8的字符串, 否则会忽略 。 2.2.0 或更高版本支持该参数。 |
||
Hostname | no | Set by HostnameItem | 唯一的, 区分大小写的. 主动检查时该配置项必填,并且必须和server端的配置匹配. 允许的符号: 字母数字, '.', ' ', '_' 和 '-'. 最大长度: 64 |
|
HostnameItem | no | system.hostname | 可选参数, 定义一个 Zabbix agent 来自动获取主机名字。Hostname参数未设置时,该参数设置生效。 不支持用户自定义参数、计数器和别名,但支持 system.run[] (与EnableRemoteCommands值无关) . Zabbix 1.8.6或更高版本都支持该参数. \\也可参考 更多详细描述. |
|
Include | no | 可以在配置文件中指定单个文件或者指定一个目录(所有文件在该目录中) 只有在指定的目录中包含相关文件, 才可以使用正则匹配的通配符。 例如: /absolute/path/to/config/files/*.conf . Zabbix 2.4.0后都支持模式匹配。\\参看关于限制条件特例. |
||
ListenIP | no | 0.0.0.0 | 监听Ip地址列表,多个Ip以分号隔开. Zabbix 1.8.3后支持多Ip. |
|
ListenPort | no | 1024-32767 | 10050 | 监听端口. |
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后支持该参数. |
|
LogRemoteCommands | no | 0 | 允许执行远程命令记录日志. 0 - 禁止 1 - 允许 |
|
MaxLinesPerSecond | no | 1-1000 | 20 | 每秒向server发送数据的最大行数, 或者proxy进程'log', 'logrt' 和'eventlog' 主动检查。 该参数值会被监控项'log', 'logrt' 或 'eventlog' 中的 'maxlines'参数覆盖。 |
PerfCounter | no | 语法: <parameter_name>,"<perf_counter_path>",<period> 定义新的参数: <parameter_name>系统性能计数器的均值 ,<perf_counter_path> 指定时间段, <period> (单位秒). 例如,如果你想得到上一分钟处理器平均每秒中断次数 ,可以定义一个新的参数 "interrupts" ,像下面这样: PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60 请注意性能计数器路径用双引号引住. 创建监控项的时候,参数名称(interrupts) 就可以用作监控项的key。 用于计算均值的样本,每秒取一次。 可以运行 "typeperf -qx" 命令来得到在Windows中所有可用的性能计数器列表。 |
||
RefreshActiveChecks | no | 60-3600 | 120 | 主动检查频率, 单位秒. 如果更新失败,60s后会尝试第二次更新。 |
Server | no | IP地址列表,以逗号分割,可选server的CIDR标记或者主机名。 只接受来自该列表的连接. 如果支持IPv6,则 '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' 是一样的, '::/0' 允许所有 IPv4 或IPv6地址。 '0.0.0.0/0' 用来允许任何IPv4地址。 注意, "IPv4兼容 IPv6地址" (0000::/96 开始)允许使用,但被 RFC4291遗弃. 例子: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.domain Zabbix 2.2 以后支持空格。 |
||
ServerActive | no | (*) | server 或 proxy 主动检查的IP:端口(或主机名:端口)。 可以使用多个并行的server端,此时用逗号分割, 不允许有空格。 如果不指定端口,就使用默认的端口号。 如果指定该主机的端口,IPv6地址必须被括在方括号中。 如果没有指定端口,则IPv6地址的方括号是可选的。 如果未指定该参数,主动检查不可用。 |
|
SourceIP | no | 对外连接的源IP地址. | ||
StartAgents | no | 0-63 (*) | 3 | 被动检查的zabbix_agentd子进程数量。 如果设为0,被动检查不可用并且agent不会监听任何TCP 端口。 1.8.5前版本最大数为16。 |
Timeout | no | 1-30 | 3 | 超时连接时间,单位秒 |
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 | agent 连接server或proxy的方式, 用于主动检查。 只能指定一个值: unencrypted - 连接不加密 (默认) psk - 连接加密方式为TLS和预共享密钥(PSK) cert - 连接加密方式为 TLS 和 证书 TZabbix 3.0.0后支持该参数。 |
||
TLSCRLFile | no | 包含证书吊销的文件的完整路径名, 用于加密Zabbix各组件间的通信。 Zabbix 3.0.0后支持该参数。 |
||
TLSKeyFile | no | 包含私钥的文件的完整路径名。 Zabbix 3.0.0后支持该参数 |
||
TLSPSKFile | no | 包含agent预共享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后支持该参数 |
||
UnsafeUserParameters | no | 0-1 | 0 | 允许用户自定义参数中传递所有字符. 0 - 禁止 1 - 允许 禁止下面字符: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ 另外, 不允许换行符. |
UserParameter | 用户自定义监控参数,可以有多个。 格式: UserParameter=<key>,<shell command> 注意 shell命令一定不能只返回空的字符串或者EOL 。 例子: UserParameter=system.test,echo 1 |
(*) ServerActive 中的服务器数量加上StartAgents 中指定的数量不能大于64.
在Zabbix agent 2.0.0 关于主动和被动的配置参数已经改变。
更多详细信息请查看本页底部的"参见" 部分。
Zabbix 的配置文件都是无BOM的utf8编码的。
注释只能在每行以 "#" 开头。