Agent 2

Vue d'ensemble

Zabbix agent 2 est une nouvelle génération de agent Zabbix, écrit en Go (avec du code C réutilisé de Zabbix agent). Il est conçu pour :

  • Réduire le nombre de connexions TCP ;
  • Fournir une meilleure concurrence des vérifications ;
  • Être facilement extensible grâce à des plugins qui fournissent des vérifications simples avec un code minimal et prennent en charge des vérifications complexes composées de scripts de longue durée et de collecte autonome de données avec rapport périodique ;
  • Fonctionner comme un remplacement de Zabbix agent, en prenant en charge toutes les fonctionnalités précédentes.

Toutes les métriques dans Zabbix agent 2 sont collectées par des plugins.

Ces fonctionnalités sont spécifiques aux plugins :

  • Intervalles planifiés et flexibles pour les vérifications passives et actives
  • Gestion de la file des tâches en fonction de la planification et de la concurrence des tâches
  • Délais d'attente au niveau du plugin
  • Vérification de compatibilité de Zabbix agent 2 et de ses plugins au démarrage

Il existe deux types de plugins :

Vous pouvez également créer vos propres plugins.

Les plugins créés sur mesure n'ont pas besoin d'être intégrés à agent 2. Vous pouvez les ajouter en tant que plugins chargeables, ce qui simplifie ainsi la création de plugins pour de nouvelles métriques.

Les plugins chargeables peuvent être ajoutés à l'exécution sans recompiler Zabbix agent 2.

Voir aussi :

Vérifications passives et actives

Zabbix agent 2 prend en charge les vérifications passives et actives, tout comme Zabbix agent. De plus, les vérifications actives de Zabbix agent 2 prennent en charge les intervalles flexibles/planifiés et la concurrence des vérifications au sein d'un même serveur actif.

Par défaut, après un redémarrage, Zabbix agent 2 planifie la première collecte de données pour les vérifications actives à un moment conditionnellement aléatoire situé dans l'intervalle de mise à jour de l'élément, afin d'éviter les pics d'utilisation des ressources. Pour effectuer immédiatement après le redémarrage de l'agent les vérifications actives qui ne disposent pas d'un intervalle de mise à jour Scheduling, définissez le paramètre ForceActiveChecksOnStart (au niveau global) ou le paramètre du plugin Plugins.<Plugin name>.System.ForceActiveChecksOnStart (qui ne s'applique qu'aux vérifications d'un plugin spécifique) dans le fichier de configuration. Si le paramètre au niveau du plugin est défini, il remplace le paramètre global.

Concurrence des vérifications

Les vérifications provenant de différents plugins peuvent être exécutées simultanément. Le nombre de vérifications simultanées au sein d'un même plugin est limité par le paramètre de capacité du plugin. Chaque plugin peut avoir un paramètre de capacité codé en dur (1000 étant la valeur par défaut) qui peut être réduit à l'aide du paramètre Plugins.<PluginName>.System.Capacity=N dans la configuration Plugins parameter.

Plates-formes prises en charge

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

Agent 2 sur les systèmes de type Unix

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

Installation

Zabbix agent 2 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 2 (après avoir sélectionné votre version de Zabbix, la distribution de l'OS et la version de l'OS) et suivez les instructions ;
  • Sources Zabbix - téléchargez les fichiers source et compilez l'agent en configurant avec l'option --enable-agent2.

Les capacités de surveillance de Zabbix agent 2 peuvent être étendues avec des plugins chargeables, disponibles séparément. Pour plus de détails, voir Plugins chargeables.

Si installé en tant que paquet

Zabbix agent 2 s'exécute en tant que processus au premier plan et s'appuie sur un gestionnaire de services externe (par exemple, systemd) pour l'exécution en arrière-plan. Zabbix agent 2 ne dispose pas d'une prise en charge intégrée de la mise en arrière-plan en tant que démon sous Linux.

L'agent peut être démarré en exécutant :

systemctl start zabbix-agent2

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

systemctl stop zabbix-agent2
systemctl restart zabbix-agent2
systemctl status zabbix-agent2
Démarrer manuellement

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

zabbix_agent2

Agent 2 sur les systèmes Windows

Zabbix agent 2 s'exécute en tant que processus autonome ; toutefois, il peut également être exécuté en tant que service Windows.

Installation

Zabbix agent 2 peut être installé sur Windows en utilisant l'une des méthodes suivantes :

Les capacités de supervision de Zabbix agent 2 peuvent être étendues à l'aide de plugins chargeables, disponibles séparément. Pour plus de détails, consultez Plugins chargeables.

Consultez la page Zabbix agent sur Microsoft Windows pour plus de détails sur l'installation de Zabbix agent 2 (à 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 2 :

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 Zabbix agent 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, puis quitter.
-v --verbose Afficher les informations de débogage. Utilisez cette option avec les options -p et -t.
-V --version Afficher la version de l'agent et les informations de licence.
-R --runtime-control <option> Effectuer des fonctions administratives. Consultez la section 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 Zabbix agent 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 ;
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 pour Windows en tant que service.
-d --uninstall Désinstaller le service Zabbix agent pour Windows.
-s --start Démarrer le service Zabbix agent pour Windows.
-x --stop Arrêter le service Zabbix agent 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 Zabbix Agent pour Windows en utilisant le chemin par défaut vers le fichier de configuration.
  • Modifier le type de démarrage d'un service Zabbix Agent pour Windows installé en utilisant le fichier de configuration situé dans le même dossier que l'exécutable de l'agent.
zabbix_agent2 --print
zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agent2.conf
zabbix_agent2.exe -i
zabbix_agent2.exe -c zabbix_agent2.conf -S delayed
Contrôle de l’exécution

Le contrôle de l’exécution fournit plusieurs options de contrôle à distance.

Option Description
log_level_increase Augmenter le niveau de journalisation.
log_level_decrease Diminuer le niveau de journalisation.
metrics Répertorier les métriques disponibles.
version Afficher la version de l’agent.
userparameter_reload Recharger les valeurs des options UserParameter et Include à partir du fichier de configuration actuel.
help Afficher les informations d’aide sur le contrôle de l’exécution.

Exemples :

  • Augmenter le niveau de journalisation de l’agent 2.
  • Afficher les options de contrôle de l’exécution.
zabbix_agent2 -R log_level_increase
zabbix_agent2 -R help

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, la valeur par défaut est :
    • Pour une installation à partir des sources : /usr/local/etc/zabbix_agent2.conf, ou telle que définie par les variables de compilation --sysconfdir ou --prefix.
    • Pour une installation à partir de paquets : /etc/zabbix/zabbix_agent2.conf.
  • Sous Windows, la valeur par défaut est C:\Program Files\Zabbix Agent 2\zabbix_agent2.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).

Les paramètres de configuration de Zabbix agent 2 correspondent en grande partie à ceux de Zabbix agent, avec quelques exceptions :

Parameters Description
Paramètres de configuration spécifiques à Zabbix agent 2
ControlSocket Le chemin du socket de contrôle à l'exécution. Zabbix agent 2 utilise un socket de contrôle pour les commandes à l'exécution.
EnablePersistentBuffer,
PersistentBufferFile,
PersistentBufferPeriod		 Ces paramètres sont utilisés pour configurer le stockage persistant sur Zabbix agent 2 pour les éléments actifs.
ForceActiveChecksOnStart Détermine si l'agent doit effectuer les vérifications actives immédiatement après le redémarrage ou les répartir uniformément dans le temps.
Plugins Les plugins peuvent avoir leurs propres paramètres, au format Plugins.<Nom du plugin>.<Paramètre>=<valeur>. Un paramètre courant de plugin est System.Capacity, qui définit la limite du nombre de vérifications pouvant être exécutées simultanément.
StatusPort Le port sur lequel Zabbix agent 2 écoutera les requêtes HTTP de statut et affichera une liste des plugins configurés ainsi que certains paramètres internes.
Paramètres de configuration spécifiques à Zabbix agent non pris en charge par Zabbix agent 2
AllowRoot,
User		 Non pris en charge par Zabbix agent 2, car il ne prend pas en charge la mise en arrière-plan en tant que démon.
EnableRemoteCommands Obsolète ; les paramètres AllowKey et DenyKey sont utilisés à la place dans les deux agents.
ListenBacklog Utilisé dans Zabbix agent pour définir le nombre maximal de connexions en attente dans la file TCP. Non pris en charge par Zabbix agent 2.
LoadModule,
LoadModulePath		 Les modules chargeables ne sont pas pris en charge par Zabbix agent 2.
MaxLinesPerSecond,
LogRemoteCommands		 Dans Zabbix agent 2, Plugins.Log.MaxLinesPerSecond et Plugins.SystemRun.LogRemoteCommands sont utilisés à la place.
StartAgents Ce paramètre est utilisé dans Zabbix agent pour augmenter la concurrence des vérifications passives ou les désactiver. Dans Zabbix agent 2, la concurrence est configurée au niveau du plugin et peut être limitée par un paramètre de capacité. Les vérifications passives sont désactivées dans Zabbix Agent 2 si le paramètre Server n'est pas spécifié.

Pour plus de détails, consultez les options du fichier de configuration de Zabbix agent2.

Codes de sortie

Zabbix agent 2 peut également être compilé avec des versions plus anciennes d'OpenSSL (1.0.1, 1.0.2).

Dans ce cas, Zabbix fournit des mutex pour le verrouillage dans OpenSSL. Si le verrouillage ou le déverrouillage d'un mutex échoue, un message d'erreur est affiché sur le flux d'erreur standard (STDERR) et Agent 2 se termine avec le code de retour 2 ou 3, respectivement.