Table of Contents
4 Zabbix agent (Windows)
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编码的。
注释只能在每行以 "#" 开头。