5 Zabbix agent （Windows）

概述

本节列出了 Windows Zabbix 代理配置文件 (zabbix_agentd.conf) 支持的参数。

参数列出时没有附加信息。单击参数可查看完整详细信息。

除非明确说明参数是必需的，否则所有参数都是非强制性的。

请注意：

• 默认值反映守护进程的默认值，而不是 附带的配置文件中的值；
• Zabbix 仅支持 UTF-8 编码的配置文件，不带 BOM;
• 以“#”开头的注释仅支持出现在行首。

参数详情

Alias

为项目键设置别名。它可用于用更短更简单的项目键替换长而复杂的项目键。

可能存在多个 Alias 参数。不允许使用具有相同 Alias 键的多个参数。

不同的 Alias 键可以引用相同的项目键。

别名可用于 HostMetadataItem，但不能用于 HostnameItem 或 PerfCounter 参数。

示例 1：从服务器检索页面文件使用率（百分比）。

Alias=pg_usage:perf_counter[File(_Total)% Usage]

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

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

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

这允许使用 cpu.load 键获取具有默认参数的 CPU 负载，以及使用 cpu.load[percpu,avg15] 获取有关 CPU 负载的具体数据。

示例 3：运行多个 低级发现 规则处理相同的发现项目。

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

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

AllowKey

允许执行与模式匹配的项目键。键模式是一个通配符表达式，支持“*”字符以匹配任意数量的任意字符。
可以与 DenyKey 结合定义多个键匹配规则。参数将根据其出现顺序逐一处理。另请参阅：限制代理检查。

BufferSend

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

默认值：5
范围：1-3600

BufferSize

内存缓冲区中的最大值数。如果缓冲区已满，代理将把所有收集的数据发送到 Zabbix 服务器或代理。

默认值：100
范围：2-65535

DebugLevel

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

默认值：3
范围：0-5

DenyKey

拒绝执行与模式匹配的项目键。键模式是一个通配符表达式，支持“*”字符以匹配任意数量的任意字符。
可以结合 AllowKey 定义多个键匹配规则。参数将根据其出现顺序逐一处理。另请参阅：限制代理检查。

EnableRemoteCommands

是否允许来自 Zabbix 服务器的远程命令。此参数已弃用，请改用 AllowKey=system.run[*] 或 DenyKey=system.run[*]。
它是 AllowKey/DenyKey 参数的内部别名，具体取决于值：
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]

默认值：0
值：0 - 不允许，1 - 允许

HeartbeatFrequency

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

默认值：60
范围：0-3600

HostInterface

定义主机接口的可选参数。主机接口用于主机 自动注册 进程。如果未定义，将从 HostInterfaceItem 获取该值。
如果该值超过 255 个字符的限制，代理将发出错误并且不会启动。

范围：0-255 个字符

HostInterfaceItem

可选参数，定义用于获取主机接口的项目。
主机接口用于主机 自动注册 进程。
在自动注册请求期间，如果指定项目返回的值超过 255 个字符的限制，代理将记录一条警告消息。
无论 AllowKey/DenyKey 值如何，system.run[] 项目均受支持。
此选项仅在未定义 HostInterface 时使用。

HostMetadata

定义主机元数据的可选参数。主机元数据仅在主机自动注册过程（活动代理）中使用。如果未定义，则将从 HostMetadataItem 获取该值。
如果指定的值超过 2034 字节的限制或为非 UTF-8 字符串，代理将发出错误并且不会启动。

范围：0-2034 字节

HostMetadataItem

可选参数，定义用于获取主机元数据的项目。此选项仅在未定义 HostMetadata 时使用。支持用户参数和别名。无论 AllowKey/DenyKey 值如何，都支持 system.run[] 项目。
每次尝试自动注册时都会检索 HostMetadataItem 值，并且仅在主机自动注册过程中使用。
在自动注册请求期间，如果指定项目返回的值超过 65535 个 UTF-8 代码点的限制，代理将记录一条警告消息。该项目返回的值必须是 UTF-8 字符串，否则将被忽略。

Hostname

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

默认值：由 HostnameItem 设置

HostnameItem

可选参数，定义用于获取主机名的项目。此选项仅在未定义 Hostname 时使用。不支持用户参数或别名，但无论 AllowKey/DenyKey 值如何，都支持 system.run[] 项目。

默认值：system.hostname

Include

您可以在配置文件中包含单个文件或目录中的所有文件（如果使用 Windows MSI 安装程序包安装 Zabbix 代理，则默认位于 C:\Program Files\Zabbix Agent 2；如果 Zabbix 代理以 zip 存档形式安装，则位于安装期间指定的文件夹中）。所有包含的文件必须具有 正确的语法，否则代理将无法启动。路径可以相对于 zabbix_agent2.conf 文件位置（例如， Include=.\zabbix_agent2.d\plugins.d\*.conf）。
要仅包含指定目录中的相关文件，支持使用星号通配符进行模式匹配。
有关限制，请参阅 特别说明。

示例：

Include=C:FilesAgent2_agent2.d*.conf

ListenBacklog

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

默认值：SOMAXCONN
范围：0 - INT_MAX

ListenIP

agent应监听的逗号分隔 IP 地址列表。

默认值：0.0.0.0

ListenPort

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

默认值：10050
范围：1024-32767

LogFile

agent日志文件的名称。

默认值：c:\\zabbix_agent2.log
必填：是，如果 LogType 设置为 file；否则否

LogFileSize

日志文件的最大大小（以 MB 为单位）。
0 - 禁用自动日志轮换。
注意：如果达到日志文件大小限制并且文件轮换失败，无论出于何种原因，现有日志文件都会被截断并重新启动。

默认值：1
范围：0-1024

Plugins.SystemRun.LogRemoteCommands

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

默认值：0
值：0 - 禁用，1 - 启用

LogType

日志输出的类型：
file - 将日志写入 LogFile 参数指定的文件；
console - 将日志写入标准输出。

默认值：file

Plugins.Log.MaxLinesPerSecond

agent在处理“log”、“logrt”和“eventlog”活动检查时每秒向 Zabbix 服务器或代理发送的最大新行数。提供的值将被“log”、“logrt”或“eventlog”项目键中提供的“maxlines”参数覆盖。
注意：Zabbix 将处理比MaxLinesPerSecond中设置的新行多 10 倍的新行，以在日志项目中寻找所需的字符串。

默认值：20
范围：1-1000

PerfCounter

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

例如，如果您希望接收最后一分钟每秒处理器中断的平均次数，则可以定义一个新参数“interrupts”，如下所示：

PerfCounter = Interrupts,"(0)/sec",60

请注意性能计数器路径周围的双引号。参数名称（interrupts）将在创建项目时用作项目键。每秒都会进行一次采样以计算平均值。
您可以运行“typeperf -qx”以获取 Windows 中所有可用性能计数器的列表。

PerfCounter

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

例如，如果您希望接收最后一分钟每秒处理器中断的平均次数，则可以定义一个新参数“interrupts”，如下所示：

PerfCounter = Interrupts,"(0)/sec",60

请注意性能计数器路径周围的双引号。参数名称（interrupts）将在创建项目时用作项目键。每秒都会进行一次采样以计算平均值。
您可以运行“typeperf -qx”以获取 Windows 中所有可用性能计数器的列表。

RefreshActiveChecks

活动检查列表的刷新频率（以秒为单位）。请注意，如果刷新活动检查失败，将在 60 秒后尝试下一次刷新。

默认值：5
范围：1-86400

Server

逗号分隔的 IP 地址列表，可选地采用 CIDR 表示法，或 Zabbix 服务器或 Zabbix 代理的 DNS 名称。仅接受来自此处列出的主机的传入连接。如果启用了 IPv6 支持，则“127.0.0.1”、“::127.0.0.1”、“::ffff:127.0.0.1”将得到同等对待，并且“::/0”将允许任何 IPv4 或 IPv6 地址。“0.0.0.0/0”可用于允许任何 IPv4 地址。允许使用空格。

示例：

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

必填：是

ServerActive

要从中获取主动检查的 Zabbix 服务器/代理地址或集群配置。服务器/代理地址是 IP 地址或 DNS 名称和可选端口，以冒号分隔。
集群配置是一个或多个以分号分隔的服务器地址。可以指定多个 Zabbix 服务器/集群和 Zabbix 代理，以逗号分隔。不应为每个 Zabbix 服务器/集群指定多个 Zabbix 代理。如果指定了 Zabbix 代理，则不应指定该代理的 Zabbix 服务器/集群。
可以提供多个以逗号分隔的地址以并行使用多个独立的 Zabbix 服务器。允许使用空格。
如果未指定端口，则使用默认端口。
如果指定了该主机的端口，则必须将 IPv6 地址括在方括号中。如果未指定端口，则 IPv6 地址的方括号是可选的。
如果未指定此参数，则禁用主动检查。

Zabbix 代理的示例：

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 服务器或 Zabbix 代理的传出连接；
- 在执行某些项目（web.page.get、net.tcp.port 等）时建立连接。

StartAgents

处理被动检查的 zabbix_agentd 预分叉实例数。如果设置为 0，则禁用被动检查，并且代理不会监听任何 TCP 端口。

默认值：10
范围：0-63 (*)

Timeout

指定通信超时（以秒为单位）。
此参数用于定义各种通信操作的持续时间：
- 等待 Zabbix 服务器的响应；
- 向 Zabbix 服务器发送请求，包括 主动检查 配置请求和项目数据；
- 通过日志文件或 Windows 事件日志监控检索日志数据；
- 发送心跳消息；
- 还用作 7.0 版之前的服务器/代理发送无超时检查的场景的后备。

默认值：3
范围：1-30

TLSAccept

要接受的传入连接。用于被动检查。可以指定多个值，用逗号分隔：
unencrypted - 接受未加密的连接（默认）
psk - 接受使用 TLS 和预共享密钥 (PSK) 的连接
cert - 接受使用 TLS 和证书的连接

必需：是，如果定义了 TLS 证书或 PSK 参数（即使对于 uncrypted 连接也是如此）；否则否

TLSCAFile

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

TLSCertFile

包含代理证书或证书链的文件的完整路径名，用于与 Zabbix 组件进行加密通信。

TLSConnect

代理应如何连接到 Zabbix 服务器或代理。用于主动检查。只能指定一个值：
unencrypted - 不加密连接（默认）
psk - 使用 TLS 和预共享密钥 (PSK) 连接
cert - 使用 TLS 和证书连接

必填：是，如果定义了 TLS 证书或 PSK 参数（即使对于 未加密 连接）；否则否

TLSCRLFile

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

TLSKeyFile

包含agent私钥的文件的完整路径名，用于 Zabbix 组件之间的加密通信。

TLSPSKFile

包含代理预共享密钥的文件的完整路径名，用于与 Zabbix 服务器进行加密通信。

TLSPSKIdentity

预共享密钥身份字符串，用于与 Zabbix 服务器进行加密通信。

TLSServerCertIssuer

允许的服务器（代理）证书颁发者。

TLSServerCertSubject

允许的服务器（代理）证书主题。

UnsafeUserParameters

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

默认值：0
值：0 - 不允许，1 - 允许

UserParameter

要监视的用户定义参数。可以有多个用户定义参数。
格式：UserParameter=<key>,<shell 命令>
请注意，shell 命令不得返回空字符串或仅返回 EOL。如果指定了 UserParameterDir 参数，则 Shell 命令可以具有相对路径。

示例：

UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh

UserParameterDir

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

示例：

UserParameterDir=/opt/myscripts

参阅

1. Zabbix agent 主动和被动检查从2.0.0版本后配置对比详解