agent

Aperçu

Zabbix agent est déployé sur une cible de supervision afin de surveiller activement les ressources et applications locales (disques durs, mémoire, statistiques du processeur, etc.).

L'agent collecte localement des informations opérationnelles et transmet les données au serveur Zabbix pour traitement ultérieur. En cas de défaillance (par exemple, un disque dur plein ou un processus de service arrêté), le serveur Zabbix peut alerter activement les administrateurs de la machine concernée qui a signalé la défaillance.

Les agents Zabbix sont très efficaces grâce à l'utilisation d'appels système natifs pour la collecte des informations statistiques.

Il est possible d'exécuter plusieurs instances de l'agent sur un hôte.

Voir aussi :

Vérifications passives et actives

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

  • Vérifications passives - l'agent Zabbix répond à une requête du serveur Zabbix (ou du proxy). Par exemple, le serveur demande des données (par exemple, la charge CPU), et l'agent renvoie le résultat.
  • Vérifications actives - l'agent Zabbix collecte et envoie des données sans attendre de requête du serveur Zabbix (ou du proxy). Tout d'abord, il récupère une liste d'éléments de surveillance depuis le serveur (charge CPU, mémoire disponible, etc.), puis collecte les données requises et envoie périodiquement de nouvelles valeurs en retour.

Le type de vérification de l'agent est configuré en sélectionnant le type d'élément de surveillance correspondant. L'agent Zabbix traite les éléments de type Zabbix agent ou Zabbix agent (active).

Plates-formes prises en charge

Pour les plates-formes prises en charge, consultez la page Requirements.

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 surveillé.

Installation

L'agent Zabbix peut être installé sur des systèmes basés sur Linux à l'aide de l'une des méthodes suivantes :

  • Paquets Zabbix - sélectionnez le composant Agent (après avoir sélectionné votre version de Zabbix, la distribution de votre système d'exploitation et la version du système d'exploitation), puis suivez les instructions fournies.
  • Sources Zabbix - téléchargez les fichiers source et compilez l'agent Zabbix en configurant les sources avec l'option --enable-agent.

En général, les agents Zabbix 32 bits fonctionneront sur des systèmes 64 bits, mais peuvent échouer dans certains cas.

Des binaires précompilés de l'agent Zabbix sont disponibles en téléchargement pour macOS, IBM AIX, FreeBSD, OpenBSD et Solaris. Des binaires hérités, compatibles avec la version actuelle de Zabbix server/proxy, sont disponibles pour NetBSD et HP-UX.

Si installé en tant que paquet

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

systemctl start zabbix-agent

Cela fonctionnera sur la plupart des systèmes GNU/Linux. Sur d’autres systèmes, vous devrez peut-être exécuter :

/etc/init.d/zabbix-agent start

Pour arrêter, redémarrer ou vérifier l’état de Zabbix agent, utilisez les commandes suivantes :

systemctl stop zabbix-agent
systemctl restart zabbix-agent
systemctl status zabbix-agent
Démarrage manuel

Vous pouvez démarrer l'agent Zabbix en localisant le binaire zabbix_agentd et en l'exécutant directement ; par exemple :

zabbix_agentd

Agent sur les systèmes Windows

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

Installation

Zabbix agent peut être installé sous Windows à l'aide de l'une des méthodes suivantes :

Consultez la page Zabbix agent sur Microsoft Windows pour plus de détails sur l'installation de Zabbix agent (à partir d'une archive ZIP) en tant que service Windows.

Options

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.
Vous pouvez utiliser cette option pour spécifier un fichier de configuration différent de celui utilisé par défaut.
-f --foreground Exécuter l'agent Zabbix au premier plan (valeur par défaut : true).
-p --print Afficher les éléments connus, puis quitter.
Notez que pour renvoyer également les résultats des paramètres utilisateur, vous devez spécifier le fichier de configuration (s'il ne se trouve pas à l'emplacement par défaut).
-t --test <item key> Tester l'élément spécifié, puis quitter.
Notez que pour renvoyer également les résultats des paramètres utilisateur, vous devez spécifier le fichier de configuration (s'il ne se trouve pas à l'emplacement par défaut).
-T --test-config Valider le fichier de configuration, puis quitter.
-h --help Afficher les informations d'aide.
-V --version Afficher le numéro de version.
Agent UNIX uniquement
-R --runtime-control <option> Effectuer des fonctions administratives. Voir contrôle à l'exécution.
Agent Windows uniquement
-m --multiple-agents Utiliser plusieurs instances de l'agent (avec les options -i, -d, -s, -x).
Pour distinguer les noms de service des instances, chaque nom de service inclura la valeur Hostname du fichier de configuration spécifié.
-S --startup-type <value> Définir le type de démarrage du service de l'agent Zabbix pour Windows. Valeurs autorisées :
automatic - (par défaut) démarrer automatiquement le service au démarrage de Windows ;
delayed - retarder le démarrage du service jusqu'à ce que les services démarrés automatiquement aient terminé leur démarrage (disponible sous Windows Server 2008/Vista et versions ultérieures) ;
manual - démarrer le service manuellement (par un utilisateur ou une application) ;
disabled - désactiver le service afin qu'il ne puisse pas être démarré par un utilisateur ou une application.
Vous pouvez utiliser cette option avec l'option -i, ou séparément pour modifier le type de démarrage d'un service déjà installé.
-i --install Installer l'agent Zabbix pour Windows en tant que service.
-d --uninstall Désinstaller le service de l'agent Zabbix pour Windows.
-s --start Démarrer le service de l'agent Zabbix pour Windows.
-x --stop Arrêter le service de l'agent Zabbix pour Windows.

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

  • Afficher tous les éléments intégrés de l'agent avec leurs valeurs.
  • Tester un paramètre utilisateur avec la clé mysql.ping définie dans le fichier de configuration spécifié.
  • Installer un service Agent Zabbix pour Windows en utilisant le chemin par défaut vers le fichier de configuration.
  • Installer un service Agent Zabbix [Hostname] pour Windows en utilisant le fichier de configuration situé dans le même dossier que l'exécutable de l'agent et rendre le nom du service unique en l'étendant avec la valeur Hostname du fichier de configuration.
  • Modifier le type de démarrage d'un service Agent Zabbix installé pour Windows en utilisant le fichier de configuration situé dans le même dossier que l'exécutable de l'agent.
zabbix_agentd --print
zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agentd.exe -i
zabbix_agentd.exe -i -m -c zabbix_agentd.conf
zabbix_agentd.exe -c zabbix_agentd.conf -S delayed
Contrôle à l'exécution

Les options de contrôle à l'exécution permettent de modifier le niveau de journalisation des processus de l'agent.

Option Description Cible
log_level_increase[=<target>] Augmente le niveau de journalisation.
Si la cible n'est pas spécifiée, tous les processus sont concernés.		 La cible peut être spécifiée comme suit :
type de processus - tous les processus du type spécifié (par exemple, listener)
Voir tous les types de processus de l'agent.
type de processus,N - type et numéro du processus (par exemple, listener,3)
pid - identifiant du processus (1 à 65535). Pour les valeurs supérieures, spécifiez la cible sous la forme « type de processus,N ».
log_level_decrease[=<target>] Diminue le niveau de journalisation.
Si la cible n'est pas spécifiée, tous les processus sont concernés.
userparameter_reload Recharge les valeurs des options UserParameter et Include à partir du fichier de configuration actuel.

Exemples :

  • Augmentation du niveau de journalisation de tous les processus
  • Augmentation du niveau de journalisation du troisième processus listener
  • Augmentation du niveau de journalisation du processus dont le PID est 1234
  • Diminution du niveau de journalisation de tous les processus de vérification active
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
zabbix_agentd -R log_level_decrease="active checks"

Le contrôle à l'exécution n'est pas pris en charge sur OpenBSD, NetBSD et Windows.

Types de processus de l'agent

Les types de processus de l'agent sont les suivants :

  • active checks - processus d'exécution des vérifications actives ;
  • collector - processus de collecte des données ;
  • listener - processus d'écoute des vérifications passives.

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

Le fichier journal de l'agent est créé avec des permissions de lecture et d'écriture pour le propriétaire du fichier uniquement. De plus, le fichier est lisible par le groupe du propriétaire. Toutes les autres permissions sont refusées.

Traiter l'utilisateur

L'agent Zabbix sur UNIX est conçu pour s'exécuter en tant qu'utilisateur non root. Il s'exécutera avec les privilèges de l'utilisateur non root qui l'a démarré. Vous pouvez donc exécuter l'agent avec n'importe quel utilisateur non root sans problème.

Si vous essayez de l'exécuter en tant que « root », il basculera vers un utilisateur « zabbix » codé en dur, qui doit être présent sur votre système. Vous ne pouvez exécuter l'agent en tant que « root » que si vous modifiez en conséquence le paramètre AllowRoot dans le fichier de configuration de l'agent.

Fichier de configuration

Le chemin par défaut du fichier de configuration dépend du système d’exploitation et de la méthode d’installation de Zabbix :

  • Sous UNIX, le chemin par défaut est :
    • Pour une installation à partir des sources : /usr/local/etc/zabbix_agentd.conf, ou celui défini par les variables au moment de la compilation --sysconfdir ou --prefix.
    • Pour une installation à partir de paquets ou de l’appliance : /etc/zabbix/zabbix_agentd.conf.
  • Sous Windows, le chemin par défaut est C:\Program Files\Zabbix Agent\zabbix_agentd.conf.

Si une seule instance de l’agent est exécutée sur un hôte, elle peut utiliser le fichier de configuration par défaut ou un fichier de configuration spécifié sur la ligne de commande. En cas d’instances multiples, chaque instance de l’agent doit disposer de son propre fichier de configuration (l’une des instances peut utiliser le fichier de configuration par défaut).

Pour plus d’informations sur la configuration de l’agent Zabbix, consultez les options du fichier de configuration de l’agent Zabbix pour Unix ou de l’agent Zabbix pour Windows.

Paramètres régionaux

Notez que l'agent nécessite des paramètres régionaux UTF-8 afin que certains éléments textuels de l'agent puissent renvoyer le contenu attendu. La plupart des systèmes Unix modernes ont des paramètres régionaux UTF-8 par défaut, cependant, sur certains systèmes, il peut être nécessaire de les définir explicitement.

Code de sortie

L'agent Zabbix renvoie 0 en cas de sortie réussie et 1 en cas d'échec.