Sidebar

fr:manual:appendix:protocols:real_time_export

5 Protocole d'export en temps réel

Cette section présente les détails du protocole d’export en temps réel dans un format JSON délimité par une nouvelle ligne pour :

Tous les fichiers ont une extension .ndjson. Chaque ligne du fichier d'export est un objet JSON.

Événements déclencheurs

Les informations suivantes sont exportées pour un événement problème :

Champs Type Description
host tableau Liste des hôtes impliqués dans l'expression du déclencheur ; il devrait y avoir au moins un élément dans le tableau.
- chaîne Nom visible de l'hôte.
groups tableau Liste des groupes d'hôtes de tous les hôtes impliqués dans l'expression du déclencheur ; il devrait y avoir au moins un élément dans le tableau.
- chaîne Nom du groupe d'hôtes.
tags tableau Liste des tags de problème (peut être vide).
- objet
tag chaîne Nom du Tag.
valeur chaîne Valeur du Tag (peut être vide).
name chaîne Nom de l'événement Problème.
clock nombre Nombre de secondes écoulées depuis l’époque jusqu’au moment où le problème a été détecté (partie entière).
ns nombre Nombre de nanosecondes à ajouter à clock pour obtenir un temps précis de détection du problème.
eventid nombre ID de l'événement Problème.
value nombre 1 (toujours).

Les informations suivantes sont exportées pour un événement de récupération :

Champs Type Description
clock nombre Nombre de secondes écoulées depuis l’époque jusqu’au moment où le problème a été détecté (partie entière).
ns nombre Nombre de nanosecondes à ajouter à clock pour obtenir un temps précis de détection du problème.
eventid nombre ID de l'événement de récupération.
p_eventid nombre ID de l'événement Problème.
value nombre 0 (toujours).
Exemples

Problème :

{"hosts":["Host B","Zabbix Server"],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}],"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","clock":1519304285,"ns":123456789,"eventid":42, "value":1}

Récupération :

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

Problème (Génération d'événements problèmes multiples) :

{"hosts":["Host B","Zabbix Server"],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}],"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","clock":1519304286,"ns":123456789,"eventid":43, "value":1}
{"hosts":["Host B","Zabbix Server"],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}],"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","clock":1519304286,"ns":123456789,"eventid":43, "value":1}

Récupération :

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

Valeurs d'élément

Les informations suivantes sont exportées pour une valeur d’élément collecté :

Champs Type Description
host chaîne Nom d'hôte visible de l'élément de l'hôte.
groups tableau Liste des groupes hôtes de l’élément de l'hôte ; il devrait y avoir au moins un élément dans le tableau.
- chaîne Nom du groupe d'hôtes.
applications tableau Liste des applications d'éléments ; vide s'il n'y en a pas.
- chaîne Nom de l'application.
itemid nombre ID de l'élément.
name chaîne Nom visisble de l'élément.
clock nombre Nombre de secondes écoulées depuis l’époque jusqu’au moment où le problème a été détecté (partie entière).
ns nombre Nombre de nanosecondes à ajouter à clock pour obtenir un temps précis de détection du problème.
timestamp
(Journal seulement)
nombre 0 si non disponible.
source
(Journal seulement)
chaîne Chaîne vide si non disponible.
severity
(Journal seulement)
nombre 0 si non disponible.
eventid
(Journal seulement)
nombre 0 si non disponible.
value nombre (pour les éléments numériques) ou
chaîne (pour les éléments textuels)
Valeur de l'élément collecté.
Exemples

Valeur numérique (non-signée) :

{"host":"Host B","groups":["Group X","Group Y","Group Z"],"applications":["Zabbix Agent","Availability"],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1}

Valeur numérique (flottant) :

{"host":"Host B","groups":["Group X","Group Y","Group Z"],"applications":["CPU","Performance"],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":"0.1"}

Valeur de texte, caractère :

{"host":"Host B","groups":["Group X","Group Y","Group Z"],"applications":["Zabbix Agent","Installed software versions"],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4"}

Valeur de journal :

{"host":"Host A","groups":["Group X","Group Y","Group Z"],"applications":["Log files","Critical"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message"}

Tendances

Les informations suivantes sont exportées pour une valeur de tendance calculée :

Champs Type Description
host chaîne Nom d'hôte visible de l'élément hôte.
groups tableau Liste des groupes hôtes de l’élément hôte ; il devrait y avoir au moins un élément dans le tableau.
- chaîne Nom du groupe d'hôtes.
applications tableau Liste des applications d'éléments ; vide s'il n'y en a pas.
- chaîne Nom de l'application.
itemid nombre ID de l'élément.
name chaîne Nom visible de l'élément.
clock nombre Nombre de secondes écoulées depuis l’époque jusqu’au moment où le problème a été détecté (partie entière).
count nombre Nombre de valeurs collectées pour une heure donnée.
min nombre Valeur minimale de l'élément pour une heure donnée.
avg nombre Valeur moyenne de l'élément pour une heure donnée.
max nombre Valeur maximale de l'élément pour une heure donnée.
Exemples

Valeur numérique (non signée) :

{"host":"Host B","groups":["Group X","Group Y","Group Z"],"applications":["Zabbix Agent","Availability"],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1}

Valeur numérique (flottant) :

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