2 被动与主动 agent 检查

概述

本节详细介绍由 Zabbix agent 和 Zabbix agent 2 执行的被动检查和主动检查。

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

自 Zabbix 7.0 起，Zabbix agent 和 Zabbix agent 2 的协议已统一。Zabbix agent 与 Zabbix agent 2 请求/响应之间的差异通过 "variant" 标签值表示。

被动检查

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

被动检查以异步方式执行 - 无需在启动其他检查之前等待某个请求的响应。 DNS 解析同样是异步的。

agent 轮询器将尝试连接 DNS 查询返回的所有地址。 这样可以确保在某个 IP 地址无法访问时，轮询器会尝试下一个可用地址，从而提高连接成功的可能性。 此增强功能同时适用于 Zabbix 服务器和 proxy。

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

异步 agent 轮询器的数量由 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 服务器或 proxy 能够与使用明文协议的 7.0 之前版本的 agent 协同工作，系统实现了回退到旧协议的机制。

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

请注意，Zabbix 服务器/proxy 每小时都会再次尝试使用新协议处理所有接口；如有需要，则回退到旧协议。

主动检查

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

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

然后，agent 会定期将新值发送到服务器。 如果 agent 收到要执行的任何远程命令，也会发送执行结果。 请注意，active agent 上的远程命令执行自 Zabbix agent 7.0 起受支持。

获取监控项列表

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. 服务器处理数据并将状态发送回 agent
4. TCP 连接关闭

心跳消息

agent 发送

每隔 HeartbeatFrequency 秒，活动 agent 会向 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 协议