[comment]: # translation:outdated

[comment]: # ({0f9ecee9-0f9ecee9})
# 2 Agent

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

[comment]: # ({ef20f8a5-f5143fcc})
#### Aperçu

L'agent Zabbix est déployé sur une cible de surveillance pour superviser
activement les ressources locales et les applications (disques durs,
mémoire, statistiques de processeur, etc.).

L'agent rassemble les informations opérationnelles localement et
transmet les données au serveur Zabbix pour un traitement ultérieur. En
cas d'échec (par exemple, un disque dur plein ou un service en panne),
le serveur Zabbix peut alerter activement les administrateurs de la
machine particulière qui a signalé la panne.

Les agents Zabbix sont extrêmement efficaces en raison de l'utilisation
d'appels système natifs pour collecter des informations statistiques.

[comment]: # ({/ef20f8a5-f5143fcc})

[comment]: # ({41ac6928-41e6af7c})
##### Vérifications passives et actives

Les agents Zabbix peuvent effectuer des vérifications passives et
actives.

Dans une [vérification
passive](/fr/manual/appendix/items/activepassive#verifications_passives),
l'agent répond à une demande de données. Le serveur Zabbix (ou le proxy)
demande des données, par exemple, la charge du processeur, et l'agent
Zabbix renvoie le résultat.

Les [vérifications
actives](/fr/manual/appendix/items/activepassive#verifications_actives)
nécessitent un traitement plus complexe. L'agent doit d'abord récupérer
une liste d'éléments du serveur Zabbix pour un traitement indépendant.
Ensuite, il enverra périodiquement de nouvelles valeurs au serveur.

Que ce soit pour effectuer des vérifications passives ou actives, cela
se configure en sélectionnant un [type
d'élément](/fr/manual/config/items/itemtypes/zabbix_agent). L'agent
Zabbix traite les éléments de type 'Agent Zabbix' ou 'Agent Zabbix
(actif)'.

[comment]: # ({/41ac6928-41e6af7c})

[comment]: # ({da1b038a-b05a4949})
#### Plateformes supportées

L’agent Zabbix est supporté sur :

-   Linux
-   IBM AIX
-   FreeBSD
-   NetBSD
-   OpenBSD
-   HP-UX
-   Mac OS X
-   Solaris : 9, 10, 11
-   Windows : toutes les versions bureautique et serveurs depuis XP

[comment]: # ({/da1b038a-b05a4949})

[comment]: # ({6cda2f23-5bbb67d9})
#### Agent sur les systèmes de type Unix

L’agent Zabbix sur les systèmes de type Unix s'exécute sur l’hôte qui
est surveillé.

[comment]: # ({/6cda2f23-5bbb67d9})

[comment]: # ({a0fae0a9-32937b35})
##### Installation

Voir la section [installation des
packages](/fr/manual/installation/install_from_packages) pour voir les
instructions d’installation de l’agent Zabbix sous forme de package.

Sinon référez-vous aux instructions d’[installation
manuelle](/fr/manual/installation/install#installation_des_demons_zabbix)
si vous ne voulez pas utiliser de packages.

::: noteimportant
En général, les agents Zabbix 32bits fonctionnent
sur les systèmes 64bits, mais cela peut ne pas fonctionner dans certains
cas.
:::

[comment]: # ({/a0fae0a9-32937b35})

[comment]: # ({92a0f999-99f37c64})
##### Si installé comme package

L’agent Zabbix s’exécute comme un processus démon. L’agent peut être
démarré en exécutant :

    shell> service zabbix-agent start

Cela fonctionnera sur la plupart des systems GNU/Linux. Sur les autres
systèmes vous devrez exécuter la commande suivante :

    shell> /etc/init.d/zabbix-agent start

De même, pour arrêter/redémarrer/afficher l'état de l'agent Zabbix,
utilisez les commandes suivantes :

    shell> service zabbix-agent stop
    shell> service zabbix-agent restart
    shell> service zabbix-agent status

[comment]: # ({/92a0f999-99f37c64})

[comment]: # ({c3d27711-5e83177d})
##### Démarrage manuel

Si les commandes précédentes ne fonctionnent pas, il faudra démarrer
l’agent manuellement. Trouvez le chemin des binaires zabbix\_agentd puis
exécutez :

    shell> zabbix_agentd

[comment]: # ({/c3d27711-5e83177d})

[comment]: # ({b2fa8691-f276f35a})
#### Agent sur les systèmes Windows

L'agent Zabbix sur Windows s'exécute en tant que service Windows.

[comment]: # ({/b2fa8691-f276f35a})

[comment]: # ({1c4a0d6a-23b0be18})
##### Préparation

L’agent Zabbix est distribué sous forme d’archive au format zip. Après
le téléchargement de l’archive vous devrez la décompresser. Vous pouvez
choisir n’importe quel dossier pour stocker l’agent Zabbix et le fichier
de configuration. ex :

    C:\zabbix

Copiez les fichiers bin\\zabbix\_agentd.exe et conf\\zabbix\_agentd.conf
vers la destination choisie précédemment.

Editez le fichier c:\\zabbix\\zabbix\_agentd.conf selon vos besoins en
prenant soin de spécifier correctement le paramètre “Hostname”.

[comment]: # ({/1c4a0d6a-23b0be18})

[comment]: # ({b7b9df45-c7c6daac})
##### Installation

Une fois que les étapes précédentes sont réalisées, exécutez la commande
suivante pour installer l’agent Zabbix en tant que service :

    C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i

Maintenant vous devriez être capable de configurer le service “Agent
Zabbix” comme les autres services Windows.

Voir [plus de
details](/fr/manual/appendix/install/windows_agent#installation_de_l_agent_en_tant_que_service_windows)
sur l'installation et l'exécution de l'agent Zabbix sur Windows.

[comment]: # ({/b7b9df45-c7c6daac})

[comment]: # ({46d1de60-fa025a89})
#### Autres options de l'agent

Il est possible d'exécuter plusieurs instances de l'agent sur un hôte.
Une seule instance peut utiliser le fichier de configuration par défaut
ou un fichier de configuration spécifié dans la ligne de commande. Dans
le cas d'instances multiples, chaque instance d'agent doit posséder son
propre fichier de configuration (l'une des instances peut utiliser le
fichier de configuration par défaut).

Les paramètres de ligne de commande suivants peuvent être utilisés avec
l'agent Zabbix :

|**Paramètre**|**Description**|
|--------------|---------------|
|**Agent UNIX et Windows**|<|
|-c --config <config-file>|Chemin vers le fichier de configuration.<br>Vous devez utiliser cette option pour spécifier le fichier de configuration qui n'est pas celui par défaut.<br>Sur UNIX, le fichier par défaut est /usr/local/etc/zabbix\_agentd.conf ou comme appliqué par les variables [compile-time](/fr/manual/installation/install#installation_des_demons_zabbix) *--sysconfdir* ou *--prefix*<br>Sur Windows, le fichier par défaut est c:\\zabbix\_agentd.conf|
|-p --print|Affiche les éléments connus et quitte.<br>*Note*: Pour retourner également les résultats des [paramètres utilisateur](/fr/manual/config/items/userparameters), vous devez spécifier le fichier de configuration (s'il n'est pas à l'emplacement par défaut).|
|-t --test <item key>|Teste l'élément spécifié et quitte.<br>*Note*: Pour retourner également les résultats des [paramètres utilisateur](/fr/manual/config/items/userparameters), vous devez spécifier le fichier de configuration (s'il n'est pas à l'emplacement par défaut).|
|-h --help|Affiche les informations d'aide|
|-V --version|Affiche le numéro de version|
|**Agent UNIX uniquement**|<|
|-R --runtime-control <option>|Effectue des fonctions administratives. Voir [runtime control](/fr/manual/concepts/agent#runtime_control).|
|**Agent Windows uniquement**|<|
|-m --multiple-agents|Utilise plusieurs instances d'agent (avec les fonctions -i,-d,-s,-x).<br>Pour distinguer les noms des services des noms des instances, chaque nom de service inclura la valeur Hostname du fichier de configuration spécifié.|
|**Agent Windows uniquement (fonctions)**|<|
|-i --install|Installe l'agent Windows Zabbix en tant que service|
|-d --uninstall|Désinstalle le service de l'agent Windows Zabbix|
|-s --start|Démarre le service de l'agent Windows Zabbix|
|-x --stop|Arrête le service de l'agent Windows Zabbix|

**Exemples** spécifiques d'utilisation des paramètres de ligne de
commande :

-   affichage de tous les éléments d'agent intégrés avec des valeurs
-   tester un paramètre utilisateur avec la clé "mysql.ping" définie
    dans le fichier de configuration spécifié
-   installation d’un service "Agent Zabbix" pour Windows en utilisant
    le chemin par défaut du fichier de configuration
    c:\\zabbix\_agentd.conf
-   installation d'un service "Agent Zabbix \[Hostname\]" pour Windows
    en utilisant le fichier de configuration zabbix\_agentd.conf situé
    dans le même dossier que l'exécutable de l'agent et rend le nom de
    service unique en l'étendant par la valeur ‘Hostname’ du fichier
    config

```{=html}
<!-- -->
```
    shell> zabbix_agentd --print
    shell> zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
    shell> zabbix_agentd.exe -i
    shell> zabbix_agentd.exe -i -m -c zabbix_agentd.conf

[comment]: # ({/46d1de60-fa025a89})

[comment]: # ({23e5aa1f-088153e8})
##### Runtime control

Avec les options de runtime control, vous pouvez changer le niveau de
journalisation des processus de l’agent.

|Option|Description|Cible|
|------|-----------|-----|
|log\_level\_increase\[=<target>\]|Augmente le niveau de journalisation.<br>Si la cible n'est pas spécifiée, tous les processus sont affectés.|La cible peut être spécifiée de la manière suivante : :<br>**process type** - tous les processus du type spécifié (ex : listener)<br>Voir tous les [types de processus de l'agent](/fr/manual/concepts/agent#types_de_processus_agent).<br>**process type,N** - type de processus et numéro (ex : listener,3)<br>**pid** - identifiant de processus (1 à 65535). Pour les valeurs plus large spécifier la cible comme 'process-type,N'.|
|log\_level\_decrease\[=<target>\]|Diminue le niveau de journalisation.<br>Si la cible n'est pas spécifiée, tous les processus sont affectés.|^|

Notez que la plage utilisable de PID pour modifier le niveau de
journalisation d'un processus d'un seul agent est comprise entre 1 et
65535. Sur les systèmes dotés de PIDs > 65535, la cible <process
type, N> peut être utilisée comme solution de contournement pour
modifier le niveau de journalisation d'un seul processus.

Exemples :

-   augmente le niveau de journalisation de tous les processus
-   augmente le niveau de journalisation du troisième processus listener
-   augmente le niveau de journalisation du processus avec le PID 1234
-   diminue le niveau de journalisation de tous les processus nommés
    "active checks"

```{=html}
<!-- -->
```
    shell> zabbix_agentd -R log_level_increase
    shell> zabbix_agentd -R log_level_increase=listener,3
    shell> zabbix_agentd -R log_level_increase=1234
    shell> zabbix_agentd -R log_level_decrease="active checks"

::: noteclassic
Runtime control n'est pas supporté sur OpenBSD, NetBSD et
Windows.
:::

[comment]: # ({/23e5aa1f-088153e8})

[comment]: # ({7686e1a4-929667fd})
#### Types de processus Agent

-   `​active checks`​ - processus qui effectue les vérifications actives
-   `​collector`​ - processus pour la collecte des données
-   `​listener`​ - processus à l'écoute des vérifications passives

Le fichier journal de l'agent peut être utilisé pour observer ces types
de processus

[comment]: # ({/7686e1a4-929667fd})

[comment]: # ({e5ef47dc-18ab16f1})
#### Processus utilisateur

L'agent Zabbix sous UNIX est conçu pour s'exécuter en tant
qu'utilisateur non root. Il fonctionnera comme n'importe quel
utilisateur non-root. Vous pouvez donc exécuter l'agent comme n'importe
quel utilisateur non root sans aucun problème.

Si vous essayez de l'exécuter en tant que 'root', il passera à un
utilisateur 'zabbix' codé en dur, qui doit être présent sur votre
système. Vous pouvez uniquement exécuter l'agent en tant que 'root' si
vous modifiez le paramètre 'AllowRoot' dans le fichier de configuration
de l'agent associé.

[comment]: # ({/e5ef47dc-18ab16f1})

[comment]: # ({211d26e1-fc6b2c61})
#### Fichier de configuration

Pour plus de détails sur la configuration de l'agent Zabbix, voir les
options du fichier de configuration pour
[zabbix\_agentd](/fr/manual/appendix/config/zabbix_agentd) ou l'[agent
Windows](/fr/manual/appendix/config/zabbix_agentd_win).

[comment]: # ({/211d26e1-fc6b2c61})

[comment]: # ({8870feac-7c3bd34c})
#### Environnement local

Notez que l'agent requiert un environnement local UTF-8 afin que
certains éléments textuels d'agent puissent renvoyer le contenu attendu.
La plupart des systèmes modernes de type Unix ont un paramètre régional
UTF-8 par défaut, cependant, certains systèmes peuvent avoir besoin
d'être définis spécifiquement.

[comment]: # ({/8870feac-7c3bd34c})

[comment]: # ({03af54af-5581c546})
#### Code de sortie

Avant la version 2.2, l'agent Zabbix renvoyait 0 en cas de sortie
réussie et 255 en cas d'échec. A partir de la version 2.2 et supérieure,
l'agent Zabbix renvoie 0 en cas de réussite et 1 en cas d'échec.

[comment]: # ({/03af54af-5581c546})