7 Protocolo de exportación en tiempo real

Esta sección presenta detalles del protocolo de exportación en tiempo real en formato JSON delimitado por salto de línea para:

Todos los archivos tienen una extensión .ndjson. Cada línea del archivo de exportación es un Objeto JSON.

Eventos de iniciador

La siguiente información se exporta para un evento de problema:

Campo Tipo Descripción
clock número Número de segundos desde la época hasta el momento en que se detectó el problema (parte entera).
ns número Número de nanosegundos que se agregarán al reloj para obtener un tiempo preciso de detección del problema.
value número 1 (siempre).
eventid número ID del evento del problema.
name cadena Nombre del evento del problema.
severity número Severidad del evento problemático (0 - No clasificado, 1 - Información, 2 - Advertencia, 3 - Promedio, 4 - Alta, 5 - Desastre).
hosts array Lista de hosts involucrados en la expresión desencadenante; debe haber al menos un elemento en la matriz.
- objeto
host cadena Nombre de equipo.
name cadena Nombre de equipo visible.
groups array Lista de grupos de equipos de todos los equipos involucrados en la expresión desencadenante; debe haber al menos un elemento en la matriz.
- cadena Nombre del grupo de host.
tags array Lista de etiquetas de problemas (puede estar vacía).
- objeto
tag cadena Nombre de etiqueta.
value cadena Valor de etiqueta (puede estar vacío).

La siguiente información se exporta para un evento de recuperación:

Campo Tipo Descripción
clock número Número de segundos desde la época hasta el momento en que se resolvió el problema (parte entera).
ns número Número de nanosegundos que se agregarán al reloj para obtener un tiempo preciso de resolución del problema.
valor número 0 (siempre).
eventid número ID del evento de recuperación.
p_eventid número ID del evento del problema.
Ejemplos

Problema:

{"clock":1519304285,"ns":123456789,"value":1,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}

Recuperación:

{"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42}

Problema (generación de múltiples eventos de problema):

{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}

{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}

Recuperación:

{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43}

{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42}

Valores de métricas

La siguiente información se exporta para un valor de métrica recopilado:

Campo Tipo Descripción
host objeto Nombre del equipo de la métrica.
host cadena Nombre de equipo.
name cadena Nombre de equipo visible.
groups array Lista de grupos de equipos del equipo de la métrica; debe haber al menos un elemento en la matriz.
- cadena Nombre del grupo de host.
itemid número ID de la métrica.
name cadena Nombre visible de la métrica.
clock número Número de segundos desde la época hasta el momento en que se recopiló el valor (parte entera).
ns número Número de nanosegundos que se agregarán al reloj para obtener un tiempo de recopilación de valores preciso.
timestamp
(Registro solamente)		 número 0 si no está disponible.
source
(Registro solamente)		 cadena Cadena vacía si no está disponible.
severity
(Registro solamente)		 número 0 si no está disponible.
eventid
(Registro solamente)		 número 0 si no está disponible.
value número (para métricas numéricas) o
cadena (para métricas de texto)		 Valor recopilado de la métrica.
type número Tipo de valor recopilado:
0 - flotante numérico, 1 - carácter, 2 - registro, 3 - numérico sin signo, 4 - texto
Ejemplos

Valor numérico (sin signo):

{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3}

Valor numérico (flotante):

{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0}

Valor caracter, texto:

{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4}

Valor de registro:

{"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2}

Tendencias

La siguiente información se exporta para un valor calculado de tendencia:

Campo Tipo Descripción
host objeto Nombre del equipo de la métrica.
host cadena Nombre de equipo.
name cadena Nombre visible del equipo.
groups array Lista de grupos de equipos del equipo de la métrica; debe haber al menos un elemento en la matriz.
- cadena Nombre del grupo de equipos.
itemid número ID de la métrica.
name cadena Nombre visible de la métrica.
clock número Número de segundos desde la época hasta el momento en que se recopiló el valor (parte entera).
count number Número de valores recopilados durante una hora determinada.
min número Valor mínimo de la métrica para una hora determinada.
avg number Valor promedio de la métrica para una hora determinada.
max número Valor máximo de la métrica para una hora determinada.
type número Tipo de valor:
0 - numérico flotante, 3 - numérico sin signo
Ejemplos

Valor numérico (sin signo):

{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}

Valor numérico (flotante):

{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0}