Documentation
Table of Contents
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:
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:
| 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 | matriz | Lista de equipos involucrados en la expresión del iniciador; debe haber al menos un elemento en la matriz. | ||
| - | object | |||
| host | cadena | Nombre de equipo. | ||
| name | cadena | Nombre visible de equipo. | ||
| groups | array | Lista de grupos de equipos de todos los equipos involucrados en la expresión del iniciador; debe haber al menos un elemento en la matriz. | ||
| - | string | Nombre del grupo de equipos. | ||
| tags | array | Lista de etiquetas de problemas (puede estar vacía). | ||
| - | object | |||
| 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. |
| value | 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:
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):