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 服务器或 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": "8.0.0",
  "variant": 2,
  "data": [
    {
      "value": "8.0.0"
    }
  ]
}

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

1. 服务器打开一个 TCP 连接
2. 服务器发送 <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]}
3. agent 读取请求并响应 <HEADER><DATALEN>{"version":"8.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":"8.0.0","variant":2,"data":[{"error":"Unsupported item key."}]}
4. 服务器处理数据，将监控项状态更改为不受支持，并附带指定的错误消息
5. TCP 连接关闭

故障切换到旧协议

为确保 Zabbix 服务器或 proxy 能够与 7.2 之前版本、使用明文协议的 agent 配合工作，系统实现了向旧协议的故障切换机制。

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

请注意，Zabbix 服务器/proxy 每小时都会再次尝试让所有接口使用新协议进行通信，并在需要时回退到旧协议。

主动检查

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

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

然后，agent定期向服务器发送新值。如果Agent收到任何远程命令 需要去执行，执行结果也会被发送。请注意，自 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": "8.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
    }
  ]
}

服务器必须返回 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": "8.0.0",
  "variant": 2
}

每个值都会分配一个虚拟 ID。值 ID 是一个简单的递增计数器， 在一个数据会话内唯一（由 session 令牌标识）。此 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": "8.0.0",
  "variant": 2
}

重定向响应

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

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

较旧的XML协议