3 Agent 2

Aperçu

Zabbix agent 2 est une nouvelle génération de agent Zabbix, écrite en Go (avec une partie du code C réutilisée depuis 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 la 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 de tâches en tenant compte du planning 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 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.

Vérifications passives et actives

Zabbix agent 2 prend en charge les vérifications passives et actives, de la même manière que Zabbix agent. De plus, les vérifications actives de Zabbix agent 2 prennent en charge les intervalles flexibles/de planification 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 planifiera la première collecte de données pour les vérifications actives à un moment aléatoire conditionnellement, dans l'intervalle de mise à jour de l'élément, afin d'éviter des pics d'utilisation des ressources. Pour exécuter immédiatement les vérifications actives qui ne disposent pas d'un intervalle de mise à jour Scheduling après le redémarrage de l'agent, définissez le paramètre ForceActiveChecksOnStart (au niveau global) ou Plugins.<Plugin name>.System.ForceActiveChecksOnStart (n'affecte que les vérifications de plugins spécifiques) dans le fichier de configuration. Si le paramètre au niveau du plugin est défini, il remplacera 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.

Plateformes prises en charge

Pour les plateformes 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 du système d’exploitation et la version du système d’exploitation), puis suivez les instructions.
  • Sources Zabbix - téléchargez les fichiers source et compilez l’agent en les configurant avec l’option --enable-agent2.

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.

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 comme un processus autonome ; cependant, il peut également être exécuté en tant que service Windows.

Installation

Zabbix agent 2 peut être installé sous Windows à l'aide de 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 :

Parameter Description
UNIX and Windows agent
-c --config <config-file> Chemin vers le fichier de configuration.
Vous pouvez utiliser cette option pour spécifier un fichier de configuration qui n'est pas 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 et 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> Exécuter des fonctions d'administration. Voir runtime control.
Windows agent only
-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;
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 :

  • 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 C:\\Program Files\\Zabbix Agent 2\\zabbix_agent2.conf.
  • Modifier le type de démarrage d'un service Zabbix Agent installé pour Windows en utilisant le fichier de configuration zabbix_agent2.conf 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_agentd.conf
zabbix_agent2.exe -i
zabbix_agent2.exe -c zabbix_agent2.conf -S delayed
Contrôle à l'exécution

Le contrôle à l'exécution fournit plusieurs options pour le contrôle à distance.

Option Description
log_level_increase Augmenter le niveau de journalisation.
log_level_decrease Diminuer le niveau de journalisation.
metrics Lister 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 à l'exécution.

Exemples :

  • Augmenter le niveau de journalisation pour l'agent 2.
  • Afficher les options de contrôle à 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 est le suivant :

  • Sous UNIX, la valeur par défaut est /usr/local/etc/zabbix_agent2.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 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.<Plugin name>.<Parameter>=<value>. 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 l'affichage d'une liste des plugins configurés ainsi que de certains paramètres internes.
Paramètres de configuration spécifiques à Zabbix agent non pris en charge sur Zabbix agent 2
AllowRoot,
User		 Non pris en charge sur Zabbix agent 2, car il ne prend pas en charge la mise en mode 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 sur Zabbix agent 2.
LoadModule,
LoadModulePath		 Les modules chargeables ne sont pas pris en charge sur 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.