Table of Contents
7 Protocol voor realtime export
Deze sectie presenteert details van het real-time export protocol in een JSON-formaat met nieuwe regels voor:
Alle bestanden hebben een .ndjson-extensie. Elke regel van het exportbestand is een JSON-object.
Probleemgebeurtenissen
De volgende informatie wordt geëxporteerd voor een probleemgebeurtenis:
| Veld | Type | Omschrijving | ||
|---|---|---|---|---|
| clock | number | Aantal seconden sinds Epoch op het moment dat het probleem werd gedetecteerd (geheel getal). | ||
| ns | number | Aantal nanoseconden dat aan clock moet worden toegevoegd om een nauwkeurige tijdstip van probleemdetectie te krijgen. |
||
| value | number | 1 (altijd). | ||
| eventid | number | ID van de probleemgebeurtenis. | ||
| name | string | Naam van de probleemgebeurtenis. | ||
| severity | number | Ernst van de probleemgebeurtenis (0 - Niet geclassificeerd, 1 - Informatie, 2 - Waarschuwing, 3 - Gemiddeld, 4 - Hoog, 5 - Ramp). | ||
| hosts | array | Lijst van hosts betrokken bij de trigger expressie; er moet ten minste één element in de array zijn. | ||
| - | object | |||
| host | string | Hostnaam. | ||
| name | string | Zichtbare hostnaam. | ||
| groups | array | Lijst van hostgroepen van alle hosts betrokken bij de trigger expressie; er moet ten minste één element in de array zijn. | ||
| - | string | Naam van de hostgroep. | ||
| tags | array | Lijst van probleemtags (kan leeg zijn). | ||
| - | object | |||
| tag | string | Naam van de tag. | ||
| value | string | Tagwaarde (kan leeg zijn). | ||
De volgende informatie wordt geëxporteerd voor een herstelgebeurtenis:
| Veld | Type | Omschrijving |
|---|---|---|
| clock | number | Aantal seconden sinds Epoch op het moment dat het probleem is opgelost (geheel getal). |
| ns | number | Aantal nanoseconden dat aan clock moet worden toegevoegd om een nauwkeurige tijd van probleemoplossing te krijgen. |
| value | number | 0 (altijd). |
| eventid | number | ID van de herstelgebeurtenis. |
| p_eventid | number | 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}Artikelwaarden
De volgende informatie wordt geëxporteerd voor een verzamelde itemwaarde:
| Veld | Type | Beschrijving | |
|---|---|---|---|
| host | object | Hostnaam van de itemhost. | |
| host | string | Hostnaam. | |
| name | string | Zichtbare hostnaam. | |
| groups | array | Lijst van hostgroepen van de itemhost; er moet minstens één element in de array zitten. | |
| - | string | Naam hostgroep. | |
| itemid | nummer | Artikel-ID. | |
| name | string | Zichtbare itemnaam. | |
| clock | number | Aantal seconden sinds Epoch tot het moment waarop de waarde werd verzameld (geheel getal). | |
| ns | getal | Aantal nanoseconden dat moet worden toegevoegd aan klok om een exacte tijd voor het verzamelen van de waarde te krijgen. |
|
| tijdstempel (Alleen Log) |
nummer | 0 indien niet beschikbaar. | |
| source (Alleen Log) |
string | Lege string indien niet beschikbaar. | |
| ernst (Alleen Log) |
nummer | 0 indien niet beschikbaar. | |
| eventid (Alleen Log) |
nummer | 0 indien niet beschikbaar. | |
| value | nummer (voor numerieke items) of string (voor tekstitems) |
Verzamelde itemwaarde. | |
| type | nummer | Type verzamelde waarde: 0 - numeriek zwevend, 1 - teken, 2 - log, 3 - numeriek zonder teken, 4 - tekst |
|
Voorbeelden
Numerieke (niet-ondertekende) waarde:
{"host":{"host":"Host B","name":"Host B zichtbaar"},"groups":["Groep X","Groep Y","Groep Z"],"itemid" :3,"name":"Beschikbaarheid agent","clock":1519304285,"ns":123456789,"value":1,"type":3}Numerieke (zwevende) waarde:
{"host":{"host":"Host B","name":"Host B zichtbaar"},"groups":["Groep X","Groep Y","Groep Z"],"itemid" :4,"name":"CPU-belasting","klok":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"],"itemid" :2,"name":"Agent versie","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"],"itemid" :1,"name":"Berichten in logbestand","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0 ,"value":"logbestand bericht","type":2}Trends
De volgende informatie wordt geëxporteerd voor een berekende trendwaarde:
| Veld | Type | Beschrijving | |
|---|---|---|---|
| host | object | Hostnaam van de itemhost. | |
| host | string | Hostnaam. | |
| name | string | Zichtbare hostnaam. | |
| groups | array | Lijst van hostgroepen van de itemhost; er moet minstens één element in de array zitten. | |
| - | string | Naam hostgroep. | |
| itemid | nummer | Artikel-ID. | |
| name | string | Zichtbare itemnaam. | |
| clock | number | Aantal seconden sinds Epoch tot het moment waarop de waarde werd verzameld (geheel getal). | |
| count | number | Aantal waarden verzameld voor een bepaald uur. | |
| min | getal | Minimale itemwaarde voor een bepaald uur. | |
| avg | number | Gemiddelde itemwaarde voor een bepaald uur. | |
| max | number | Maximale itemwaarde voor een bepaald uur. | |
| type | nummer | Waardetype: 0 - numeriek zwevend, 3 - numeriek zonder teken |
|
Voorbeelden
Numerieke (niet-ondertekende) waarde:
{"host":{"host":"Host B","name":"Host B zichtbaar"},"groups":["Groep X","Groep Y","Groep Z"],"itemid" :3,"name":"Beschikbaarheid agent","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}Numerieke (zwevende) waarde: