Documentation
Table of Contents
3 Protocole de l'agent Zabbix 2
Aperçu
Cette rubrique fournit des informations sur :
Agent2 -> Serveur : demande de vérifications actives
Serveur -> Agent2 : réponse de vérifications actives
Agent2 -> Serveur : demande de données agent
Serveur -> Agent2 : réponse des données agent
Demande de vérifications actives
La demande de vérifications actives est utilisée pour obtenir les vérifications actives à traiter par l'agent. Cette requête est envoyée par l'agent au démarrage, puis avec des intervalles RefreshActiveChecks.
| Champ | Type | Obligatoire | Valeur |
|---|---|---|---|
| request | string | oui | vérifications actives |
| host | string | oui | Nom d'hôte. |
| version | string | oui | La version de l'agent : <majeur>.<mineur>. |
| host_metadata | string | non | Le paramètre de configuration HostMetadata ou la valeur de métrique HostMetadataItem. |
| interface | string | non | La valeur métrique du paramètre de configuration HostInterface ou HostInterfaceItem. |
| IP | string | non | La première IP du paramètre de configuration ListenIP s'il est défini. |
| port | number | non | La valeur du paramètre de configuration ListenPort s'il est défini et non le port d'écoute par défaut de l'agent. |
Exemple:
{ · "request": "active checks", · "host": "Zabbix server", · "version": "6.0", · "host_metadata": "mysql,nginx", · "hostinterface": "zabbix.server.lan" · "ip": "159.168.1.1", · "port": 12050 }Réponse de vérifications actives
La réponse de vérifications actives est renvoyée par le serveur à l'agent après le traitement de la demande de vérifications actives.
| Champ | Type | Obligatoire | Valeur | |
|---|---|---|---|---|
| response | string | oui | success | failed | |
| info | string | non | Informations d'erreur en cas d'échec. | |
| data | array of objects | non | Éléments de vérifications actives. | |
| key | string | non | Clé d'élément avec macros développées. | |
| itemid | number | non | Identificateur d'élément. | |
| delay | string | non | Intervalle de mise à jour de l'élément. | |
| lastlogsize | number | non | Dernière taille du journal de l'élément. | |
| mtime | number | non | Heure de l'élément. | |
| regexp | tableau d'objets | non | Expressions régulières globales. | |
| name | string | non | Nom de l'expression régulière globale. | |
| expression | string | non | Expression régulière globale. | |
| expression_type | number | non | Type d'expression régulière globale. | |
| exp_delimiter | string | non | Délimiteur global d'expression régulière. | |
| case_sensitive | number | non | Paramètre global de sensibilité à la casse des expressions régulières. | |
Exemple:
{ · "response": "success", · "data": [ · { · "key": "log[/home/zabbix/logs/zabbix_agentd.log]", · "itemid": 1234, · "delay": "30s", · "lastlogsize": 0, · "mtime": 0 · }, · { · "key": "agent.version", · "itemid": 5678, · "delay": "10m", · "lastlogsize": 0, · "mtime": 0 · } · ] }Demande de données agent
La demande de données agent contient les valeurs d'élément collectées.
| Champ | Type | Obligatoire | Valeur | |
|---|---|---|---|---|
| request | string | oui | agent data | |
| host | string | oui | Nom d'hôte. | |
| version | string | oui | La version de l'agent : <majeur>.<mineur>. | |
| session | string | oui | Identifiant de session unique généré à chaque démarrage de l'agent. | |
| data | array of objects | oui | Valeurs des éléments. | |
| id | number | oui | L'identifiant de la valeur (compteur incrémental utilisé pour vérifier les valeurs dupliquées en cas de problèmes de réseau). | |
| itemid | number | oui | Identificateur d'élément. | |
| calue | string | non | La valeur de l'élément. | |
| lastlogsize | number | non | Dernière taille du journal de l'élément. | |
| mtime | number | non | Heure de l'élément. | |
| state | number | non | L'état de l'élément. | |
| source | string | non | Source du journal des événements de valeur. | |
| eventid | number | non | La valeur eventid du journal des événements. | |
| severity | number | non | La sévérité du journal des événements de la valeur. | |
| timestamp | number | non | Horodatage du journal des événements de la valeur. | |
| clock | number | oui | L'horodatage de la valeur (secondes depuis Epoch). | |
| ns | number | oui | La valeur d'horodatage en nanosecondes. | |
Exemple:
{ · "request": "agent data", · "data": [ · { · "id": 1, · "itemid": 5678, · "value": "2.4.0", · "clock": 1400675595, · "ns": 76808644 · }, · { · "id": 2, · "itemid": 1234, · "lastlogsize": 112, · "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).", · "clock": 1400675595, · "ns": 77053975 · } · ], · "host": "Zabbix server", · "version": "6.0", · "sessionid": "1234456akdsjhfoui" }### Réponse des données agent
La réponse de données agent est renvoyée par le serveur à l'agent après le traitement de la demande de données agent.
| Champ | Type | Obligatoire | Valeur |
|---|---|---|---|
| response | string | oui | success | failed |
| info | string | oui | Résultats du traitement des éléments. |
Exemple: