Documentation
Table of Contents
7 Protocole d'exportation en temps réel
Cette section présente les détails du protocole d'exportation en temps réel dans un format JSON délimité par une nouvelle ligne pour les :
Tous les fichiers ont une extension .ndjson. Chaque ligne du fichier d'exportation est un objet JSON.
Événements de déclencheur
Les informations suivantes sont exportées pour un événement de problème :
| Champ | Type | Description | ||
|---|---|---|---|---|
| clock | nombre | Nombre de secondes depuis Epoch jusqu'au moment où le problème a été détecté (partie entière). | ||
| ns | nombre | Nombre de nanosecondes à ajouter à clock pour obtenir une heure précise de détection du problème. |
||
| valeur | nombre | 1 (toujours). | ||
| eventid | nombre | ID d'événement de problème. | ||
| name | chaîne | Nom de l'événement de problème. | ||
| severity | nombre | Gravité de l'événement de problème (0 - Non classifié, 1 - Information, 2 - Avertissement, 3 - Moyen, 4 - Haut, 5 - Désastre). | ||
| hosts | tableau | Liste des hôtes impliqués dans l'expression du déclencheur ; il doit y avoir au moins un élément dans le tableau. | ||
| - | objet | |||
| host | chaîne | Nom d'hôte. | ||
| name | chaîne | Nom d'hôte visible. | ||
| groups | tableau | Liste des groupes d'hôtes de tous les hôtes impliqués dans l'expression du déclencheur ; il doit y avoir au moins un élément dans le tableau. | ||
| - | chaîne | Nom du groupe d'hôtes. | ||
| tags | tableau | Liste des tags problématiques (peut être vide). | ||
| - | objet | |||
| tag | chaîne | Nom du tag. | ||
| value | chaîne | Valeur du tag (peut être vide). | ||
Les informations suivantes sont exportées pour un événement de récupération :
| Champ | Type | Description |
|---|---|---|
| clock | nombre | Nombre de secondes depuis Epoch jusqu'au moment où le problème a été résolu (partie entière). |
| ns | nombre | Nombre de nanosecondes à ajouter à clock pour obtenir un temps de résolution précis du problème. |
| value | nombre | 0 (toujours). |
| eventid | nombre | ID d'événement de récupération. |
| p_eventid | nombre | ID d'événement de problème. |
Exemples
Problème :
{"clock":1519304285,"ns":123456789,"value":1,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}Récupération :
Problème (génération multiple d'événements problème) :
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}Récupération :
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43}
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42}Valeurs d'élément
The following information is exported for a collected item value:
| Champ | Type | Description | |
|---|---|---|---|
| host | object | Nom d'hôte de l'hôte de l'élément. | |
| host | string | Nom d'hôte. | |
| name | string | Nom d'hôte visible. | |
| groups | array | Liste des groupes d'hôtes de l'hote de l'élément ; il doit y avoir au moins un élément dans le tableau. | |
| - | string | Nom du groupe d'hôtes. | |
| itemid | number | ID de l'article. | |
| name | string | Nom de l'élément visible. | |
| clock | number | Nombre de secondes depuis Epoch jusqu'au moment où la valeur a été collectée (partie entière). | |
| ns | number | Nombre de nanosecondes à ajouter à clock pour obtenir une heure de collecte de valeur précise. |
|
| timestamp (Journal uniquement) |
number | 0 si non disponible. | |
| source (Journal uniquement) |
string | Chaîne vide si non disponible. | |
| severity (Journal uniquement) |
number | 0 si non disponible. | |
| eventid (Journal uniquement) |
number | 0 si non disponible. | |
| value | number (pour les éléments numériques) ou string (pour les éléments de texte) |
Valeur de l'élément collecté. | |
| type | number | Type de valeur collectée : 0 - nombre flottant, 1 - caractère, 2 - journal, 3 - numérique non signé, 4 - texte |
|
Exemples
Valeur numérique (non signée) :
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3}Valeur numérique (float) :
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0}Valeur textuelle ou caractère :
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4}Valeur de log :
{"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2}Tendances
Les informations suivantes sont exportées pour une valeur de tendance calculée :
| Champ | Type | Description | |
|---|---|---|---|
| host | object | Nom d'hôte de l'hôte de l'élément. | |
| host | string | Nom d'hôte. | |
| name | string | Nom visible d'hôte. | |
| groups | array | Liste des groupes d'hôtes de l'hôte de l'élément ; il doit y avoir au moins un élément dans le tableau. | |
| - | string | Nom du groupe d'hôtes. | |
| itemid | number | ID de l'élément. | |
| name | string | Nom visible de l'élément. | |
| clock | number | Nombre de secondes depuis Epoch jusqu'au moment où la valeur a été collectée (partie entière). | |
| count | number | Nombre de valeurs collectées pour une heure donnée. | |
| min | number | Valeur minimale de l'élément pour une heure donnée. | |
| avg | number | Valeur moyenne de l'élément pour une heure donnée. | |
| max | number | Valeur maximale de l'élément pour une heure donnée. | |
| type | number | Type de valeur : 0 - nombre flottant numérique, 3 - numérique non signé |
|
Exemples
Valeur numérique (non signée) :
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}Valeur numérique (float) :