Documentation
Table of Contents
7 Protocol d'exportaci¨® en temps real
Aquesta secci¨® proporciona detalls del protocol exportaci¨® en temps real en format JSON delimitat de nova l¨ªnia per a:
-exportaci¨® de dades a fitxers -transmissi¨® a sistemes externs
Es pot exportar el seg¨¹ent:
- esdeveniments de trigger
- valors d'element
- ³Ù±ð²Ô»å¨¨²Ô³¦¾±±ð²õ (exportar nom¨¦s a arxius)
Tots els fitxers tenen l'extensi¨® .ndjson. Cada l¨ªnia del fitxer d'exportaci¨® ¨¦s un objecte JSON.
Esdeveniments de trigger
S'exporta la informaci¨® seg¨¹ent per a un esdeveniment problem¨¤tic:
|Camp|<|<|Tipus|¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®| |-|-|-----------|----------|------------------------ -------| |clock|<|<|nombre|Nombre de segons des de l'?poca fins que es va detectar el problema (part entera).| |ns|<|<|nombre|Nombre de nanosegons que cal afegir al clock per obtindre el temps prec¨ªs de detecci¨® de problemes.| |valor|<|<|nombre|1 (sempre).| |eventid|<|<|nombre|identificador de l'esdeveniment del problema| |nom|<|<|cadena|Nom de l'esdeveniment del problema.| |gravetat|<|<|nombre|Gravetat de l'esdeveniment problema (0 - No classificat, 1 - Informaci¨®, 2 - Av¨ªs, 3 - Mitjana, 4 - Alta, 5 - Desastre).| |hosts|<|<|array|Llista d'equips implicats en l'expressi¨® del trigger; hi ha d'haver almenys un element a la matriu.| | |-|<|objecte|<| |^| |host|string|Nom de l'equip.| |||name|cadena|Nom d'equip visible.| |groups|<|<|array|Llista de grups d'equip de tots els equips implicats en l'expressi¨® trigger; hi ha d'haver almenys un element a la matriu.| | |-|<|string|Nom del grup d'equip.| |etiquetes|<|<|matriu|Llista d'etiquetes problem¨¤tiques (poden ¨¦sser buides).| | |-|<|objecte|<| |^| |etiqueta|cadena|Nom de l'etiqueta.| |||valor|cadena|Valor de l'etiqueta (pot ¨¦sser buida).|
S'exporta la informaci¨® seg¨¹ent per a un esdeveniment de recuperaci¨®:
| Camp | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| clock | compte | Nombre de segons des de l'¨¨poca fins que es va resoldre el problema (part entera). |
| ns | nombre | Nombre de nanosegons que cal afegir a clock per obtindre el temps prec¨ªs de resoluci¨® de problemes. |
| valor | nombre | 0 (sempre). |
| eventid | nombre | ID d'esdeveniment de recuperaci¨®. |
| p_eventid | nombre | ID d'esdeveniment del problema. |
Exemples
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¨® de diversos esdeveniments problem¨¤tics):
{"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}Valors d'element
S'exporta la informaci¨® seg¨¹ent per al valor d'un element recollit:
| Camp | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® | |
|---|---|---|---|
| host | object | Nom d'equip de l'equip de l'element. | |
| host | string | Nom de l'equip. | |
| nom | string | Nom visible de l'equip. | |
| groups | array | Llista de grups d'equips de l'element equip; hi ha d'haver almenys un element a la matriu. | |
| - | string | Nom del grup d'equips. | |
| item_tags | array | ||
| - | objecte | ||
| tag | string | ||
| value | string | ||
| itemid | number | ID de l'element. | |
| name | string | Nom de l'element visible. | |
| clock | number | Nombre de segons des de l'?poca fins que es va recopilar el valor (part entera). | |
| ns | number | Nombre de nanosegons que cal afegir a clock per obtindre un temps de recollida de valors prec¨ªs. |
|
| timestamp (²Ô´Ç³¾¨¦²õ Journal) |
number | 0 si no ¨¦s pas disponible. | |
| source (²Ô´Ç³¾¨¦²õ Journal) |
string | Cadena buida si no ¨¦s pas disponible. | |
| severity (²Ô´Ç³¾¨¦²õ Journal) |
number | 0 si no ¨¦s pas disponible. | |
| eventid (²Ô´Ç³¾¨¦²õ Journal) |
number | 0 si no ¨¦s pas disponible. | |
| value | number (per a elements num¨¨rics) o string (per a elements de text) |
Valor de l'element recollit. | |
| types | number | Tipus de valor recollit: 0 - nombre flotant, 1 - car¨¤cter, 2 - registre, 3 - num¨¨ric sense signe, 4 - text, 5 - binari |
|
Exemples
Valor num¨¨ric (no signat):
{"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¨¨ric (flotant):
{"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}Car¨¤cter, valor de text:
{"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 registre:
{"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}°Õ±ð²Ô»å¨¨²Ô³¦¾±±ð²õ
S'exporta la informaci¨® seg¨¹ent per a un valor de tend¨¨ncia calculat:
| Camp | Tipus | ||
|---|---|---|---|
| host | object | ||
| host | string | ||
| nom | string | ||
| groups | array | ||
| - | string | ||
| item_tags | array | ||
| - | object | ||
| tag | string | ||
| value | string | ||
| itemid | number | ||
| name | string | ||
| clock | number | ||
| count | number | ||
| min | number | ||
| avg | number | ||
| max | number | ||
| type | number | ||
Exemples
Valor num¨¨ric (sense signe):
{"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¨¨ric (flotant):