[comment]: # ({13b658a4-cb9df6d6})
# 7 Protocol voor realtime export

Deze sectie presenteert details van het [real-time export](/manual/appendix/install/real_time_export) protocol in een JSON-formaat met nieuwe regels voor:

-   [trigger gebeurtenissen](#trigger_events)
-   [item waardes](#item_values)
-   [trends](#trends)

Alle bestanden hebben een .ndjson-extensie. Elke regel van het exportbestand is een JSON-object.

[comment]: # ({/13b658a4-cb9df6d6})

[comment]: # ({c21bdb3b-bc637674})
#### 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.|

[comment]: # ({/c21bdb3b-bc637674})

[comment]: # ({9eccc413-9eccc413})
##### 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:

    {"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42}

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}

[comment]: # ({/9eccc413-9eccc413})

[comment]: # ({7fb23e32-9faee484})
#### 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*<br>(*Alleen Log*)|<|nummer|0 indien niet beschikbaar.|
|*source*<br>(*Alleen Log*)|<|string|Lege string indien niet beschikbaar.|
|*ernst*<br>(*Alleen Log*)|<|nummer|0 indien niet beschikbaar.|
|*eventid*<br>(*Alleen Log*)|<|nummer|0 indien niet beschikbaar.|
|*value*|<|nummer (voor numerieke items) of<br>string (voor tekstitems)|Verzamelde itemwaarde.|
|*type*|<|nummer|Type verzamelde waarde:<br>0 - numeriek zwevend, 1 - teken, 2 - log, 3 - numeriek zonder teken, 4 - tekst|

[comment]: # ({/7fb23e32-9faee484})

[comment]: # ({683a131b-683a131b})
##### 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}

[comment]: # ({/683a131b-683a131b})

[comment]: # ({2327a6f1-f534dda9})
#### 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:<br>0 - numeriek zwevend, 3 - numeriek zonder teken|

[comment]: # ({/2327a6f1-f534dda9})

[comment]: # ({8606813d-8606813d})
##### 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:

    {"host":{"host":"Host B","name":"Host B zichtbaar"},"groups":["Groep X","Groep Y","Groep Z"],"itemid" :4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0}

[comment]: # ({/8606813d-8606813d})
