7 Newline-delimited-JSON-Exportprotokoll
Dieser Abschnitt enthält Details zum Exportprotokoll im newline-delimited-JSON-Format, das verwendet wird in:
Folgendes kann exportiert werden:
- Auslöser-Ereignisse
- Datenpunkt-Werte
- Trends (nur Export in Dateien)
Alle Dateien haben die Erweiterung .ndjson. Jede Zeile der Exportdatei ist ein JSON-Objekt.
Auslöser-Ereignisse
Die folgenden Informationen werden für ein Problemereignis exportiert:
| Field | Type | Description | ||
|---|---|---|---|---|
| clock | number | Anzahl der Sekunden seit der Epoch bis zu dem Zeitpunkt, an dem das Problem erkannt wurde (Ganzzahlanteil). | ||
| ns | number | Anzahl der Nanosekunden, die zu clock addiert werden müssen, um eine genaue Problemerkennungszeit zu erhalten. |
||
| value | number | 1 (immer). | ||
| eventid | number | ID des Problemereignisses. | ||
| name | string | Name des Problemereignisses. | ||
| severity | number | Schweregrad des Problemereignisses (0 - Nicht klassifiziert, 1 - Information, 2 - Warnung, 3 - Durchschnittlich, 4 - Hoch, 5 - Katastrophe). | ||
| hosts | array | Liste der Hosts, die am Auslöser-Ausdruck beteiligt sind; es sollte mindestens ein Element im Array vorhanden sein. | ||
| - | object | |||
| host | string | Host-Name. | ||
| name | string | Sichtbarer Host-Name. | ||
| groups | array | Liste der Hostgruppen aller Hosts, die am Auslöser-Ausdruck beteiligt sind; es sollte mindestens ein Element im Array vorhanden sein. | ||
| - | string | Name der Hostgruppe. | ||
| tags | array | Liste der Problem-Tags (kann leer sein). | ||
| - | object | |||
| tag | string | Tag-Name. | ||
| value | string | Tag-Wert (kann leer sein). | ||
Die folgenden Informationen werden für ein Wiederherstellungsereignis exportiert:
| Field | Type | Description |
|---|---|---|
| clock | number | Anzahl der Sekunden seit der Epoch bis zu dem Zeitpunkt, an dem das Problem behoben wurde (Ganzzahlanteil). |
| ns | number | Anzahl der Nanosekunden, die zu clock addiert werden müssen, um eine genaue Problembehebungszeit zu erhalten. |
| value | number | 0 (immer). |
| eventid | number | ID des Wiederherstellungsereignisses. |
| p_eventid | number | ID des Problemereignisses. |
Beispiele
Problem:
{"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"}]}
Wiederherstellung:
{"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42}
Problem (Generierung von Mehrfachproblemen):
{"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"}]}
Wiederherstellung:
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43}
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42}
Datenpunktwerte
Die folgenden Informationen werden für einen erfassten Datenpunktwert exportiert:
| Feld | Type | Beschreibung | ||
|---|---|---|---|---|
| host | object | Host-Name des Datenpunkt-Hosts. | ||
| host | string | Host-Name. | ||
| name | string | Sichtbarer Host-Name. | ||
| groups | array | Liste der Host-Gruppen des Datenpunkt-Hosts; das Array sollte mindestens ein Element enthalten. | ||
| - | string | Name der Host-Gruppe. | ||
| item_tags | array | Liste der Datenpunkt-Tags (kann leer sein). | ||
| - | object | |||
| tag | string | Tag-Name. | ||
| value | string | Tag-Wert (kann leer sein). | ||
| itemid | number | Datenpunkt-ID. | ||
| name | string | Sichtbarer Datenpunktname. | ||
| clock | number | Anzahl der Sekunden seit der Epoch bis zu dem Zeitpunkt, an dem der Wert erfasst wurde (Ganzzahlanteil). | ||
| ns | number | Anzahl der Nanosekunden, die zu clock addiert werden müssen, um den genauen Zeitpunkt der Werterfassung zu erhalten. |
||
| timestamp (Log only) |
number | 0, falls nicht verfügbar. | ||
| source (Log only) |
string | Leere Zeichenfolge, falls nicht verfügbar. | ||
| severity (Log only) |
number | 0, falls nicht verfügbar. | ||
| eventid (Log only) |
number | 0, falls nicht verfügbar. | ||
| value | number (for numeric items) or string (for text items) |
Erfasster Datenpunktwert. | ||
| type | number | Typ des erfassten Werts: 0 - numerischer Gleitkommawert, 1 - Zeichen, 2 - Log, 3 - numerisch vorzeichenlos, 4 - Text, 5 - binär, 6 - JSON |
||
Beispiele
Numerischer (unsigned) Wert:
{"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}
Numerischer (float) Wert:
{"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}
Zeichen, Textwert:
{"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}
Log-Wert:
{"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}
Trends
Die folgenden Informationen werden für einen berechneten Trendwert exportiert:
| Feld | Typ | Beschreibung | ||
|---|---|---|---|---|
| host | object | Host-Name des Datenpunkt-Hosts. | ||
| host | string | Host-Name. | ||
| name | string | Sichtbarer Host-Name. | ||
| groups | array | Liste der Host-Gruppen des Datenpunkt-Hosts; das array sollte mindestens ein Element enthalten. | ||
| - | string | Name der Host-Gruppe. | ||
| item_tags | array | Liste der Datenpunkt-Tags (kann leer sein). | ||
| - | object | |||
| tag | string | Tag-Name. | ||
| value | string | Tag-Wert (kann leer sein). | ||
| itemid | number | Datenpunkt-ID. | ||
| name | string | Sichtbarer Datenpunkt-Name. | ||
| clock | number | Anzahl der Sekunden seit der Epoch bis zu dem Zeitpunkt, an dem der Wert erfasst wurde (Ganzzahlteil). | ||
| count | number | Anzahl der für eine bestimmte Stunde erfassten Werte. | ||
| min | number | Minimaler Datenpunkt-Wert für eine bestimmte Stunde. | ||
| avg | number | Durchschnittlicher Datenpunkt-Wert für eine bestimmte Stunde. | ||
| max | number | Maximaler Datenpunkt-Wert für eine bestimmte Stunde. | ||
| type | number | Werttyp: 0 - numerischer Gleitkommawert, 3 - numerisch ohne Vorzeichen |
||
Beispiele
Numerischer (unsigned) Wert:
{"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}
Numerischer (float) Wert:
{"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}