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 服务器或 proxy 会请求一些数据（例如 CPU 负载），然后 Zabbix agent 将结果返回给服务器。

被动检查是异步执行的 - 无需在开始其他检查之前先接收某个请求的响应。DNS 解析同样是异步的。

agent poller 会尝试连接 DNS 查询返回的所有地址。这样可以确保如果某个 IP 地址不可达，poller 会尝试下一个可用地址，从而提高连接成功的可能性。此增强适用于 Zabbix 服务器和 proxy。

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

异步 agent poller 的数量由 StartAgentPollers 参数定义。

服务器请求

有关报文头和数据长度的定义，请参阅 协议详情。

{
  "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. 服务器处理数据以获取值，在本例中为 '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 item 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 请求

active checks 请求用于获取由 agent 处理的 active checks。
该请求由 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"
}

服务器响应

active checks 响应由服务器在处理 active checks 请求后返回给 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
    }
  ]
}

服务器必须返回 success。

例如：

1. agent 打开一个 TCP 连接
2. agent 请求监控项列表
3. 服务器返回监控项和要执行的远程命令列表
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": "8495cd52070e6ca52b371f29c8574165",
  "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 连接关闭

心跳消息

Agent 发送

心跳消息由主动 agent 每隔 HeartbeatFrequency 秒发送到 Zabbix 服务器/proxy （在 Zabbix agent/ agent 2 配置文件中进行配置）。

它用于监控主动监控项的可用性。

{
  "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.1:10055"
    }
  }

旧版 XML 协议