3 被动和主动Agent检查

概述

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

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

另请参阅：[Zabbix agent 2] (/manual/appendix/protocols/zabbix_agent2) 协议详细信息。

被动检查

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

Server 请求 头部和数据长度的定义请参考协议详细信息

<item key>

Agent 响应

<DATA>[\0<ERROR>]

在上面，方括号中的部分是可选的，只发送到不受支持的监控项。

例如, 对于支持的监控项:

1. Server 打开一个TCP连接
2. Server 发送 <HEADER><DATALEN>agent.ping
3. Agent 读取请求并响应 <HEADER><DATALEN>1
4. Server 处理数据以获取值, 例如'1'
5. TCP连接关闭

对于不支持的监控项:

1. Server 打开一个TCP连接
2. Server 发送 <HEADER><DATALEN>vfs.fs.size[/nono]
3. Agent 读取请求并响应 <HEADER><DATALEN>ZBX_NOTSUPPORTED\0Cannot obtain filesystem information: [2] No such file or directory
4. Server 处理数据, 更改监控项状态为不支持并显示指定的错误消息
5. TCP连接关闭

主动检查

主动检查需要更复杂的处理，agent 必须首先从server端检索独立处理监控项的列表。

The servers 主动检查的列表在agent 配置文件中的 'ServerActive' 参数中列出， 请求这些检查的频率是由相同配置文件中的'RefreshActiveChecks' 参数设置的。 然而，如果刷新主动检查失败，则在60秒后重试。

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
       }

Server 响应

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

{
         "response": "success",
         "data": [
           {
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "itemid": 1234,
             "delay": "30s",
             "lastlogsize": 0,
             "mtime": 0
           },
           {
             "key": "agent.version",
             "key_orig": "agent.version",
             "itemid": 5678,
             "delay": "10m",
             "lastlogsize": 0,
             "mtime": 0
           }
         ]
       }

服务器必然成功响应。

例如：

1. Agent 打开一个TCP连接
2. Agent 索要检查列表
3. 服务器响应监控项列表（监控项键，延时）
4. Agent 解析响应
5. TCP 连接关闭
6. Agent 开始定期收集数据

发送收集的数据

Agent 发送

代理数据请求包含收集的监控项值。

{
        · "request": "agent data",
        · "data": [
        · {
        · "host": "Zabbix server",
        · "key": "agent.version",
        · "value": "2.4.0",
        · "clock": 1400675595,
        · "ns": 76808644
        · },
        · {
        · "host": "Zabbix server",
        · "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
        · "lastlogsize": 112,
        · "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",
        · "clock": 1400675595,
        · "ns": 77053975
        · }
        · ],
        · "session": "1234456akdsjhfoui"
       }

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

服务器响应

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

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

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

举例:

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

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

较旧的 XML 协议