2 Comprobaciones pasivas y activas del agente

Descripción general

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

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

Los protocolos del agente Zabbix y del agente 2 Zabbix se han unificado desde Zabbix 7.0. La diferencia entre las solicitudes/respuestas del agente Zabbix y del agente 2 Zabbix se expresa mediante el valor de la etiqueta "variante".

Comprobaciones pasivas

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

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

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

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

Solicitud de servidor

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

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

Respuesta del agente

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

Por ejemplo, para métricas compatibles:

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

Para métricas no compatibles:

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

Conmutación por error al protocolo anterior

Para asegurarse de que el servidor o proxy de Zabbix pueda funcionar con agentes de versiones anteriores a la 7.0, que tienen protocolo de texto sin formato, se implementa una conmutación por error al protocolo anterior.

Las comprobaciones pasivas se realizan utilizando el protocolo JSON (7.0 y posteriores) después del reinicio o cuando se cambia la configuración de la interfaz. Si no se recibe un JSON válido como respuesta (el agente envió "ZBX_NOTSUPPORTED"), Zabbix almacenará en caché la interfaz como protocolo anterior y reintenta la comprobación enviando solo la clave de la métrica.

Tenga en cuenta que cada hora el servidor/proxy Zabbix volverá a intentar trabajar con el nuevo protocolo con todas las interfaces, recurriendo al protocolo anterior si es necesario.

Comprobaciones activas

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

Los servidores/proxies de los que obtener las comprobaciones activas se enumeran en el parámetro 'ServerActive' del archivo de configuración del agente. La frecuencia con la que se solicitan estas comprobaciones la establece el parámetro 'RefreshActiveChecks' en el mismo archivo de configuración. Sin embargo, si falla la actualización de las comprobaciones activas, se vuelve a intentar después de 60 segundos prefijados.

Luego, el agente envía periódicamente los nuevos valores a los servidores. Si el agente recibió algún comando remoto para ejecutar, también se enviará el resultado de la ejecución. Tenga en cuenta que la ejecución remota de comandos en un agente activo se admite desde el agente Zabbix 7.0.

Obteniendo la lista de métricas

Solicitud del agente

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

{
         "request": "active checks",
         "host": "servidor Zabbix",
         "host_metadata": "mysql,nginx",
         "hostinterface": "zabbix.server.lan",
         "ip": "159.168.1.1",
         "port": 12050,
         "version": "7.0.0",
         "variant": 2,
         "config_revision": 1,
         "session": "e3dcbd9ace2c9694e1d7bbd030eeef6e"
       }

Respuesta del servidor

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

{
        "response": "success",
         "config_revision": 2,
         "data": [
           {
             "key": "system.uptime",
             "ítemid": 1234,
             "delay": "10s",
             "lastlogsize": 0,
             "mtime": 0
           },
           {
             "key": "agent.version",
             "ítemid": 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 servidor debe responder con éxito.

Por ejemplo:

1. El agente abre una conexión TCP
2. El agente solicita la lista de comprobaciones.
3. El servidor responde con una lista de métricas y comandos remotos para ejecutar.
4. El agente analiza la respuesta.
5. La conexión TCP se cierra
6. El agente inicia la recopilación periódica de datos y ejecuta comandos remotos (compatible desde el agente Zabbix 7.0)

Envío de datos recopilados

El agente envía

La solicitud de datos del agente contiene los valores de las métricas recopiladas 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": "1234456akdsjhfoui",
         "host": "Zabbix server",
         "version": "7.0.0",
         "variant": 2
       }

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

Respuesta del servidor

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

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

Por ejemplo:

1. El agente abre una conexión TCP
2. El agente envía una lista de valores.
3. El servidor procesa los datos y devuelve el estado.
4. La conexión TCP se cierra

Observe cómo en el ejemplo anterior el estado no admitido para vfs.fs.size[/nono] se indica mediante el valor de "estado" de 1 y el mensaje de error en la propiedad "value".

Mensaje de latido

El mensaje de latido es enviado por un agente activo al servidor/proxy de Zabbix. cada segundo de HeartbeatFrequency (configurado en el agente Zabbix/ agente 2 archivo de configuración).

Se utiliza para monitorear la disponibilidad de cheques activos.

{
         "solicitud": "comprobación activa del latido del corazón",
         "host": "servidor Zabbix",
         "frecuencia_latidos": 60,
         "versión": "7.0.0",
         "variante": 2
       }

Protocolo XML más antiguo