2 被动和主动 Agent 检查

概述

本节提供有关 Zabbix agent 和 Zabbix agent 2 执行的被动和主动检查的详细信息。

Zabbix 使用基于 JSON 的通信协议与 Zabbix agent进行通信。

从Zabbix 7.0起，Zabbix agent 和 Zabbix agent 2 协议已统一。Zabbix agent 和 Zabbix agent 2 请求/响应之间的差异由”variant” 标签值表示。

被动检查

被动检查是一个简单的数据请求。Zabbix server或proxy请求一些数据(例如，CPU负载)，Zabbix agent将结果发送回服务器。

被动检查是异步执行的 - 在其他检查开始之前不需要接收对一个请求的响应。 DNS 解析也是异步的。

异步检查最大并发数为1000 (由 MaxConcurrentChecksPerPoller定义).

异步agent pollers 由 StartAgentPollers 参数定义.

Server 请求

头部和数据长度的定义请参考 协议详情。

{
         "request": "passive checks",
         "data": [
           {
             "key": "agent.version",
             "timeout": 3
           }
         ]
       }

Agent 响应

{
         "version": "7.0.0",
         "variant": 2,
         "data": [
           {
             "value": "7.0.0"
           }
         ]
       }

例如，对于支持的监控项：

1. Server 打开一个 TCP 连接。
2. Server 发送 <HEADER><DATALEN>{“request”:”passive checks”,”data”:[{“key”:”agent.ping”,”timeout”:3}]}
3. Agent 读取请求并响应 <HEADER><DATALEN>{“version”:”7.0.0”,”variant”:2,”data”:[{“value”:1}]}
4. Server 处理数据以获取值, 例如’1’
5. TCP 连接关闭。

对于不支持的监控项:

1. Server 打开一个 TCP 连接。
2. Server 发送 <HEADER><DATALEN>{“request”:”passive checks”,”data”:[{“key”:”vfs.fs.size[/nono]“,”timeout”:3}]}
3. Agent 读取请求并响应 <HEADER><DATALEN>{“version”:”7.0.0”,”variant”:2,”data”:[{“error”:”Unsupported item key.”}]}
4. Server 处理数据, 更改监控项状态为不支持并显示指定的错误消息。
5. TCP 连接关闭。

故障转移到旧协议

为了确保 Zabbix server或proxy可以与 7.0 之前版本（具有明文协议）的Agent一起使用，实现了到旧协议的故障转移。

重启后或接口配置更改时，使用 JSON 协议（7.0 及更高版本）执行被动检查。 如果没有收到有效的 JSON 响应 (agent 发送 “ZBX_NOTSUPPORTED”), Zabbix 会将接口缓存为旧协议，并通过仅发送监控项来 重试 检查。

请注意， Zabbix server/proxy 每小时都会再次尝试使用所有接口的新协议，如果有需要，则回退到旧协议。

主动检查

主动检查需要更复杂的处理，agent 必须首先从server/proxy端获取监控项列表，或通过 远程命令 进行独立处理。

从中获取主动检查的server/proxy在Agent 配置文件 的”ServerActive”参数中列出。请求这些检查的频率由同一配置文件中的”RefreshActiveChecks”参数设置。但是，如果刷新主动检查失败，则会在硬编码 60 秒后重试。

从 Zabbix 6.4 开始，Agent（处于主动模式）不再每两分钟从server/proxy接收一次完整的配置副本（默认）。相反，为了减少网络流量和资源使用，每 5 秒（默认）执行一次增量配置同步，server/proxy 仅在Agent尚未收到配置时才提供配置的完整副本，或者主机配置、全局宏或全局正则表达式发生了某些变化。

然后，agent定期向服务器发送新值。如果Agent收到任何远程命令 需要去执行，执行结果也会被发送。请注意，自 Zabbix Agent 7.0 起，支持在主动Agent上执行远程命令。

如果Agent位于防火墙后面，您可能会考虑仅使用主动检查，因为在这种情况下您不需要修改防火墙以允许初始传入连接。

获取监控项列表

Agent 请求

主动检查请求用于获取agent要处理的主动检查。 此请求由agent在启动时发送，然后以 RefreshActiveChecks 间隔发送。

{
         "request": "active checks",
         "host": "Zabbix server",
         "host_metadata": "mysql,nginx",
         "hostinterface": "zabbix.server.lan",
         "ip": "159.168.1.1",
         "port": 12050,
         "version": "7.0.0",
         "variant": 2,
         "config_revision": 1,
         "session": "e3dcbd9ace2c9694e1d7bbd030eeef6e"
       }

Server 响应

在处理主动检查请求之后，主动检查响应由服务器发送回agent。

{
         "response": "success",
         "config_revision": 2,
         "data": [
           {
             "key": "system.uptime",
             "itemid": 1234,
             "delay": "10s",
             "lastlogsize": 0,
             "mtime": 0
           },
           {
             "key": "agent.version",
             "itemid": 5678,
             "delay": "10m",
             "lastlogsize": 0,
             "mtime": 0,
             "timeout": "30s"
           }
         ],
         "commands": [
           {
             "command": "df -h --output=source,size / | awk 'NR>1 {print $2}'",
             "id": 1324,
             "wait": 1
           }
         ]
       }

服务器必须成功响应。

例如:

1. Agent 打开一个 TCP 连接
2. Agent 请求检查列表
3. 服务器响应监控项列表和要执行的远程命令
4. Agent 解析响应
5. TCP 连接关闭
6. Agent开始定期收集数据并执行远程命令 (从Zabbix agent 7.0开始支持)

请注意，在使用主动检查时，（敏感）配置数据可能供有权访问 Zabbix server采集器端口的各方使用。这是可能的，因为任何人都可能假装是一个主动agent并请求监控项配置数据。除非您使用加密 选项，否则不会进行身份验证。

发送收集的数据

Agent 发送

Agent数据请求包含收集的监控项值和执行的远程命令的值（如果有）。

{
         "request": "agent data",
         "data": [
           {
             "id": 1,
             "itemid": 5678,
             "value": "7.0.0",
             "clock": 1712830783,
             "ns": 76808644
           },
           {
             "id": 2,
             "itemid": 1234,
             "value": "69672",
             "clock": 1712830783,
             "ns": 77053975
           }
         ],
         "commands": [
           {
             "id": 1324,
             "value": "16G"
           }
         ],
         "session": "1234456akdsjhfoui",
         "host": "Zabbix server",
         "version": "7.0.0",
         "variant": 2
       }

每个值都分配了一个虚拟 ID。值 ID 是一个简单的递增计数器，在一个数据会话中是唯一的（由会话令牌标识）。 此 ID 用于丢弃可能在连接性差的环境中发送的重复值。

Server 响应

agent数据响应在处理agent数据请求后由服务器发送回agent。

{
         "response": "success",
         "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
       }

如果在服务器上发送某些值失败（例如，因为主机或监控项已被禁用或删除），agent将不会重试发送这些值。

例如:

1. Agent 打开一个 TCP 连接
2. Agent 发送一个值列表
3. Server 处理数据并将状态返回
4. TCP 连接关闭

请注意，在上面的示例中，vfs.fs.size[/nono] 的不支持状态是如何通过”state”值 1 和“value”属性中的错误消息来指示的。

服务器端错误消息将被修剪为 2048 个符号。

心跳消息

心跳消息由主动Agent每隔 HeartbeatFrequency 秒 (在Zabbix agent)/ agent 2 配置文件中配置）发送到Zabbix server/proxy。

它用于监视主动检查的可用性。

{
         "request": "active check heartbeat",
         "host": "Zabbix server",
         "heartbeat_freq": 60,
         "version": "7.0.0",
         "variant": 2
       }

较旧的XML协议

Zabbix将占用16 MB的XML base64编码的数据, 但单个解码值应该不超过64 KB，否则，在解码时将被截断到64 KB。