[comment]: # translation:outdated

[comment]: # ({0e4c7681-0ea9fa0f})
# 3 Protocole de l'agent Zabbix 2

[comment]: # ({/0e4c7681-0ea9fa0f})

[comment]: # ({34adf2a8-e87a981b})

### 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

[comment]: # ({/34adf2a8-e87a981b})

[comment]: # ({420faeae-1c996373})

### 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:
```json
{
 · "request": "active checks",
 · "host": "Zabbix server",
 · "version": "6.0",
 · "host_metadata": "mysql,nginx",
 · "hostinterface": "zabbix.server.lan"
 · "ip": "159.168.1.1",
 · "port": 12050
}
```

[comment]: # ({/420faeae-1c996373})

[comment]: # ({e7de848d-44da8f0a})

### 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:
```json
{
 · "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
 · }
 · ]
}
```

[comment]: # ({/e7de848d-44da8f0a})

[comment]: # ({6e86f730-8a564dbc})

### 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:
```json
{
 · "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"
}
```

[comment]: # ({/6e86f730-8a564dbc})

[comment]: # ({a61e102f-b302d014})

### 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:
```json
{
 · "response": "success",
 · "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
}
```

[comment]: # ({/a61e102f-b302d014})