Table of Contents

2 Agent

2 Agent

概述

Zabbix agent 被部署在一台监控目标 get 上，用于主动监控本地资源和应用程序（硬盘驱动器、内存、处理器统计信息等）。

agent 会本地收集操作信息并向其报告数据 Zabbix server 进行进一步处理。如果出现故障（例如硬盘空间占满或服务进程崩溃），Zabbix server 可以主动向特定机器的管理员发出警报报告了失败。

Zabbix agents 因使用原生系统而具有高效率需要收集统计信息。

被动与主动检查

Zabbix agents 可以执行被动检查和主动检查：

被动检查 - Zabbix agent 响应来自 Zabbix server（或 proxy）的请求。例如，服务器请求数据（例如，CPU负载），agent返回结果。
主动检查 - Zabbix agent 在不等待来自 Zabbix server（或 proxy）的请求的情况下收集并发送数据。首先，它从服务器检索监控监控项列表（CPU 负载、可用内存等），然后收集所需的数据，并定期将新值发送回服务器。

agent 检查类型的配置是通过选择相应的监控 item type 来完成的。 Zabbix agent 类型为 "Zabbix agent" 或 "Zabbix agent (active)" 的监控项进程。

支持平台

对于支持的平台，请参考支持平台页面。

类 UNIX 系统上的 Agent

在类 UNIX 系统上，Zabbix agent 是正在被监控的主机上的 run。

安装

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

Zabbix packages - 选择 Agent 组件（在选择 Zabbix 版本、操作系统发行版和操作系统版本后），并按照提供的说明进行操作。
Zabbix sources - 下载源文件并通过使用 --enable-agent 选项与 configuring the sources 一起编译 Zabbix agent。

通常，32 位 Zabbix agents 将在 64 位系统上运行，但在某些情况下可能会失败。

预编译的 Zabbix agent 二进制文件适用于 macOS、IBM AIX、FreeBSD、OpenBSD 和 Solaris 的 download。适用于当前 Zabbix server/proxy 版本的旧版二进制文件，可从 NetBSD 和 HP-UX 获取。

若以软件包安装

Zabbix agent 作为守护进程运行。可以通过执行以下命令启动 agent：

systemctl start zabbix-agent

这适用于大多数 GNU/Linux 系统。在其他系统上，您可能需要运行：

/etc/init.d/zabbix-agent start

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

systemctl stop zabbix-agent
       systemctl restart zabbix-agent
       systemctl status zabbix-agent

手动启动

你可以通过找到 zabbix_agentd 可执行文件并直接运行它来启动 Zabbix agent；例如：

zabbix_agentd

Windows 系统上的 Agent

Windows 上的 Zabbix agent 作为 Windows 服务运行。

安装

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

Pre-compiled Zabbix agent binaries - 下载 Zabbix agent MSI 安装包，并按照 Windows agent installation from MSI 页面上的说明进行操作。
Zabbix sources - 下载源文件，并按照 Building Zabbix agent on Windows 页面上的说明进行操作。

有关将 Zabbix agent（从 ZIP 压缩包）安装为 Windows 服务的更多详细信息，请参阅将-agent-安装为-windows-服务页面。

选项

可以在一个主机上 run 多个 agent 实例。单个实例可以使用默认的配置 file 或者在命令行中指定的配置 file。在多个实例的情况下，每个 agent 实例必须拥有自己的配置 file（其中一个实例可以使用默认配置文件）。

以下命令行参数可用于 Zabbix agent：

参数	描述
UNIX and Windows agent
-c --config <config-file>	配置文件的路径。您可以使用此选项来指定一个非默认的配置 file。在 UNIX 上，默认路径为 /usr/local/etc/zabbix_agentd.conf 或由安装-zabbix-守护进程变量 --sysconfdir 或 --prefix 设置的路径。在 Windows 上，默认路径为 C:\Program Files\Zabbix Agent\zabbix_agentd.conf
-f --foreground	在前台运行 Zabbix agent（默认值：true）。
-p --print	打印已知的监控项并退出。注意：若要同时返回 user parameter 的结果，您必须指定配置 file（如果它不在默认位置）。
-t --test <item key>	测试指定的监控项并退出。注意：若要同时返回 user parameter 的结果，您必须指定配置 file（如果它不在默认位置）。
-T --test-config	验证配置 file 并退出。
-h --help	显示帮助信息。
-V --version	显示 version 编号。
UNIX agent only
-R --runtime-control <option>	执行管理功能。请参见运行时控制。
Windows agent only
-m --multiple-agents	使用多个 agent 实例（配合 -i、-d、-s、-x 选项）。为了区分实例的服务名称，每个服务名称将包含从指定配置文件中获取的 Hostname 值。
-S --startup-type <value>	设置 Zabbix Windows agent 服务的启动类型。允许的值： `automatic` - (默认) 在 Windows 启动时自动启动服务； `delayed` - 在自动启动的服务完成启动后延迟启动服务（适用于 Windows Server 2008/Vista 及更高版本）； `manual` - 手动启动服务（由用户或应用程序启动）； `disabled` - 禁用服务，使其无法由用户或应用程序启动。您可以将此选项与 -i 选项一起使用，或者单独使用以修改已安装服务的启动类型。
-i --install	将 Zabbix Windows agent 安装为服务。
-d --uninstall	卸载 Zabbix Windows agent 服务。
-s --start	启动 Zabbix Windows agent 服务。
-x --stop	停止 Zabbix Windows agent 服务。

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

打印所有内置的 agent 监控项及其值
测试在指定配置 file 中定义的 "mysql.ping" 键的用户参数
在 Windows 上将 "Zabbix Agent" 服务安装为使用默认配置路径 file C:\Program Files\Zabbix Agent\zabbix_agentd.conf
在 Windows 上使用位于与 agent 可执行文件相同文件夹中的配置 file zabbix_agentd.conf 安装 "Zabbix Agent [Hostname]" 服务，并通过配置 file 中的 Hostname 值扩展服务名称以使其唯一
在 Windows 上使用位于与 agent 可执行文件相同文件夹中的配置 file zabbix_agentd.conf 修改已安装的 "Zabbix Agent" 服务的启动类型

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

运行时控制

通过运行时控制选项，您可以更改agent进程的日志级别。

选项	描述	目标
log_level_increase[=<target>]	提高日志级别。如果未指定target，则会影响所有进程。	target可以指定为：进程类型 - 指定类型的所有进程（例如，listener）参见所有agent进程类型。进程类型,N - 进程类型和编号（例如，listener,3） pid - 进程标识符（1到65535）。对于更大的值，请将target指定为'process-type,N'。
log_level_decrease[=<target>]	降低日志级别。如果未指定target，则会影响所有进程。
userparameter_reload	从当前配置文件重新加载UserParameter和Include选项的值。

示例：

提高所有进程的日志级别
提高第三个监听进程的日志级别
提高PID为1234的进程的日志级别
降低所有主动检查进程的日志级别

zabbix_agentd -R log_level_increase
       zabbix_agentd -R log_level_increase=listener,3
       zabbix_agentd -R log_level_increase=1234
       zabbix_agentd -R log_level_decrease="active checks"

OpenBSD、NetBSD和Windows不支持运行时控制。

Agent 进程类型

active checks - 用于执行主动检查的进程
collector - 用于数据收集的进程
listener - 用于监听被动检查的进程

可以使用 agent 日志 file 来观察这些进程类型。

进程用户

在UNIX上，Zabbix agent 被设计为以非 root 用户身份运行 run。它将运行 run。以任何非 root 用户身份运行。因此，您可以以任意run agent身份运行。非root用户且没有任何问题。

如果你尝试以“root”身份run，它将切换到一个硬编码的 “zabbix”用户，该用户必须存在于您的系统上。您只能 run 以“root”身份运行 agent，如果您修改了 agent 中的 'AllowRoot' 参数根据需要配置 file。

配置文件

有关配置 Zabbix agent 的详细信息，请参阅 file 的配置选项，或查看 zabbix_agentd 或 Windows agent。

区域设置

请注意，agent 需要 UTF-8 本地化环境，以便某些文本 agent 监控项可以返回预期的内容。大多数现代类 Unix 系统默认使用 UTF-8 本地化环境，但也有部分系统可能需要特别设置。

退出代码

Zabbix agent 在成功退出时返回 0，在失败时返回 1。

Documentation