Documentation
Table of Contents
7 Protocol voor exporteren in JSON-indeling met scheidingstekens voor nieuwe regels
Dit gedeelte geeft details weer van het exportprotocol in een JSON-indeling met scheidingstekens voor nieuwe regels, dat wordt gebruikt bij:
Het volgende kan worden geëxporteerd:
- triggergebeurtenissen
- itemwaarden
- trends (alleen exporteren naar bestanden)
Alle bestanden hebben de extensie .ndjson. Elke regel van het exportbestand is een JSON-object.
Triggergebeurtenissen
De volgende informatie wordt geëxporteerd voor een probleemgebeurtenis:
| Veld | Type | Beschrijving | ||
|---|---|---|---|---|
| clock | getal | Aantal seconden sinds Epoch op het moment dat het probleem werd gedetecteerd (geheel getal). | ||
| ns | getal | Aantal nanoseconden dat aan clock moet worden toegevoegd om een nauwkeurige detectietijd van het probleem te krijgen. |
||
| value | getal | 1 (altijd). | ||
| eventid | getal | ID van het probleemgebeurtenis. | ||
| name | tekenreeks | Naam van de probleemgebeurtenis. | ||
| severity | getal | Ernst van de probleemgebeurtenis (0 - Niet geclassificeerd, 1 - Informatie, 2 - Waarschuwing, 3 - Gemiddeld, 4 - Hoog, 5 - Ramp). | ||
| hosts | reeks | Lijst van hosts die betrokken zijn bij de triggerexpressie; er moet minimaal één element in de reeks zijn. | ||
| - | object | |||
| host | tekenreeks | Hostnaam. | ||
| name | tekenreeks | Zichtbare hostnaam. | ||
| groups | reeks | Lijst van hostgroepen van alle hosts die betrokken zijn bij de triggerexpressie; er moet minimaal één element in de reeks zijn. | ||
| - | tekenreeks | Naam van de hostgroep. | ||
| tags | reeks | Lijst van probleemtags (kan leeg zijn). | ||
| - | object | |||
| tag | tekenreeks | Naam van de tag. | ||
| value | tekenreeks | Tagwaarde (kan leeg zijn). | ||
De volgende informatie wordt geëxporteerd voor een herstelgebeurtenis:
| Veld | Type | Beschrijving |
|---|---|---|
| clock | getal | Aantal seconden sinds Epoch op het moment dat het probleem werd opgelost (geheel getal). |
| ns | getal | Aantal nanoseconden dat aan clock moet worden toegevoegd om een nauwkeurige tijdstip voor probleemoplossing te krijgen. |
| value | getal | 0 (altijd). |
| eventid | getal | ID van de herstelgebeurtenis. |
| p_eventid | getal | ID van de probleemgebeurtenis. |
Voorbeelden
Probleem:
{"clock":1519304285,"ns":123456789,"value":1,"name":"Ofwel Zabbix-agent is onbereikbaar op Host B of pollers hebben het te druk op Zabbix Server","severity":3,"eventid ":42, "hosts":[{"host":"Host B", "name":"Host B zichtbaar"},{"host":"Zabbix Server","name":"Zabbix Server zichtbaar"} ],"groups":["Groep X","Groep Y","Groep Z","Zabbix-servers"],"tags":[{"tag":"beschikbaarheid","value":""}, {"tag":"datacenter","value":"Riga"}]}Herstel:
Probleem (generatie van meerdere probleemgebeurtenissen):
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Ofwel Zabbix-agent is onbereikbaar op Host B of pollers hebben het te druk op Zabbix Server","severity ":3,"hosts":[{"host":"Host B", "name":"Host B zichtbaar"},{"host":"Zabbix Server","name":"Zabbix Server zichtbaar"} ],"groups":["Groep X","Groep Y","Groep Z","Zabbix-servers"],"tags":[{"tag":"beschikbaarheid","value":""}, {"tag":"datacenter","value":"Riga"}]}
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Ofwel Zabbix-agent is onbereikbaar op Host B of pollers hebben het te druk op Zabbix Server","severity ":3,"hosts":[{"host":"Host B", "name":"Host B zichtbaar"},{"host":"Zabbix Server","name":"Zabbix Server zichtbaar"} ],"groups":["Groep X","Groep Y","Groep Z","Zabbix-servers"],"tags":[{"tag":"beschikbaarheid","value":""}, {"tag":"datacenter","value":"Riga"}]}Herstel:
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43}
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42}Itemwaarden
De volgende informatie wordt geëxporteerd voor een verzamelde itemwaarde:
| Veld | Type | Beschrijving | ||
|---|---|---|---|---|
| host | object | Hostnaam van de host van het item. | ||
| host | tekenreeks | Hostnaam. | ||
| name | tekenreeks | Zichtbare hostnaam. | ||
| groups | reeks | Lijst van hostgroepen van de host van het item; er moet minimaal één element in de reeks zijn. | ||
| - | tekenreeks | Naam van de hostgroep. | ||
| item_tags | reeks | Lijst van itemtags (kan leeg zijn). | ||
| - | object | |||
| tag | tekenreeks | Naam van de tag. | ||
| value | tekenreeks | Tagwaarde (kan leeg zijn). | ||
| itemid | getal | Item-ID. | ||
| name | tekenreeks | Zichtbare itemnaam. | ||
| clock | getal | Aantal seconden sinds Epoch op het moment dat de waarde werd verzameld (geheel getal). | ||
| ns | getal | Aantal nanoseconden dat aan clock moet worden toegevoegd om een nauwkeurige tijdstip voor waardeverzameling te krijgen. |
||
| timestamp (Alleen log) |
getal | 0 indien niet beschikbaar. | ||
| source (Alleen log) |
tekenreeks | Lege tekenreeks indien niet beschikbaar. | ||
| severity (Alleen log) |
getal | 0 indien niet beschikbaar. | ||
| eventid (Alleen log) |
getal | 0 indien niet beschikbaar. | ||
| value | getal (voor numerieke items) of tekenreeks (voor tekstitems) |
Verzamelde itemwaarde. | ||
| type | getal | Type verzamelde waarde: 0 - numerieke float, 1 - tekenreeks, 2 - log, 3 - niet-ondertekende numerieke waarde, 4 - tekst |
||
Voorbeelden
Numerieke (ongetekende) waarde:
{"host": {"host": "Host B", "name": "Host B zichtbaar"}, "groups": ["Groep X", "Groep Y", "Groep Z"], "item_tags": [{"tag": "foo", "value": "test"}], "itemid": 3, "name": "Beschikbaarheid van agent", "clock": 1519304285, "ns": 123456789, "value": 1, "type": 3}Numerieke (drijvende komma) waarde:
{"host": {"host": "Host B", "name": "Host B zichtbaar"}, "groups": ["Groep X", "Groep Y", "Groep Z"], "item_tags": [{"tag": "foo", "value": "test"}], "itemid": 4, "name": "CPU-belasting", "clock": 1519304285, "ns": 123456789, "value": 0.1, "type": 0}Karakter, tekstwaarde:
{"host": {"host": "Host B", "name": "Host B zichtbaar"}, "groups": ["Groep X", "Groep Y", "Groep Z"], "item_tags": [{"tag": "foo", "value": "test"}], "itemid": 2, "name": "Versie van agent", "clock": 1519304285, "ns": 123456789, "value": "3.4.4", "type": 4}Logwaarde:
{"host": {"host": "Host A", "name": "Host A zichtbaar"}, "groups": ["Groep X", "Groep Y", "Groep Z"], "item_tags": [{"tag": "foo", "value": "test"}], "itemid": 1, "name": "Berichten in logbestand", "clock": 1519304285, "ns": 123456789, "timestamp": 1519304285, "source": "", "severity": 0, "eventid": 0, "value": "logbestandbericht", "type": 2}Trends
De volgende informatie wordt geëxporteerd voor een berekende trendwaarde:
| Veld | Type | Beschrijving | ||
|---|---|---|---|---|
| host | object | Hostnaam van de host van het item. | ||
| host | tekenreeks | Hostnaam. | ||
| name | tekenreeks | Zichtbare hostnaam. | ||
| groups | reeks | Lijst van hostgroepen van de host van het item; er moet minimaal één element in de reeks zijn. | ||
| - | tekenreeks | Naam van de hostgroep. | ||
| item_tags | reeks | Lijst van itemtags (kan leeg zijn). | ||
| - | object | |||
| tag | tekenreeks | Naam van de tag. | ||
| value | tekenreeks | Tagwaarde (kan leeg zijn). | ||
| itemid | getal | Item-ID. | ||
| name | tekenreeks | Zichtbare itemnaam. | ||
| clock | getal | Aantal seconden sinds Epoch op het moment dat de waarde werd verzameld (geheel getal). | ||
| count | getal | Aantal verzamelde waarden voor een gegeven uur. | ||
| min | getal | Minimum itemwaarde voor een gegeven uur. | ||
| avg | getal | Gemiddelde itemwaarde voor een gegeven uur. | ||
| max | getal | Maximale itemwaarde voor een gegeven uur. | ||
| type | getal | Type waarde: 0 - numerieke float, 3 - niet-ondertekende numerieke waarde |
||
Voorbeelden
Numerieke (ongetekende) waarde:
{"host": {"host": "Host B", "name": "Host B zichtbaar"}, "groups": ["Groep X", "Groep Y", "Groep Z"], "item_tags": [{"tag": "foo", "value": "test"}], "itemid": 3, "name": "Beschikbaarheid van agent", "clock": 1519304285, "ns": 123456789, "value": 1, "type": 3}Numerieke (drijvende komma) waarde:
{"host": {"host": "Host B", "name": "Host B zichtbaar"}, "groups": ["Groep X", "Groep Y", "Groep Z"], "item_tags": [{"tag": "foo", "value": "test"}], "itemid": 4, "name": "CPU-belasting", "clock": 1519304285, "ns": 123456789, "value": 0.1, "type": 0}Karakter, tekstwaarde:
{"host": {"host": "Host B", "name": "Host B zichtbaar"}, "groups": ["Groep X", "Groep Y", "Groep Z"], "item_tags": [{"tag": "foo", "value": "test"}], "itemid": 2, "name": "Versie van agent", "clock": 1519304285, "ns": 123456789, "value": "3.4.4", "type": 4}Logwaarde:
{"host": {"host": "Host A", "name": "Host A zichtbaar"}, "groups": ["Groep X", "Groep Y", "Groep Z"], "item_tags": [{"tag": "foo", "value": "test"}], "itemid": 1, "name": "Berichten in logbestand", "clock": 1519304285, "ns": 123456789, "timestamp": 1519304285, "source": "", "severity": 0, "eventid": 0, "value": "logbestandbericht", "type": 2}