7 Protocollo di esportazione JSON delimitato da newline
Questa sezione presenta i dettagli del protocollo di esportazione in formato JSON delimitato da newline, utilizzato in:
È possibile esportare quanto segue:
- eventi dei trigger
- valori degli item
- trend (solo esportazione in file)
Tutti i file hanno estensione .ndjson. Ogni riga del file di esportazione è un oggetto JSON.
Eventi trigger
Le seguenti informazioni vengono esportate per un evento di problema:
| Campo | Tipo | Descrizione | ||
|---|---|---|---|---|
| clock | number | Numero di secondi trascorsi dall'Epoch fino al momento in cui il problema è stato rilevato (parte intera). | ||
| ns | number | Numero di nanosecondi da aggiungere a clock per ottenere l'ora precisa di rilevamento del problema. |
||
| value | number | 1 (sempre). | ||
| eventid | number | ID dell'evento di problema. | ||
| name | string | Nome dell'evento di problema. | ||
| severity | number | Gravità dell'evento di problema (0 - Non classificato, 1 - Informazione, 2 - Avviso, 3 - Media, 4 - Alta, 5 - Disastro). | ||
| hosts | array | Elenco degli host coinvolti nell'espressione del trigger; nell'array deve essere presente almeno un elemento. | ||
| - | object | |||
| host | string | Nome host. | ||
| name | string | Nome host visibile. | ||
| groups | array | Elenco dei gruppi host di tutti gli host coinvolti nell'espressione del trigger; nell'array deve essere presente almeno un elemento. | ||
| - | string | Nome del gruppo host. | ||
| tags | array | Elenco dei tag del problema (può essere vuoto). | ||
| - | object | |||
| tag | string | Nome del tag. | ||
| value | string | Valore del tag (può essere vuoto). | ||
Le seguenti informazioni vengono esportate per un evento di ripristino:
| Campo | Tipo | Descrizione |
|---|---|---|
| clock | number | Numero di secondi trascorsi dall'Epoch fino al momento in cui il problema è stato risolto (parte intera). |
| ns | number | Numero di nanosecondi da aggiungere a clock per ottenere l'ora precisa di risoluzione del problema. |
| value | number | 0 (sempre). |
| eventid | number | ID dell'evento di ripristino. |
| p_eventid | number | ID dell'evento di problema. |
Esempi
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"}]}
Ripristino:
{"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42}
Problema (generazione di eventi problema multipli):
{"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"}]}
Ripristino:
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43}
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42}
Valori degli item
Le seguenti informazioni vengono esportate per un valore raccolto di un item:
| Campo | Tipo | Descrizione | ||
|---|---|---|---|---|
| host | object | Nome del host dell'item. | ||
| host | string | Nome del host. | ||
| name | string | Nome visibile del host. | ||
| groups | array | Elenco dei gruppi di host del host dell'item; nell'array deve essere presente almeno un elemento. | ||
| - | string | Nome del gruppo di host. | ||
| item_tags | array | Elenco dei tag dell'item (può essere vuoto). | ||
| - | object | |||
| tag | string | Nome del tag. | ||
| value | string | Valore del tag (può essere vuoto). | ||
| itemid | number | ID dell'item. | ||
| name | string | Nome visibile dell'item. | ||
| clock | number | Numero di secondi trascorsi dall'Epoch fino al momento in cui il valore è stato raccolto (parte intera). | ||
| ns | number | Numero di nanosecondi da aggiungere a clock per ottenere l'ora precisa di raccolta del valore. |
||
| timestamp (Log only) |
number | 0 se non disponibile. | ||
| source (Log only) |
string | Stringa vuota se non disponibile. | ||
| severity (Log only) |
number | 0 se non disponibile. | ||
| eventid (Log only) |
number | 0 se non disponibile. | ||
| value | number (for numeric items) or string (for text items) |
Valore raccolto dell'item. | ||
| type | number | Tipo di valore raccolto: 0 - numerico in virgola mobile, 1 - carattere, 2 - log, 3 - numerico senza segno, 4 - testo, 5 - binario, 6 - JSON |
||
Esempi
Valore numerico (senza segno):
{"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}
Valore numerico (float):
{"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}
Valore carattere, testo:
{"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}
Valore log:
{"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}
Trend
Per un valore di trend calcolato vengono esportate le seguenti informazioni:
| Campo | Tipo | Descrizione | ||
|---|---|---|---|---|
| host | object | Nome del host dell'item. | ||
| host | string | Nome del host. | ||
| name | string | Nome visibile del host. | ||
| groups | array | Elenco dei gruppi di host del host dell'item; nell'array deve essere presente almeno un elemento. | ||
| - | string | Nome del gruppo di host. | ||
| item_tags | array | Elenco dei tag dell'item (può essere vuoto). | ||
| - | object | |||
| tag | string | Nome del tag. | ||
| value | string | Valore del tag (può essere vuoto). | ||
| itemid | number | ID dell'item. | ||
| name | string | Nome visibile dell'item. | ||
| clock | number | Numero di secondi trascorsi dall'Epoch fino al momento in cui il valore è stato raccolto (parte intera). | ||
| count | number | Numero di valori raccolti per una determinata ora. | ||
| min | number | Valore minimo dell'item per una determinata ora. | ||
| avg | number | Valore medio dell'item per una determinata ora. | ||
| max | number | Valore massimo dell'item per una determinata ora. | ||
| type | number | Tipo di valore: 0 - numerico in virgola mobile, 3 - numerico senza segno |
||
Esempi
Valore numerico (senza segno):
{"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}
Valore numerico (float):
{"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}