2 被动与主动 agent 检查

概述

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

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

自 Zabbix 7.0 起，Zabbix agent和Zabbix agent 2协议已统一。Zabbix agent和Zabbix agent 2请求/响应之间的区别通过 "variant" 标签值来表达。

被动检查

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

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

agent 轮询器将尝试连接到DNS查找返回的所有地址。这确保了如果一个IP地址无法访问，轮询器将尝试下一个可用地址，从而增加成功连接的可能性。此增强功能适用于 Zabbix server 和 proxy。

异步检查的最大并发数是1000（由 maxconcurrentchecksperpoller 定义）。

异步 agent 轮询器的数量由 启动代理轮询器 参数定义。

服务器请求

关于头部和数据长度的定义，请参考 protocol details。

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

Agent 响应

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

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

1. 服务器建立TCP连接
2. 服务器发送 <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. 服务器处理数据以 get 值，在本例中为 '1'
5. TCP连接关闭

对于不支持的 监控项：

1. 服务器建立TCP连接
2. 服务器发送 <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 监控项 key."}]}
4. 服务器处理数据，将 监控项 状态更改为不支持，并附带指定的错误信息
5. TCP连接关闭

回退到旧协议

为了确保 Zabbix server 或 proxy 可以与使用明文协议的预 7.0 版本中的 agents 正常工作，实现了向旧协议的故障转移。

被动检查在重启后或接口配置更改后使用 JSON 协议（7.0 及更新版本）执行。
如果响应中未收到有效的 JSON（例如 agent 返回了 "ZBX_NOTSUPPORTED"），Zabbix 将缓存该接口为旧协议，并通过仅发送 监控项 键来重试检查。

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

主动检查

主动检查需要更复杂的处理。 agent 必须首先从 server/proxy 获取一个 监控项 和/或 remote commands 的列表，以进行独立处理。

服务器/proxies 到 get 主动检查的来源列在 agent configuration file 的 "ServerActive" 参数中。 这些检查的请求频率由同一配置文件中的“RefreshActiveChecks”参数设置。 但是，如果刷新主动检查失败，则会在硬编码的 60 秒后重试。

agent会定期将新数值发送至服务器。 若agent接收到任何remote commands以execute，执行结果也将被发送。 请注意，自Zabbix agent 7.0起支持在主动式agent上执行远程命令。

获取监控项列表

Agent 请求

主动检查请求用于获取由agent处理的待执行主动检查项。 此请求由agent在启动时发送，随后以RefreshActiveChecks为间隔发送。

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

服务器响应

服务器在处理主动检查请求后，将主动检查响应发送回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. 服务器响应包含一系列 监控项 及远程命令以供 execute
4. Agent 解析响应
5. TCP连接已关闭
6. Agent 启动周期性数据采集并执行远程命令（自 Zabbix agent 7.0 版本起支持）

发送采集数据

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用于丢弃在网络连接不良的环境中可能发送的重复值。

服务器响应

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

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

例如：

1. Agent打开TCP连接
   
2. Agent发送值列表
   
3. 服务器处理数据并发送状态回来
   
4. TCP连接关闭

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

心跳消息

Agent发送

心跳消息由活跃的agent每隔HeartbeatFrequency秒（在Zabbix agent/agent 2配置file中设置）发送给Zabbix server/proxy。

该消息用于监控主动检查的可用性。

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

重定向响应

当一个主机被重新分配时，服务器可能指示agent将其心跳（及后续主动检查）重定向到另一个proxy或服务器实例。

  {
           "response": "failed",
           "redirect": {
             "revision": 2,
             "address": "192.0.2.0:10055"
           }
         }

旧版 XML 协议