Documentation
Table of Contents
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
- Agente2 -> Servidor: mensaje de latido
Solicitud de comprobaciones activas
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.
| Campo | Tipo | Obligatorio | Valor |
|---|---|---|---|
| request | cadena | si | comprobaciones activas |
| host | cadena | si | Nombre del equipo. |
| 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. |
| config_revision | número | no | Identificador de configuración para sincronización de configuración incremental. |
| session | cadena | no | Identificador de sesión para sincronización de configuración incremental. |
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,
"config_revision": 1,
"session": "e3dcbd9ace2c9694e1d7bbd030eeef6e"
}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 | éxito | fallido |
|
| info | cadena | no | Información de error en caso de fallo. | |
| data | conjunto de objetos | no | Elementos de cheques activos. Se omite si la configuración del host no se modifica. | |
| 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. | |
| config_revision | número | no | Identificador de configuración para sincronización de configuración incremental. Se omite si la configuración del host no se modifica. Se incrementa si se cambia la configuración del equipo. | |
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
}
],
"config_revision": 2
}Solicitud de datos del agente
La solicitud de datos del agente contiene los valores recopilados de las métricas.
| Campo | Tipo | Obligatorio | Valor | |
|---|---|---|---|---|
| request | cadena | si | datos del agente |
|
| host | cadena | si | Nombre del anfitrión. | |
| 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 | 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:
Mensaje de latido
El mensaje de latido es enviado por un agente activo al servidor/proxy de Zabbix cada número de segundos indicados en HeartbeatFrequency (configurado en el archivo de configuración del agente 2 Zabbix).
Se utiliza para monitorear la disponibilidad de comprobaciones activas.
| Campo | Tipo | Obligatorio | Valor |
|---|---|---|---|
| request | cadena | si | comprobación activa del latido del corazón |
| host | cadena | si | El nombre del equipo. |
| heartbeat_freq | número | si | La frecuencia de latido del agente (parámetro de configuración HeartbeatFrequency). |