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 | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | ||
|---|---|---|---|---|
| clock | ²Ô¨²³¾±ð°ù´Ç | N¨²mero de segundos desde la ¨¦poca hasta el momento en que se detect¨® el problema (parte entera). | ||
| ns | ²Ô¨²³¾±ð°ù´Ç | N¨²mero de nanosegundos que se agregar¨¢n al reloj para obtener un tiempo preciso de detecci¨®n del problema. |
||
| value | ²Ô¨²³¾±ð°ù´Ç | 1 (siempre). | ||
| eventid | ²Ô¨²³¾±ð°ù´Ç | ID del evento del problema. | ||
| name | cadena | Nombre del evento del problema. | ||
| severity | ²Ô¨²³¾±ð°ù´Ç | 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 | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| clock | ²Ô¨²³¾±ð°ù´Ç | N¨²mero de segundos desde la ¨¦poca hasta el momento en que se resolvi¨® el problema (parte entera). |
| ns | ²Ô¨²³¾±ð°ù´Ç | N¨²mero de nanosegundos que se agregar¨¢n al reloj para obtener un tiempo preciso de resoluci¨®n del problema. |
| value | ²Ô¨²³¾±ð°ù´Ç | 0 (siempre). |
| eventid | ²Ô¨²³¾±ð°ù´Ç | ID del evento de recuperaci¨®n. |
| p_eventid | ²Ô¨²³¾±ð°ù´Ç | ID del evento del problema. |
Ejemplos
Problema:
{"clock":1519304285,"ns":123456789,"value":1,"name":"Either Áú»¢¶Ä²© agent is unreachable on Host B or pollers are too busy on Áú»¢¶Ä²© Server","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Áú»¢¶Ä²© Server","name":"Áú»¢¶Ä²© Server visible"}],"groups":["Group X","Group Y","Group Z","Áú»¢¶Ä²© servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}¸é±ð³¦³Ü±è±ð°ù²¹³¦¾±¨®²Ô:
Problema (Generaci¨®n de eventos de m¨²ltiples problemas):
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Áú»¢¶Ä²© agent is unreachable on Host B or pollers are too busy on Áú»¢¶Ä²© Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Áú»¢¶Ä²© Server","name":"Áú»¢¶Ä²© Server visible"}],"groups":["Group X","Group Y","Group Z","Áú»¢¶Ä²© servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Áú»¢¶Ä²© agent is unreachable on Host B or pollers are too busy on Áú»¢¶Ä²© Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Áú»¢¶Ä²© Server","name":"Áú»¢¶Ä²© Server visible"}],"groups":["Group X","Group Y","Group Z","Áú»¢¶Ä²© servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}¸é±ð³¦³Ü±è±ð°ù²¹³¦¾±¨®²Ô:
{"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¨¦trica
La siguiente informaci¨®n se exporta para un valor de m¨¦trica recopilado:
| Campo | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | ||
|---|---|---|---|---|
| host | objeto | Nombre de equipo del equipo de la m¨¦trica. | ||
| host | cadena | Nombre de equipo. | ||
| name | cadena | Nombre de equipo visible. | ||
| groups | matriz | Lista de grupos de equipo de la m¨¦trica de equipo; debe haber al menos una m¨¦trica en la matriz. | ||
| - | cadena | Nombre del grupo de equipos. | ||
| item_tags | array | Lista de etiquetas de m¨¦tricas (puede estar vac¨ªa). | ||
| - | objeto | |||
| tag | cadena | Nombre de etiqueta. | ||
| value | cadena | Valor de etiqueta (puede estar vac¨ªo). | ||
| itemid | ²Ô¨²³¾±ð°ù´Ç | ID de la m¨¦trica. | ||
| name | cadena | Nombre de la m¨¦trica visible. | ||
| clock | ²Ô¨²³¾±ð°ù´Ç | N¨²mero de segundos desde la ¨¦poca hasta el momento en que se recopil¨® el valor (parte entera). | ||
| ns | ²Ô¨²³¾±ð°ù´Ç | N¨²mero de nanosegundos que se agregar¨¢n al reloj para obtener un tiempo de recopilaci¨®n de valores preciso. |
||
| timestamp (Registro solamente) |
²Ô¨²³¾±ð°ù´Ç | 0 si no est¨¢ disponible. | ||
| source (Registro solamente) |
cadena | Cadena vac¨ªa si no est¨¢ disponible. | ||
| severity (Registro solamente) |
²Ô¨²³¾±ð°ù´Ç | 0 si no est¨¢ disponible. | ||
| eventid (Registro solamente) |
²Ô¨²³¾±ð°ù´Ç | 0 si no est¨¢ disponible. | ||
| value | ²Ô¨²³¾±ð°ù´Ç (para m¨¦tricas num¨¦ricas) o cadena (para m¨¦tricas de texto) |
Valor de la m¨¦trica recopilada. | ||
| type | ²Ô¨²³¾±ð°ù´Ç | Tipo de valor recopilado: 0 - flotante num¨¦rico, 1 - car¨¢cter, 2 - registro, 3 - num¨¦rico sin signo, 4 - texto, 5 - binario |
||
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|¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô| |-|-|---------|---------|------------------------- --| |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|<|<|²Ô¨²³¾±ð°ù´Ç|ID de la m¨¦trica.| |name|<|<|cadena|Nombre visible de la m¨¦trica .| |clock|<|<|²Ô¨²³¾±ð°ù´Ç|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|<|<|²Ô¨²³¾±ð°ù´Ç|Valor m¨ªnimo de la m¨¦trica para una hora determinada.| |avg|<|<|²Ô¨²³¾±ð°ù´Ç|Valor promedio de la m¨¦trica para una hora determinada.| |max|<|<|²Ô¨²³¾±ð°ù´Ç|Valor m¨¢ximo de la m¨¦trica para una hora determinada.| |type|<|<|²Ô¨²³¾±ð°ù´Ç|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):