2 Comprobaciones pasivas y activas del agente

Descripción general

Esta sección proporciona detalles sobre las comprobaciones pasivas y activas realizadas por Zabbix agent y Zabbix agent 2.

Zabbix utiliza un protocolo de comunicación basado en JSON para comunicarse con los agentes.

Los protocolos de Zabbix agent y Zabbix agent 2 están unificados desde Zabbix 7.0. La diferencia entre las solicitudes y respuestas de Zabbix agent y Zabbix agent 2 se expresa mediante el valor de la etiqueta "variant".

Comprobaciones pasivas

Una comprobación pasiva es una solicitud de datos simple.
El Zabbix server o el proxy solicita algunos datos (por ejemplo, la carga de la CPU) y el Zabbix agent devuelve el resultado al server.

Las comprobaciones pasivas se ejecutan de forma asíncrona: no es necesario recibir la respuesta a una solicitud antes de iniciar otras comprobaciones.
La resolución de DNS también es asíncrona.

El sondeador de agent intentará conectarse a todas las direcciones devueltas por la búsqueda de DNS.
Esto garantiza que, si no se puede acceder a una dirección IP, el sondeador intentará con la siguiente dirección disponible, lo que aumenta la probabilidad de que la conexión se realice correctamente.
Esta mejora se aplica tanto al Zabbix server como al proxy.

La concurrencia máxima de las comprobaciones asíncronas es 1000 (definida por MaxConcurrentChecksPerPoller).

El número de sondeadores de agent asíncronos se define mediante el parámetro StartAgentPollers.

Solicitud del server

Para consultar la definición de la longitud del encabezado y de los datos, consulte los detalles del protocolo.

{
  "request": "passive checks",
  "data": [
    {
      "key": "agent.version",
      "timeout": 3
    }
  ]
}

Respuesta del agent

{
  "version": "7.0.0",
  "variant": 2,
  "data": [
    {
      "value": "7.0.0"
    }
  ]
}

Por ejemplo, para los items compatibles:

1. El server abre una conexión TCP
2. El server envía <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]}
3. El agent lee la solicitud y responde con <HEADER><DATALEN>{"version":"7.0.0","variant":2,"data":[{"value":1}]}
4. El server procesa los datos para obtener el valor, que en este caso es «1»
5. Se cierra la conexión TCP

Para los items no compatibles:

1. El server abre una conexión TCP
2. El server envía <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"vfs.fs.size[/nono]","timeout":3}]}
3. El agent lee la solicitud y responde con <HEADER><DATALEN>{"version":"7.0.0","variant":2,"data":[{"error":"Unsupported item key."}]}
4. El server procesa los datos y cambia el estado del item a no compatible con el mensaje de error especificado
5. Se cierra la conexión TCP

Conmutación por error al protocolo antiguo

Para garantizar que el server o el proxy de Zabbix puedan trabajar con agents de versiones anteriores a la 7.0, que utilizan el protocolo de texto sin formato, se ha implementado una conmutación por error al protocolo antiguo.

Las comprobaciones pasivas se realizan mediante el protocolo JSON (versión 7.0 y posteriores) después de reiniciar o cuando se modifica la configuración de la interfaz. Si no se recibe un JSON válido como respuesta (el agent envía "ZBX_NOTSUPPORTED"), Zabbix almacenará en caché la interfaz como perteneciente al protocolo antiguo y reintentará la comprobación enviando únicamente la clave del item.

Tenga en cuenta que cada hora el server/proxy de Zabbix volverá a intentar trabajar con el protocolo nuevo con todas las interfaces y cambiará al protocolo antiguo si es necesario.

Comprobaciones activas

Las comprobaciones activas requieren un procesamiento más complejo. El agent primero debe recuperar del server/proxy una lista de items y/o comandos remotos para su procesamiento independiente.

Los servers/proxies desde los que se obtienen las comprobaciones activas se enumeran en el parámetro 'ServerActive' del archivo de configuración del agent. La frecuencia con la que se solicitan estas comprobaciones se establece mediante el parámetro 'RefreshActiveChecks' en el mismo archivo de configuración. Sin embargo, si la actualización de las comprobaciones activas falla, se reintenta después de 60 segundos fijos.

El agent envía periódicamente los valores nuevos al server o los servers. Si el agent recibió algún comando remoto para ejecutar, también se enviará el resultado de la ejecución. Ten en cuenta que la ejecución de comandos remotos en un agent activo es compatible desde Zabbix agent 7.0.

Obtención de la lista de items

Solicitud del agent

La solicitud de comprobaciones activas se utiliza para obtener las comprobaciones activas que debe procesar el agent. El agent envía esta solicitud al iniciarse y, posteriormente, según los intervalos de 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"
}

Respuesta del server

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

{
  "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
    }
  ]
}

El server debe responder con éxito.

Por ejemplo:

1. El agent abre una conexión TCP
2. El agent solicita la lista de comprobaciones
3. El server responde con una lista de items y comandos remotos que se ejecutarán
4. El agent analiza la respuesta
5. Se cierra la conexión TCP
6. El agent inicia la recopilación periódica de datos y ejecuta los comandos remotos (compatible desde Zabbix agent 7.0)

Envío de datos recopilados

El agent envía

La solicitud de datos del agent contiene los valores de los item recopilados y los valores de los comandos remotos ejecutados (si los hay).

{
  "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
}

Se asigna un ID virtual a cada valor. El ID del valor es un contador ascendente simple, único dentro de una sesión de datos (identificada por el token de sesión). Este ID se utiliza para descartar valores duplicados que podrían enviarse en entornos con conectividad deficiente.

Respuesta del server

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

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

Por ejemplo:

1. El agent abre una conexión TCP
2. El agent envía una lista de valores
3. El server procesa los datos y devuelve el estado
4. Se cierra la conexión TCP

Mensaje de latido

El agent envía

El mensaje de latido se envía desde un agent activo al server/proxy de Zabbix cada HeartbeatFrequency segundos (configurado en el archivo de configuración de Zabbix agent/agent 2).

Se utiliza para supervisar la disponibilidad de las comprobaciones activas.

{
  "request": "active check heartbeat",
  "host": "Zabbix server",
  "heartbeat_freq": 60,
  "version": "7.0.0",
  "variant": 2
}

Respuesta de redirección

Cuando se reasigna un host, el server puede indicar al agent que redirija su latido (y las comprobaciones activas posteriores) a otra instancia de proxy o server.

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

Protocolo XML antiguo