Documentation
Table of Contents
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 :
- Les événements déclencheurs
- Les valeurs d'éléments
- Les tendances
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 :
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) :