3 被动和主动代理检查

概述

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

Zabbix使用一个基于JSON的通信协议来与Zabbix代理进行通信。

这里有一些Zabbix使用的协议细节中的使用到的定义:

  1. <HEADER> - "ZBXD\x01" (5 bytes)
  2. <DATALEN> - data length (8 bytes). 1 will be formatted as 01/00/00/00/00/00/00/00 (eight bytes in HEX, 64 bit number)

为了避免耗尽内存, 当Zabbix server使用 Zabbix protocol 协议时一次连接只接受128M。

被动检查

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

Server 请求

  1. <item key>\n

Agent 响应

  1. <HEADER><DATALEN><DATA>[\0<ERROR>]

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

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

  • Server 打开一个TCP连接

  • Server 发送 agent.ping\n

  • Agent 读取请求并响应

    1

  • Server 处理数据以获取值, '1' in our case

  • TCP连接关闭

    对于不支持的监控项:

  • Server 打开一个TCP连接

  • Server 发送 vfs.fs.size[/nono]\n

  • Agent 读取请求并响应

    ZBX_NOTSUPPORTED\0Cannot obtain filesystem information: [2] No such file or directory

  • Server 处理数据, 更改项目状态为不支持并显示指定的错误消息

  • TCP连接关闭

主动检查

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

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

agent然后定期向服务器发送新值。

获取监控项列表

Agent 请求

  1. <HEADER><DATALEN>{
  2. "request":"active checks",
  3. "host":"<hostname>"
  4. }

Server 响应

  1. <HEADER><DATALEN>{
  2. "response":"success",
  3. "data":[
  4. {
  5. "key":"log[/home/zabbix/logs/zabbix_agentd.log]",
  6. "delay":30,
  7. "lastlogsize":0,
  8. "mtime":0
  9. },
  10. {
  11. "key":"agent.version",
  12. "delay":600,
  13. "lastlogsize":0,
  14. "mtime":0
  15. },
  16. {
  17. "key":"vfs.fs.size[/nono]",
  18. "delay":600,
  19. "lastlogsize":0,
  20. "mtime":0
  21. }
  22. ]
  23. }

服务器必须响应成功。 对于每一个返回的监控项, 不管监控项是不是日志监控项,必须存在 key, delay, lastlogsize and mtime

例如:

  • Agent 打开一个TCP连接

  • Agent 请求检查清单

  • Server 响应为监控项列表 (item key, delay)

  • Agent 解析响应

  • TCP 关闭连接

  • Agent 开始定期收集数据

注意,在使用主动检查时,对于可以访问Zabbix服务器trapper端口的配置数据是可得到的。 这是可能的,因为任何一个都可以假装是一个主动agent,并请求项目配置数据; 除非你使用 加密 选项,否则认证不会发生

发送收集的数据

Agent 发送

  1. <HEADER><DATALEN>{
  2. "request":"agent data",
  3. "data":[
  4. {
  5. "host":"<hostname>",
  6. "key":"agent.version",
  7. "value":"2.4.0",
  8. "clock":1400675595,
  9. "ns":76808644
  10. },
  11. {
  12. "host":"<hostname>",
  13. "key":"log[/home/zabbix/logs/zabbix_agentd.log]",
  14. "lastlogsize":112,
  15. "value":" 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",
  16. "clock":1400675595,
  17. "ns":77053975
  18. },
  19. {
  20. "host":"<hostname>",
  21. "key":"vfs.fs.size[/nono]",
  22. "state":1,
  23. "value":"Cannot obtain filesystem information: [2] No such file or directory",
  24. "clock":1400675595,
  25. "ns":78154128
  26. }
  27. ],
  28. "clock": 1400675595,
  29. "ns": 78211329
  30. }

Server 响应

  1. <HEADER><DATALEN>{
  2. "response":"success",
  3. "info":"processed: 3; failed: 0; total: 3; seconds spent: 0.003534"
  4. }

如果在服务器上发送一些值失败(例如,因为主机或监控项被禁用或删除),agnet将不会重试发送这些值。

例如:

  • Agent 打开一个TCP连接

  • Agent 发送一个值列表

  • Server 处理数据并将状态返回

  • TCP 连接关闭

注意,上面例子中怎么不支持 vfs.fs.size[/nono] 的状态由 “state” 值为 1 和 “value” 中的错误消息表示。

在服务器端,错误消息将被处理到2048个符号。

Older XML protocol

Zabbix将占用16 MB的XML base64编码的数据, 但单个解码值应该不超过64kb,否则,在解码时将被截断到64 KB。

另请参阅