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:
Heartbeat message
The heartbeat message is sent by an active agent to Zabbix server/proxy every HeartbeatFrequency seconds (configured in the Zabbix agent 2 configuration file).
It is used to monitor the availability of active checks.
| Field | Type | Mandatory | Value |
|---|---|---|---|
| request | string | yes | active check heartbeat |
| host | string | yes | The host name. |
| heartbeat_freq | number | yes | The agent heartbeat frequency (HeartbeatFrequency configuration parameter). |