5 Zabbix agent (Windows)

概述

本节列出了 Windows Zabbix agent 配置 file (zabbix_agentd.conf) 支持的参数。

参数列表中未包含附加信息。点击参数以查看完整详细信息。

参数 描述
Alias 为一个 监控项 键设置一个 alias。
AllowKey 允许执行与模式匹配的那些 监控项 键。
BufferSend 不要在缓冲区中保留超过 N 秒的数据。
BufferSize memory 缓冲区中的最大值数量。
DebugLevel 调试级别。
DenyKey 拒绝执行与模式匹配的那些 监控项 键。
EnableRemoteCommands 来自 Zabbix server 的远程命令是否被允许。
HeartbeatFrequency 心跳消息的频率(以秒为单位)。
HostInterface 一个可选参数,用于定义 主机 接口。
HostInterfaceItem 一个可选参数,用于定义用于获取 主机 接口的 监控项。
HostMetadata 一个可选参数,用于定义 主机 元数据。
HostMetadataItem 一个可选参数,用于定义用于获取 主机 元数据的 Zabbix agent 监控项。
Hostname 一个可选参数,用于定义主机名。
HostnameItem 一个可选参数,用于定义用于获取主机名的 Zabbix agent 监控项。
Include 您可以在配置文件中包含单个文件或目录中的所有文件。
ListenBacklog TCP队列中等待连接的最大数量。
ListenIP 逗号分隔的IP地址列表,agent 应该监听的IP地址。
ListenPort agent 将在此端口监听来自服务器的连接。
LogFile 日志文件的名称。
LogFileSize 日志文件的最大大小。
LogRemoteCommands 启用将执行的 shell 命令作为警告进行日志记录。
LogType 日志输出的类型。
MaxLinesPerSecond 在处理 '日志' 和 "logrt" 主动检查时,agent 每秒发送到 Zabbix server 或 proxy 的最大新行数。
PerfCounter 定义了一个新参数 <parameter_name>,它是为指定时间段 <period>(以秒为单位)内系统性能计数器 <perf_counter_path> 的平均值。
PerfCounterEn 定义一个新参数 <parameter_name>,该参数表示系统性能计数器 <perf_counter_path> 在指定时间段 <period>(以秒为单位)内的平均值。与 PerfCounter 相比,性能计数器路径必须使用英文。
RefreshActiveChecks 主动检查列表的刷新频率。
Server 逗号分隔的IP地址列表,可选CIDR格式,或Zabbix servers和Zabbix proxies的DNS名称。
ServerActive 用于从其get主动检查的Zabbix server/proxy地址或集群配置。
SourceIP 源IP地址。
StartAgents 用于处理被动检查的 zabbix_agentd 预派生实例的数量。
Timeout 指定与Zabbix proxy或服务器建立连接和交换数据时等待的时长(以秒为单位)。
TLSAccept 接受哪些传入连接。
TLSCAFile 用于对等证书验证的 file 的完整路径名,该文件包含 Top 级别 CA 证书,用于 Zabbix 组件之间的加密通信。
TLSCertFile 包含agent证书或证书链的file的完整路径名,用于Zabbix组件之间的加密通信。
TLSConnect agent 应该如何连接到 Zabbix server 或 proxy。
TLSCRLFile 包含已吊销证书的file的完整路径名。此参数用于Zabbix组件之间的加密通信。
TLSKeyFile 用于Zabbix组件之间加密通信的file中包含的agent私钥的完整路径名。
TLSPSKFile 包含用于与 Zabbix server 加密通信的 agent 预共享密钥的 file 的完整路径名。
TLSPSKIdentity 预共享密钥标识符 string,用于与 Zabbix server 进行加密通信。
TLSServerCertIssuer 允许的服务器(proxy)证书颁发者。
TLSServerCertSubject 允许的服务器 (proxy) 证书主题。
UnsafeUserParameters 允许在参数中传递所有字符到用户自定义参数。
UserParameter 要监控的用户自定义参数。
UserParameterDir UserParameter 命令的默认搜索路径。

所有参数均为非必填项,除非明确说明该参数为必填项。

注意:

  • 默认值反映守护进程的默认值,而不是其中的值 随附的配置文件;
  • Zabbix 仅支持采用 UTF-8 编码的配置文件,且不包含 BOM
  • 以“#”开头的注释仅在开头处受支持 该行。

参数详情

alias

为一个 监控项 键设置一个 alias。它可以用于用较短且较简单的键替代较长且复杂的 监控项 键。
可以存在多个 alias 参数。不允许存在具有相同 alias 键的多个参数。
不同的 alias 键可以引用同一个 监控项 键。
别名可以在 HostMetadataItem 中使用,但不能在 HostnameItemPerfCounter 参数中使用。

示例 1:从服务器中以百分比形式检索分页 file 使用情况。

alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]

现在可以使用简写键 pg_usage 来检索数据。

示例 2:使用默认参数和自定义参数获取 CPU 负载。

alias=cpu.load:system.cpu.load
       alias=cpu.load[*]:system.cpu.load[*]

这允许使用 cpu.load 键来以默认参数 get CPU 负载,也可以使用 cpu.load[percpu,avg15] 来以特定参数 get CPU 负载的相关数据。

示例 3:运行多个处理相同发现 监控项 的 low-level discovery 规则。

alias=vfs.fs.discovery[*]:vfs.fs.discovery

现在可以设置多个使用 vfs.fs.discovery 的发现规则,并为每个规则指定不同的参数,例如 vfs.fs.discovery[foo]vfs.fs.discovery[bar] 等。

允许的密钥

允许执行匹配模式的 监控项 键。键模式是一个支持使用 "*" 字符匹配任意数量任意字符的通配符表达式。
可以结合 DenyKey 定义多个键匹配规则。参数将按照其出现顺序逐一处理。另请参阅:Restricting agent checks

BufferSend

不要在缓冲区中保留超过 N 秒的数据。

默认值: 5
范围: 1-3600

{HEADER_15332855}

memory 缓冲区中值的最大数量。如果缓冲区已满,agent 将把所有收集到的数据发送到 Zabbix server 或 proxy。

默认值:100
范围:2-65535

DebugLevel

指定调试级别:
0 - Zabbix进程启动和停止的基本信息
1 - 关键信息;
2 - 错误信息;
3 - 警告;
4 - 用于调试(产生大量信息);
5 - 扩展调试(产生更多信息)。

默认值:3
范围:0-5

DenyKey

拒绝执行与模式匹配的那些 监控项 键。键模式是一个通配符表达式,支持使用 "*" 字符匹配任意数量的任意字符。
可以结合 AllowKey 定义多个键匹配规则。参数将按照其出现顺序逐一处理。另请参阅:Restricting agent checks

启用远程命令

是否允许来自Zabbix server的远程命令。此参数已弃用,请改用AllowKey=system.run[*]或DenyKey=system.run[*]。
它是根据值决定AllowKey/DenyKey的内部alias参数:
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]

默认值:0 值:0 - 不允许,1 - 允许

HeartbeatFrequency

心跳消息的频率(以秒为单位)。用于监控主动检查的可用性。
0 - 禁用心跳消息。

默认值:60
取值范围:0-3600

主机接口

一个可选参数,用于定义主机接口。主机接口在主机 将-dns-设为默认接口过程中使用。如果未定义,则该值将从HostInterfaceItem获取。
如果该值超过255个字符的限制,agent将返回问题错误且不会启动。

范围:0-255个字符

主机接口项

一个可选参数,用于定义用于获取主机接口的监控项。
主机接口在主机 将-dns-设为默认接口过程中使用。
在自动注册请求期间,如果指定的监控项返回的值超过255个字符的限制,agent将记录一条警告信息。
system.run[] 监控项的支持不受AllowKey/DenyKey值的影响。
仅在未定义HostInterface时使用此选项。

主机元数据

一个可选参数,用于定义主机的元数据。主机元数据仅在主机的自动注册过程中(主动agent)使用。如果未定义,该值将从HostMetadataItem获取。
如果指定的值超过2034字节或包含非UTF-8的string,则agent将问题错误且不会启动。
不支持多行元数据——输出将在第一个换行符处被截断。

范围:0-2034字节

主机元数据项

一个可选参数,用于定义一个用于获取 主机 元数据的 Zabbix agent 监控项。当未定义 HostMetadata 时,才使用此选项。支持用户参数、性能计数器和别名。无论 AllowKey/DenyKey 的值如何,都支持 system.run[] 监控项。
HostMetadataItem 的值在每次自动注册尝试时检索,并且仅在 主机 自动注册过程(主动 agent)中使用。
在自动注册请求期间,如果指定的 监控项 返回的值超过 65535 个 UTF-8 码点限制,agent 将记录警告消息。由 监控项 返回的值必须是 UTF-8 string,否则将被忽略。
不支持多行元数据——输出将在第一个换行符处被截断。

主机名

以逗号分隔的、唯一的、区分大小写的主机名列表。主动检查时必填,并且必须与服务器上配置的主机名匹配。若未定义,则从 HostnameItem 获取该值。
允许的字符:字母数字、'.'、' '、'_' 和 '-'。每个主机名最大长度:128 个字符,整行最大长度:2048 个字符。

默认值:由 HostnameItem 设置

主机名检测项

一个可选参数,用于定义用于获取 主机 名称的 Zabbix agent 监控项。当未定义 Hostname 时,才使用此选项。不支持用户参数、性能计数器或别名,但无论 AllowKey/DenyKey 的值如何,都支持 system.run[] 监控项。
另请参见 配置

默认值:system.hostname

包含

您可以在配置中包含单个文件或目录中的所有文件 file(如果使用 Windows MSI 安装包安装 Zabbix agent,则默认位于 C:\Program Files\Zabbix Agent;如果以 zip 压缩包形式安装 Zabbix agent,则位于安装期间指定的文件夹中)。所有包含的文件必须具有正确的语法,否则 agent 将无法启动。
为了仅包含指定目录中的相关文件,支持使用星号通配符进行模式匹配。
有关限制,请参见 special notes

示例:

Include=C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf
ListenBacklog

TCP队列中待处理连接的最大数量。
默认值是一个硬编码常量,具体取决于系统。
所支持的最大值也取决于系统,过高的值可能会被静默截断为“实现定义的最大值”。

默认值:SOMAXCONN
范围:0 - INT_MAX

ListenIP

一个逗号分隔的IP地址列表,agent 应该监听这些地址。

默认值: 0.0.0.0

监听端口

agent 将在此端口监听来自服务器的连接。

默认值:10050
范围:1024-32767

##### 日志文件

agent日志文件的名称。

默认值:c:\zabbix_agentd.log 必填项:是,如果 LogType 设置为 file;否则否

日志文件大小

日志 file 的最大大小(以 MB 为单位)。
0 - 禁用自动日志轮换。
注意:如果达到日志 file 大小限制并且由于任何原因导致 file 轮换失败,则现有的日志 file 将被截断并重新开始。

默认值: 1
范围: 0-1024

日志远程命令

启用将执行的 shell 命令记录为警告日志。仅在远程执行时才会记录命令。如果 system.run[] 是由 HostMetadataItem、HostInterfaceItem 或 HostnameItem 参数在本地启动的,则不会创建日志条目。

默认值:0
取值范围:0 - 禁用,1 - 启用

日志类型

日志输出的类型:
file - 将日志写入由LogFile参数指定的file;
system - 将日志写入Windows事件日志;
console - 将日志写入标准输出。

默认值:file

每秒最大行数

在处理 '日志'、'logrt' 和 'eventlog' 主动检查时,agent 每秒发送给 Zabbix server 或 proxy 的最大新行数。此值将被在 '日志'、'logrt' 或 'eventlog' 监控项 键中提供的 'maxlines' 参数覆盖。
注意:为了在日志 监控项 中查找所需的 string,Zabbix 处理的新行数将是 MaxLinesPerSecond 中设置值的 10 倍。

默认值:20 范围:1-1000

PerfCounter

定义了一个新参数 <parameter_name>,它是系统性能计数器 <perf_counter_path> 在指定时间段 <period>(以秒为单位)内的平均值。
语法: <parameter_name>,"<perf_counter_path>",<period>

例如,如果您希望获取上一分钟内处理器中断的平均数量/秒,您可以将一个新参数 "interrupts" 定义如下:

PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60

请注意性能计数器路径周围的双引号。参数名称(interrupts)在创建 监控项 时用作 监控项 键。用于计算平均值的样本将每秒采集一次。
您可以使用 run "typeperf -qx" 来 get Windows 中所有可用性能计数器的列表。

PerfCounterEn

定义一个新参数 <parameter_name>,它是系统性能计数器 <perf_counter_path> 在指定时间段 <period>(以秒为单位)内的平均值。与 PerfCounter 相比,perfcounter 路径必须使用英文。仅支持 Windows Server 2008/Vista 及更高版本。
语法: <parameter_name>,"<perf_counter_path>",<period>

例如,如果您希望获取过去一分钟内处理器中断的平均数量,您可以定义一个名为 "interrupts" 的新参数,如下所示:

PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60

请注意性能计数器路径周围的双引号。参数名 (interrupts) 在创建 监控项 时将用作 监控项 键。
用于计算平均值的样本将每秒采集一次。
您可以通过查看以下注册表项找到英文字符串列表:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009

刷新主动检查

刷新主动检查列表的频率,以秒为单位。请注意,在刷新主动检查失败后,将在 60 秒后再次尝试刷新。

默认值: 5
范围: 1-86400

服务器

以逗号分隔的IP地址列表,可选地使用CIDR表示法,或Zabbix servers或Zabbix proxies的DNS名称。仅接受来自此处列出的主机的入站连接。如果启用了IPv6支持,则'127.0.0.1'、'::127.0.0.1'、'::ffff:127.0.0.1'将被视为等效,而'::/0'将允许任何IPv4或IPv6地址。使用'0.0.0.0/0'可以允许任何IPv4地址。请注意,RFC4291支持但已弃用“IPv4兼容的IPv6地址”(0000::/96前缀)。允许使用空格。

示例:

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

必填项:是,如果StartAgents未显式设置为0

ServerActive

用于 get 主动检查的 Zabbix server/proxy 地址或集群配置。server/proxy 地址是一个 IP 地址或 DNS 名称,以及可选的端口,端口与地址之间用冒号分隔。
集群配置是由分号分隔的一个或多个服务器地址。可以使用逗号分隔指定多个 Zabbix servers/集群和 Zabbix proxies。每个 Zabbix server/集群不应指定多个 Zabbix proxy。如果指定了 Zabbix proxy,则不应再为该 proxy 指定 Zabbix server/集群。
可以提供多个逗号分隔的地址以并行使用多个独立的 Zabbix servers。允许使用空格。
如果未指定端口,则使用默认端口。
如果为该 主机 指定了端口,IPv6 地址必须用方括号括起来。如果未指定端口,IPv6 地址的方括号是可选的。
如果未指定此参数,则禁用主动检查。

Zabbix proxy 的示例:

ServerActive=127.0.0.1:10051

多个服务器的示例:

ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

高可用性的示例:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3

两个集群和一个服务器的高可用性示例:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain

范围:(*)

SourceIP

用于以下情况的源IP地址:

  • 与 Zabbix server 或 Zabbix proxy 的出站连接;
  • 执行某些 监控项(如 web.page.get、net.tcp.port 等)时建立连接。
StartAgents

用于处理被动检查的 zabbix_agentd 预派生实例的数量。若设置为 0,则禁用被动检查,并且 agent 将不会监听任何 TCP 端口。

默认值: 10
取值范围: 0-100 (*)

超时

指定建立连接以及与Zabbix proxy或服务器交换数据时等待的时长(以秒为单位)。
此参数用于定义以下各类操作的持续时间:

  • 等待来自Zabbix server的响应;
  • 向Zabbix server发送请求,包括主动检查配置请求和监控项数据;
  • 通过logfile或Windows事件日志监控检索日志数据;
  • 发送心跳消息;
  • vfs.*检查的最大持续时间;
  • 被Zabbix agent模块使用;
  • 在server/proxy早于version 7.0发送无超时检查的情况下,也作为后备设置。

默认值:3
取值范围:1-30

TLSAccept

接受的入站连接。用于被动检查。可以指定多个值,用逗号分隔:
unencrypted - 接受不加密的连接(默认)
psk - 接受使用TLS和预共享密钥(PSK)的连接
cert - 接受使用TLS和证书的连接

必填项:如果定义了TLS证书或PSK参数时为必填(即使为unencrypted连接);否则非必填

TLSCAFile

包含用于Zabbix组件之间加密通信的对等证书验证的Top级CA证书的file的完整路径名。

TLSCertFile

用于与 Zabbix 组件进行加密通信的 file 的完整路径名,该文件包含 agent 证书或证书链。

TLS连接

agent 应该如何连接到 Zabbix server 或 proxy。用于主动检查。只能指定一个值:
unencrypted - 不使用加密连接(默认)
psk - 使用 TLS 和预共享密钥(PSK)连接
cert - 使用 TLS 和证书连接

必填项:如果定义了 TLS 证书或 PSK 参数时为必填(即使是 unencrypted 连接);否则非必填

TLSCRLFile

包含已吊销证书的file的完整路径名。此参数用于Zabbix组件之间的加密通信。

TLSKeyFile

用于存储 Zabbix 组件之间加密通信所使用的 agent 私钥的 file 的完整路径名。

TLSPSKFile

包含用于与Zabbix server进行加密通信的agent预共享密钥的file的完整路径名。

TLSPSKIdentity

预共享密钥标识 string,用于与 Zabbix server 进行加密通信。

TLSServerCertIssuer

允许的服务器(proxy)证书颁发者。

TLSServerCertSubject

允许的服务器 (proxy) 证书主题。

UnsafeUserParameters

允许在用户自定义参数的参数中传递所有字符。以下字符不允许使用:\ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
此外,不允许换行符。

默认值:0
取值范围:0 - 不允许,1 - 允许

UserParameter

用户自定义的监控参数。可以有多个用户自定义参数。
格式:UserParameter=<键>,<shell命令>
注意shell命令不能返回空string或仅包含行尾符。如果指定了UserParameterDir参数,shell命令可以使用相对路径。

示例:

UserParameter=system.test,dir /b | find /c /v ""
       UserParameter=check_cpu,.\custom\_script.bat
UserParameterDir

UserParameter 命令的默认搜索路径。如果使用此参数,agent 在执行命令之前会将其工作目录更改为在此处指定的目录。因此,UserParameter 命令可以使用相对的 ./ 前缀,而不是完整的路径。只允许有一个条目。

示例:

UserParameterDir=C:\opt\myscripts

(*) ServerActive 中列出的活跃服务器数量
加上为被动检查指定的预派生实例数量(由 StartAgents 定义)
必须小于 64。