Table of Contents
7 Protocolo de exportación JSON delimitado por nueva línea
Esta sección presenta los detalles del protocolo de exportación en un formato JSON delimitado por nueva línea, utilizado en:
Se puede exportar lo siguiente:
- eventos de disparador
- valores de métricas
- tendencias (solo exportación a archivos)
Todos los archivos tienen una extensión .ndjson. Cada línea del archivo de exportación es un objeto JSON.
Eventos de disparo
Se exporta la siguiente información para un evento de problema:
| Campo | Tipo | Descripción | ||
|---|---|---|---|---|
| clock | number | Número de segundos desde Epoch hasta el momento en que se detectó el problema (parte entera). | ||
| ns | number | Número de nanosegundos a añadir a clock para obtener una hora precisa de detección del problema. |
||
| value | number | 1 (siempre). | ||
| eventid | number | ID del evento de problema. | ||
| name | string | Nombre del evento de problema. | ||
| severity | number | Gravedad del evento de problema (0 - No clasificado, 1 - Información, 2 - Advertencia, 3 - Media, 4 - Alta, 5 - Desastre). | ||
| hosts | array | Lista de equipos involucrados en la expresión del disparador; debe haber al menos un elemento en el array. | ||
| - | object | |||
| host | string | Nombre del equipo. | ||
| name | string | Nombre visible del equipo. | ||
| groups | array | Lista de grupos de equipos de todos los equipos involucrados en la expresión del disparador; debe haber al menos un elemento en el array. | ||
| - | string | Nombre del grupo de equipos. | ||
| tags | array | Lista de etiquetas de problema (puede estar vacía). | ||
| - | object | |||
| tag | string | Nombre de la etiqueta. | ||
| value | string | Valor de la etiqueta (puede estar vacío). | ||
Se exporta la siguiente información para un evento de recuperación:
| Campo | Tipo | Descripción |
|---|---|---|
| clock | number | Número de segundos desde Epoch hasta el momento en que se resolvió el problema (parte entera). |
| ns | number | Número de nanosegundos a añadir a clock para obtener una hora precisa de resolución del problema. |
| value | number | 0 (siempre). |
| eventid | number | ID del evento de recuperación. |
| p_eventid | number | ID del evento de 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 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
Se exporta la siguiente información para un valor de métrica recopilado:
| Campo | Tipo | Descripción | ||
|---|---|---|---|---|
| host | object | Nombre del equipo de la métrica. | ||
| host | string | Nombre del equipo. | ||
| name | string | Nombre visible del equipo. | ||
| groups | array | Lista de grupos de equipos del equipo de la métrica; debe haber al menos un elemento en el array. | ||
| - | string | Nombre del grupo de equipos. | ||
| item_tags | array | Lista de etiquetas de la métrica (puede estar vacío). | ||
| - | object | |||
| tag | string | Nombre de la etiqueta. | ||
| value | string | Valor de la etiqueta (puede estar vacío). | ||
| itemid | number | ID de la métrica. | ||
| name | string | Nombre visible de la métrica. | ||
| clock | number | Número de segundos desde Epoch hasta el momento en que se recopiló el valor (parte entera). | ||
| ns | number | Número de nanosegundos a añadir a clock para obtener el momento preciso de la recopilación del valor. |
||
| timestamp (Log solo) |
number | 0 si no está disponible. | ||
| source (Log solo) |
string | Cadena vacía si no está disponible. | ||
| severity (Log solo) |
number | 0 si no está disponible. | ||
| eventid (Log solo) |
number | 0 si no está disponible. | ||
| value | number (para métricas numéricas) o string (para métricas de texto) |
Valor de la métrica recopilado. | ||
| type | number | Tipo de valor recopilado: 0 - numérico flotante, 1 - carácter, 2 - log, 3 - numérico sin signo, 4 - texto, 5 - binario |
||
Ejemplos
Valor numérico (sin signo):
{"host":{"host":"Equipo B","name":"Equipo B visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Disponibilidad del agente","clock":1519304285,"ns":123456789,"value":1,"type":3}Valor numérico (coma flotante):
{"host":{"host":"Equipo B","name":"Equipo B visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"Carga de CPU","clock":1519304285,"ns":123456789,"value":0.1,"type":0}Valor carácter, texto:
{"host":{"host":"Equipo B","name":"Equipo B visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":2,"name":"Versión del agente","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4}Valor de registro:
{"host":{"host":"Equipo A","name":"Equipo A visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":1,"name":"Mensajes en el archivo de registro","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"mensaje del archivo de registro","type":2}Tendencias
Se exporta la siguiente información para un valor de tendencia calculado:
| Campo | Tipo | Descripción | ||
|---|---|---|---|---|
| host | objeto | Nombre del equipo de la métrica. | ||
| host | cadena | Nombre del 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 el array. | ||
| - | cadena | Nombre del grupo de equipos. | ||
| item_tags | array | Lista de etiquetas de la métrica (puede estar vacía). | ||
| - | objeto | |||
| tag | cadena | Nombre de la etiqueta. | ||
| value | cadena | Valor de la 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 Epoch hasta el momento en que se recogió el valor (parte entera). | ||
| count | número | Número de valores recogidos para una hora determinada. | ||
| min | número | Valor mínimo de la métrica para una hora determinada. | ||
| avg | número | Valor medio 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":"Equipo B","name":"Equipo B visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Disponibilidad del agente","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}Valor numérico (coma flotante):