Sidebar
Table of Contents
#5 Realtime exportprotocol
Deze sectie geeft details van de real-time export protocol in a door nieuwe regels gescheiden JSON-indeling voor:
Alle bestanden hebben de extensie .ndjson. Elke regel van het exportbestand is een JSON-object.
Gebeurtenissen activeren
De volgende informatie wordt geëxporteerd voor een probleemgebeurtenis:
|Veld|<|<|Type|Beschrijving| |-|-|----------|----------|----------------------- -------| |clock|<|<|number|Aantal seconden sinds Epoch tot het moment waarop het probleem werd gedetecteerd (geheel getal).| |ns|<|<|getal|Aantal nanoseconden dat aan clock moet worden toegevoegd om een precieze probleem detectie tijd te krijgen.| |waarde|<|<|getal|1 (altijd).| |eventid|<|<|nummer|Probleemgebeurtenis-ID.| |name|<|<|string|Naam probleemgebeurtenis.| |ernst|<|<|getal|Zwaarte van probleemgebeurtenis (0 - Niet geclassificeerd, 1 - Informatie, 2 - Waarschuwing, 3 - Gemiddeld, 4 - Hoog, 5 - Ramp).| |hosts|<|<|array|Lijst van hosts die betrokken zijn bij de trigger-expressie; er moet minstens één element in de array zitten.| | |-|<|object|<| |^| |host|string|Hostnaam.| |||name|string|Zichtbare hostnaam.| |groups|<|<|array|lijst van hostgroepen van alle hosts die betrokken zijn bij de trigger expressie; er moet minstens één element in de array zitten.| | |-|<|string|Naam hostgroep.| |tags|<|<|array|Lijst met probleemtags (mag leeg zijn).| | |-|<|object|<| |^| |tag|string|Tagnaam.| |||value|string|Tagwaarde (mag leeg zijn).|
De volgende informatie wordt geëxporteerd voor een herstelgebeurtenis:
| Veld | Type | Beschrijving |
|---|---|---|
| clock | number | Aantal seconden sinds Epoch tot het moment waarop het probleem werd opgelost (geheel getal). |
| ns | getal | Aantal nanoseconden dat aan clock moet worden toegevoegd om een exacte probleem oplossingstijd te krijgen. |
| waarde | getal | 0 (altijd). |
| eventid | nummer | Herstelgebeurtenis-ID. |
| p_eventid | nummer | Probleemgebeurtenis-ID. |
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: