3 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.

Zabbix utiliza un protocolo de comunicación basado en JSON para comunicarse con el Agente Zabbix.

Ver también: Detalles del protocolo del Agente Zabbix 2.

Comprobaciones pasivas

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

Solicitud al servidor

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

<item key>

Respuesta del agente

<DATA>[\0<ERROR>]

Arriba, la parte entre corchetes es opcional y solo se envía para métricas no compatibles.

Por ejemplo, para métricas compatibles:

1. El servidor abre una conexión TCP
2. El servidor envía <HEADER><DATALEN>agent.ping
3. El agente lee la solicitud y responde con <HEADER><DATALEN>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>vfs.fs.size[/nono]
3. El agente lee la solicitud y responde con <HEADER><DATALEN>ZBX_NOTSUPPORTED\0Cannot obtainfilesystem information: [2] No such file or directory
4. El servidor procesa datos, cambia el estado de la métrica a no compatible con el mensaje de error especificado
5. La conexión TCP se cierra

Comprobaciones activas

Las comprobaciones activas requieren un procesamiento más complejo. El agente primero debe recuperar del servidor(es) una lista de métricas para su procesamiento independiente.

Los servidores desde los que obtener las comprobaciones activas se enumeran en el parámetro 'ServerActive' del archivo de configuración del agente. La frecuencia de interrogación para estas comprobaciones se establece mediante 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 codificados.

Luego, el agente envía periódicamente los nuevos valores a los servidores.

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. Esta solicitud la envía el agente al inicio y luego con intervalos RefreshActiveChecks.

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

Respuesta del servidor

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

{
         "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": "10 m",
             "lastlogsize": 0,
             "mtime": 0
           }
         ]
       }

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 (clave de métrica, retraso)
4. El agente analiza la respuesta.
5. La conexión TCP está cerrada
6. El agente inicia la recopilación periódica de datos.

Envío de datos recopilados

El agente envía

La solicitud de datos del agente contiene los valores de las métricas recopiladas.

{
         "request": "agent data",
         "data": [
           {
             "host": "servidor Zabbix",
             "key": "agent.version",
             "value": "2.4.0",
             "clock": 1400675595,
             "ns": 76808644
           },
           {
             "host": "servidor Zabbix",
             "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"
       }

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 sesión). Este ID se utiliza para descartar valores duplicados que puedan enviarse en entornos de 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 está cerrada

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 "valor".

Protocolo XML más antiguo