默认情况下，在重启后，Zabbix agent 2 会在监控项更新间隔内的一个条件随机时间点安排首次主动检查的数据采集，以防止资源使用量激增。要在 agent 重启后立即执行不具有 Scheduling 更新间隔的主动检查，请在配置文件中设置 ForceActiveChecksOnStart 参数（全局级别）或 Plugins.<Plugin name>.System.ForceActiveChecksOnStart（仅影响特定插件检查）。如果设置了插件级参数，它将覆盖全局参数。

检查并发

来自不同插件的检查可以并发执行。单个插件内并发检查的数量受插件容量设置限制。每个插件可能具有硬编码的容量设置（默认值为 1000），可通过 Plugins.<PluginName>.System.Capacity=N 设置在 Plugins 配置参数中降低。

支持的平台

有关支持的平台，请参见Requirements页面。

Unix-like 系统上的 Agent 2

Unix-like 系统上的 Zabbix agent 2 运行在被监控的主机上。

安装

Zabbix agent 2 可以通过以下方法之一安装在基于 Linux 的系统上：

Zabbix 软件包 - 选择 Agent 2 组件（在选择 Zabbix 版本、OS 发行版和 OS 版本之后），然后按照说明操作；
Zabbix 源码 - 下载源文件，并通过使用 --enable-agent2 选项进行配置来编译 agent。

Zabbix agent 2 的监控能力可以通过可加载插件进行扩展，这些插件需单独获取。详情请参见可加载插件。

如果以软件包形式安装

Zabbix agent 2 作为前台进程运行，并依赖外部服务管理器（例如 systemd）在后台执行。 Zabbix agent 2 在 Linux 上不支持内置的守护进程化。

可通过执行以下命令启动 agent：

systemctl start zabbix-agent2

要停止、重启或检查 Zabbix agent 2 的状态，请使用以下命令：

systemctl stop zabbix-agent2
systemctl restart zabbix-agent2
systemctl status zabbix-agent2

手动启动

您可以通过找到 zabbix_agent2 二进制文件并直接运行它来启动 Zabbix agent；例如：

zabbix_agent2

Windows 系统上的 Agent 2

Zabbix agent 2 作为独立进程运行；不过，它也可以作为 Windows 服务运行。

安装

Zabbix agent 2 可以通过以下任一方法在 Windows 上安装：

预编译的 Zabbix agent 二进制文件 - 下载 agent MSI 安装程序包，并按照从 MSI 安装 Windows agent 页面中的说明进行操作；
Zabbix 源代码 - 下载源文件，并按照在 Windows 上构建 Zabbix agent 2 页面中的说明进行操作。

Zabbix agent 2 的监控能力可以通过可加载插件进行扩展，这些插件需单独获取。有关详细信息，请参见可加载插件。

有关将 Zabbix agent 2（从 ZIP 压缩包）作为 Windows 服务安装的更多详细信息，请参见 Microsoft Windows 上的 Zabbix agent 页面。

选项

以下命令行参数可与 Zabbix agent 2 一起使用：

Parameter	Description
UNIX 和 Windows agent
`-c --config <config-file>`	配置文件的路径。您可以使用此选项指定一个非默认的配置文件。
`-f --foreground`	以前台方式运行 Zabbix agent（默认值：true）。
`-p --print`	打印已知监控项并退出。请注意，如果还要返回 user parameter 的结果，必须指定配置文件（如果它不在默认位置）。
`-t --test <item key>`	测试指定的监控项并退出。请注意，如果还要返回 user parameter 的结果，必须指定配置文件（如果它不在默认位置）。
`-T --test-config`	验证配置文件并退出。
`-h --help`	打印帮助信息并退出。
`-v --verbose`	打印调试信息。请将此选项与 `-p` 和 `-t` 选项一起使用。
`-V --version`	打印 agent 版本和许可证信息。
`-R --runtime-control <option>`	执行管理功能。请参见 runtime control。
仅 Windows agent
`-m --multiple-agents`	使用多个 agent 实例（配合 `-i`、`-d`、`-s`、`-x` 选项）。为区分各实例的服务名称，每个服务名称都将包含所指定配置文件中的 Hostname 值。
`-S --startup-type <value>`	设置 Zabbix Windows agent 服务的启动类型。允许的值： `automatic` - (默认) 在 Windows 启动时自动启动服务； `delayed` - 在自动启动的服务完成启动后延迟启动该服务； `manual` - 手动启动服务（由用户或应用程序）； `disabled` - 禁用该服务，使其无法由用户或应用程序启动。您可以将此选项与 `-i` 选项一起使用，也可以单独使用，以修改已安装服务的启动类型。
`-i --install`	将 Zabbix Windows agent 安装为服务。
`-d --uninstall`	卸载 Zabbix Windows agent 服务。
`-s --start`	启动 Zabbix Windows agent 服务。
`-x --stop`	停止 Zabbix Windows agent 服务。

命令行参数使用的具体示例：

打印所有内置 agent 监控项及其值。
使用指定配置文件中定义的 mysql.ping 键测试一个 user parameter。
使用配置文件的默认路径 C:\\Program Files\\Zabbix Agent 2\\zabbix_agent2.conf 安装 Windows 版 Zabbix Agent 服务。
使用与 agent 可执行文件位于同一文件夹中的配置文件 zabbix_agent2.conf 修改已安装的 Windows 版 Zabbix Agent 服务的启动类型。

zabbix_agent2 --print
zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agent2.exe -i
zabbix_agent2.exe -c zabbix_agent2.conf -S delayed

运行时控制

运行时控制提供了一些远程控制选项。

Option	Description
`log_level_increase`	提高日志级别。
`log_level_decrease`	降低日志级别。
`metrics`	列出可用的指标。
`version`	显示 agent 版本。
`userparameter_reload`	从当前配置文件重新加载 `UserParameter` 和 `Include` 选项的值。
`help`	显示运行时控制的帮助信息。

示例：

为 agent 2 提高日志级别。
打印运行时控制选项。

zabbix_agent2 -R log_level_increase
zabbix_agent2 -R help

从 Zabbix 7.4.1 开始，agent 2 的运行时控制命令会将输出写入 stdout（标准输出），而不是 stderr（标准错误）。

配置文件

配置文件的默认路径为：

在 UNIX 上，默认值为 /usr/local/etc/zabbix_agent2.conf，或者由编译时变量 --sysconfdir 或 --prefix 设置。
在 Windows 上，默认值为 C:\\Program Files\\Zabbix Agent 2\\zabbix_agent2.conf。

如果主机上运行的是 agent 的单个实例，则可以使用默认配置文件，或者使用在命令行中指定的配置文件。如果有多个实例运行，则每个 agent 实例都必须有自己的配置文件（其中一个实例可以使用默认配置文件）。

Zabbix agent 2 的配置参数大多与 Zabbix agent 相同，但有一些例外：

Parameters		Description
Zabbix agent 2-specific configuration parameters
	`ControlSocket`	运行时控制套接字路径。Zabbix agent 2 使用控制套接字来执行运行时命令。
	`EnablePersistentBuffer`, `PersistentBufferFile`, `PersistentBufferPeriod`	这些参数用于为 Zabbix agent 2 上的主动监控项配置持久化存储。
	`ForceActiveChecksOnStart`	确定 agent 在重启后是否应立即执行主动检查，还是在一段时间内均匀分布执行。
	`Plugins`	插件可能有自己的参数，格式为 `Plugins.<Plugin name>.<Parameter>=<value>`。一个常见的插件参数是 `System.Capacity`，用于设置可同时执行的检查数量上限。
	`StatusPort`	Zabbix agent 2 监听 HTTP 状态请求以及显示已配置插件列表和某些内部参数的端口。
Zabbix agent-specific configuration parameters not supported on Zabbix agent 2
	`AllowRoot`, `User`	Zabbix agent 2 不支持这些参数，因为它不支持守护进程化。
	`EnableRemoteCommands`	已弃用；两个 agent 都改用 `AllowKey` 和 `DenyKey` 参数。
	`ListenBacklog`	在 Zabbix agent 中用于定义 TCP 队列中待处理连接的最大数量。Zabbix agent 2 不支持。
	`LoadModule`, `LoadModulePath`	Zabbix agent 2 不支持可加载模块。
	`MaxLinesPerSecond`, `LogRemoteCommands`	在 Zabbix agent 2 中，分别使用 `Plugins.Log.MaxLinesPerSecond` 和 `Plugins.SystemRun.LogRemoteCommands`。
	`StartAgents`	在 Zabbix agent 中，此参数用于增加被动检查并发数或禁用被动检查。在 Zabbix agent 2 中，并发数在插件级别进行配置，并可通过容量设置加以限制。如果未指定 `Server` 参数，则 Zabbix Agent 2 中会禁用被动检查。

有关更多详细信息，请参阅 Zabbix agent2 的配置文件选项。

退出代码

Zabbix agent 2 也可以使用较旧的 OpenSSL 版本（1.0.1、1.0.2）进行编译。

在这种情况下，Zabbix 会为 OpenSSL 中的锁定提供互斥锁。如果互斥锁定或解锁失败，则会将错误消息打印到标准错误流（STDERR），并且 Agent 2 分别以返回代码 2 或 3 退出。

What’s next?

4 Proxy

Docs

3 Agent 2

概述

被动和主动检查