2 Agent

Vue d'ensemble

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

L'agent collecte localement les informations opérationnelles et transmet les données au serveur Zabbix pour un traitement ultérieur. En cas de défaillances (par exemple, un disque dur plein ou un processus de service en panne), 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 d'informations statistiques.

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

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 demande 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 demande 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).

Plateformes prises en charge

Pour connaître les plateformes 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é sur 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 Zabbix agent:

Parameter 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 autre que celui par défaut.
-f --foreground Exécuter Zabbix agent au premier plan (par défaut: true).
-p --print Afficher les éléments connus et 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é et 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 et quitter.
-h --help Afficher les informations d'aide.
-V --version Afficher le numéro de version.
agent UNIX uniquement
-R --runtime-control <option> Exécuter des fonctions d'administration. Voir runtime control.
agent Windows uniquement
-m --multiple-agents Utiliser plusieurs instances d'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 Zabbix agent Windows. Valeurs autorisées:
automatic - (par défaut) démarrer le service automatiquement 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 sur 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 Zabbix agent Windows en tant que service.
-d --uninstall Désinstaller le service Zabbix agent Windows.
-s --start Démarrer le service Zabbix agent Windows.
-x --stop Arrêter le service Zabbix agent Windows.

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

  • Affichage de tous les éléments intégrés de l'agent avec leurs valeurs.
  • Test d'un paramètre utilisateur avec la clé mysql.ping définie dans le fichier de configuration spécifié.
  • Installation d'un service Zabbix Agent pour Windows en utilisant le chemin par défaut vers le fichier de configuration C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf.
  • Installation d'un service Zabbix Agent [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 en rendant le nom du service unique en l'étendant avec la valeur Hostname du fichier de configuration.
  • Modification du type de démarrage d'un service Zabbix Agent pour Windows déjà installé en utilisant le fichier de configuration zabbix_agentd.conf 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

Avec les options de contrôle à l'exécution, vous pouvez modifier le niveau de journalisation des processus de l'agent.

Option Description Target
log_level_increase[=<target>] Augmenter 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 de processus et numéro (par exemple, listener,3)
pid - identifiant du processus (1 à 65535). Pour des valeurs plus grandes, spécifiez la cible sous la forme 'type de processus,N'.
log_level_decrease[=<target>] Diminuer le niveau de journalisation.
Si la cible n'est pas spécifiée, tous les processus sont concernés.
userparameter_reload Recharger 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 avec le PID 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 pour effectuer 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 autorisations 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 autorisations sont refusées.

Utilisateur du processus

L'agent Zabbix sur UNIX est conçu pour s'exécuter en tant qu'utilisateur non root. Il s'exécutera avec l'utilisateur non root avec lequel il a été démarré. Vous pouvez donc exécuter l'agent avec n'importe quel utilisateur non root sans aucun 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 est :

  • Sous UNIX, la valeur par défaut est /usr/local/etc/zabbix_agentd.conf ou celle définie par les variables de compilation --sysconfdir ou --prefix.
  • Sous Windows, la valeur par défaut est C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf.

Si une seule instance de l'agent s'exécute 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 de plusieurs instances, chaque instance d'agent doit avoir son propre fichier de configuration (l'une des instances peut utiliser le fichier de configuration par défaut).

Pour plus de détails sur la configuration de Zabbix agent, consultez les options du fichier de configuration pour Zabbix agent Unix ou Zabbix agent 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 modernes de type Unix utilisent UTF-8 par défaut pour les paramètres régionaux ; toutefois, sur certains systèmes, il peut être nécessaire de le définir explicitement.

Code de sortie

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