7 Protocolo de exportación JSON delimitado por 'salto de linea'

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

• exportación de datos a archivos
• transmisión a sistemas externos

Se puede exportar lo siguiente:

• eventos de iniciador
• valores de métricas
• tendencias (exportar solo a archivos)

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:

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

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 eventos de múltiples problemas):

{"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 de equipo del equipo de la métrica.| | |host|<|cadena|Nombre de equipo.| |^|name|<|cadena|Nombre visible de equipo.| |groups|<|<|matriz|Lista de grupos de equipos de la métrica de equipo; debe haber al menos un elemento en la matriz.| | |-|<|string|Nombre del grupo de equipos.| |item_tags|<|<|array|Lista de etiquetas de métricas (puede estar vacía).| | |-|<|object|<| |^| |tag|cadena|Nombre de etiqueta.| |^||value|cadena|Valor de etiqueta (puede estar vacío).| |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 del elemento recopilado.| |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"],"item_tags":[{"tag":"foo","value":"test"}],"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"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0}

Caracter, valor de texto:

{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"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"],"item_tags":[{"tag":"foo","value":"test"}],"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 de tendencia calculado:

|Campo|<|<|Tipo|Descripción| |-|-|---------|---------|------------------------- --| |host|<|<|objeto|Nombre de equipo del equipo de la métrica.| | |host|<|cadena|Nombre de equipo.| |^|name|<|cadena|Nombre visible de equipo.| |groups|<|<|matriz|Lista de grupos de equipos del equipo de la métricat; debe haber al menos un elemento en la matriz.| | |-|<|string|Nombre del grupo de equipos.| |item_tags|<|<|array|Lista de etiquetas de la métrica (puede estar vacía).| | |-|<|object|<| |^| |tag|cadena|Nombre de etiqueta.| |^||value|cadena|Valor de etiqueta (puede estar vacío).| |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|<|<|número|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"],"item_tags":[{"tag":"foo","value":"test"}],"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"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0}