3 Protocolo del agente 2 de Zabbix

Descripción general

Esta sección proporciona información sobre:

  • Agente2 -> Servidor: solicitud de comprobaciones activas

  • Servidor -> Agente2: respuesta de comprobaciones activas

  • Agente2 -> Servidor: solicitud de datos del agente

  • Servidor -> Agente2: respuesta de datos del agente

Solicitud de cheques activos

La solicitud de comprobaciones activas se utiliza para obtener las comprobaciones activas que procesará el agente. Esta solicitud la envía el agente al inicio y luego con intervalos RefreshActiveChecks.

Campo Tipo Obligatorio Valor
request cadena si active checks
host cadena si Nombre del anfitrión.
version cadena si La versión del agente: <principal>.<menor>.
version cadena no El parámetro de configuración HostMetadata o valor de métrica HostMetadataItem.
interface cadena no El valor de la métrica del parámetro de configuración HostInterface o HostInterfaceItem.
ip cadena no El parámetro de configuración ListenIP primera IP si está configurado.
port número no El valor del parámetro de configuración ListenPort si está configurado y no es el puerto de escucha del agente predeterminado.

Ejemplo:

{
  "request": "active checks",
  "host": "Zabbix server",
  "version": "6.0",
  "host_metadata": "mysql,nginx",
  "hostinterface": "zabbix.server.lan",
  "ip": "159.168.1.1",
  "port": 12050
}

Respuesta de comprobaciones activas

El servidor envía la respuesta de comprobaciones activas al agente después de procesar la solicitud de comprobaciones activas.

Campo Tipo Obligatorio Valor
response cadena si success | failed
info cadena no Información de error en caso de fallo.
data conjunto de objetos no Elementos de cheques activos.
key cadena no Clave de artículo con macros expandidas.
itemid número no Identificador de la métrica.
delay cadena no Intervalo de actualización de la métrica.
lastlogsize número no Tamaño del último registro de la métrica.
mtime número no mtime de la métrica.
regexp conjunto de objetos no Expresiones regulares globales.
name cadena no Nombre de expresión regular global.
expression cadena no Expresión regular global.
expression_type número no Tipo de expresión regular global.
exp_delimiter cadena no Delimitador de expresión regular global.
case_sensitive número no Configuración global de sensibilidad entre mayúsculas y minúsculas de expresiones regulares.

Ejemplo:

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

Solicitud de datos del agente

La solicitud de datos del agente contiene los valores de los elementos recopilados.

Campo Tipo Obligatorio Valor
request cadena si agent data
host cadena si Nombre del equipo.
version cadena si La versión del agente: <principal>.<menor>.
session cadena si Identificador de sesión único generado cada vez que se inicia el agente.
data conjunto de objetos si Valores de artículos.
id número si El identificador de valor (contador incremental utilizado para comprobar valores duplicados en caso de problemas de red).
itemid número si Identificador de la métrica.
value cadena no El valor de la métrica.
lastlogsize número no El último tamaño del registro de la métrica.
mtime número no El mtime de la métrica.
state número no El estado de la métrica.
source cadena no El origen del registro de eventos de valor.
eventid número no El valor del registro de eventos eventid.
severity número no El valor de gravedad del registro de eventos.
timestamp número no La marca de tiempo del registro de eventos del valor.
clock número si La marca de tiempo del valor (segundos desde la época).
ns número si La marca de tiempo del valor es nanosegundos.

Ejemplo:

{
  "request": "agent data",
  "data": [
    {
      "id": 1,
      "itemid": 5678,
      "value": "2.4.0",
      "clock": 1400675595,
      "ns": 76808644
    },
    {
      "id": 2,
      "itemid": 1234,
      "lastlogsize": 112,
      "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",
      "clock": 1400675595,
      "ns": 77053975
    }
  ],
  "host": "Zabbix server",
  "version": "6.0",
  "session": "1234456akdsjhfoui"
}

Respuesta de datos del agente

El servidor envía la respuesta de datos del agente al agente después de procesar la solicitud de datos del agente.

Campo Tipo Obligatorio Valor
response cadena si éxito | fallido
info cadena si Resultados del procesamiento de métricas.

Ejemplo:

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