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
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: