10 Agent Zabbix pour Microsoft Windows

Configuration de l'agent

Les deux générations d'agents Zabbix s'exécutent en tant que service Windows. Pour l'agent Zabbix 2, remplacez agentd par agent2 dans les instructions ci-dessous.

Vous pouvez exécuter une seule instance de l'agent Zabbix ou plusieurs instances de l'agent sur un hôte Microsoft Windows. Une seule instance peut utiliser le fichier de configuration par défaut C:\zabbix_agentd.conf ou un fichier de configuration spécifié dans la ligne de commande. En cas d'instances multiples, chacune des instances d'agent doit avoir son propre fichier de configuration (l'une des instances peut utiliser le fichier de configuration par défaut).

Un exemple de fichier de configuration (conf/zabbix_agentd.win.conf) est disponible dans l'archive source de Zabbix.

Voir les options du fichier de configuration pour plus de détails sur la configuration de l'agent Windows Zabbix.

Paramètre Hostname

Pour effectuer des vérifications actives sur un hôte, l'agent Zabbix doit avoir défini le nom d'hôte. De plus, la valeur du nom d'hôte définie côté agent doit correspondre exactement au "Nom d'hôte" configuré pour l'hôte dans le frontend.

La valeur du nom d'hôte côté agent peut être définie par le paramètre Hostname ou HostnameItem dans le fichier de configuration de l'agent - ou les valeurs par défaut sont utilisées si aucun de ces paramètres n'est spécifié.

La valeur par défaut du paramètre HostnameItem est la valeur renvoyée par la clé d'agent "system.hostname". Pour Windows, il renvoie le résultat de la fonction gethostname(), qui interroge les fournisseurs d'espace de noms pour déterminer le nom d'hôte local. Si aucun fournisseur d'espace de noms ne répond, le nom NetBIOS est renvoyé.

La valeur par défaut de Hostname est la valeur renvoyée par le paramètre HostnameItem. Ainsi, en effet, si ces deux paramètres ne sont pas spécifiés, le nom d'hôte réel sera le nom NetBIOS de l'hôte ; L'agent Zabbix utilisera le nom d'hôte NetBIOS pour récupérer la liste des vérifications actives du serveur Zabbix et lui envoyer les résultats.

La valeur par défaut de Hostname est la valeur renvoyée par le paramètre HostnameItem. Ainsi, en effet, si ces deux paramètres ne sont pas spécifiés, le nom d'hôte réel sera le nom NetBIOS de l'hôte ; L'agent Zabbix utilisera le nom d'hôte NetBIOS pour récupérer la liste des vérifications actives du serveur Zabbix et lui envoyer les résultats.

La clé "system.hostname" prend en charge deux paramètres facultatifs - type et transform.

Le paramètre Type détermine le type de nom que l'élément doit renvoyer. Valeurs prises en charge :

• netbios (par défaut) - renvoie le nom d'hôte NetBIOS qui est limité à 15 symboles et est en MAJUSCULES uniquement ;
• host - sensible à la casse, renvoie le nom d'hôte Windows complet et réel (sans domaine) ;
• shorthost (pris en charge depuis Zabbix 5.4.7) - renvoie une partie du nom d'hôte avant le premier point. Il renverra une chaîne complète si le nom ne contient pas de point.

Le paramètre transform est pris en charge depuis Zabbix 5.4.7 et permet de spécifier une règle de transformation supplémentaire pour le nom d'hôte. Valeurs prises en charge :

• none (par défaut) - utilise la casse d'origine;
• lower - convertit le texte en minuscule.

Ainsi, pour simplifier la configuration du fichier zabbix_agentd.conf et le rendre unifié, deux approches différentes pourraient être utilisées.

1. laisser les paramètres Hostname ou HostnameItem non définis et l'agent Zabbix utilisera le nom d'hôte NetBIOS comme nom d'hôte ;
2. laisser le paramètre Hostname non défini et définissez HostnameItem comme ceci :
   HostnameItem=system.hostname[host] - pour que l'agent Zabbix utilise le nom d'hôte Windows complet et réel (sensible à la casse) comme nom d'hôte
   HostnameItem=system.hostname[shorthost,lower] - pour que l'agent Zabbix n'utilise qu'une partie du nom d'hôte avant le premier point, converti en minuscules.

Le nom d'hôte est également utilisé dans le cadre du nom de service Windows qui est utilisé pour installer, démarrer, arrêter et désinstaller le service Windows. Par exemple, si le fichier de configuration de l'agent Zabbix spécifie Hostname=Windows_db_server, alors l'agent sera installé en tant que service Windows "Zabbix Agent [Windows_db_server]". Par conséquent, pour avoir un nom de service Windows différent pour chaque instance d'agent Zabbix, chaque instance doit utiliser un nom d'hôte différent.

Installation de l'agent en tant que service Windows

Pour installer une seule instance de l'agent Zabbix avec la valeur par défaut du fichier de configuration c:\zabbix_agentd.conf :

zabbix_agentd.exe --install

::: note importante Sur un système 64 bits, une version 64 bits de l'agent Zabbix est requise pour que toutes les vérifications liées à l'exécution de processus 64 bits fonctionnent correctement. :::

Si vous souhaitez utiliser un fichier de configuration autre que c:\zabbix_agentd.conf, vous devez utiliser la commande suivante pour la mise en place des services :

zabbix_agentd.exe --config <votre_fichier_de_configuration> --install

Un chemin d'accès complet au fichier de configuration doit être spécifié.

Plusieurs instances de l'agent Zabbix peuvent être installées en tant que services comme ceci :

  zabbix_agentd.exe --config <fichier_de_configuration_pour_instance_1> --install --multiple-agents
         zabbix_agentd.exe --config <fichier_de_configuration_pour_instance_2> --install --multiple-agents
         ...
         zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents

Le service installé devrait maintenant être visible dans le Panneau de configuration.

Démarrage de l'agent

Pour démarrer le service de l'agent, vous pouvez utiliser le Panneau de configuration ou le faire à partir de la ligne de commande.

Pour démarrer une seule instance de l'agent Zabbix avec le fichier de configuration par défaut :

 zabbix_agentd.exe --start

Pour démarrer une seule instance de l'agent Zabbix avec un autre fichier de configuration :

 zabbix_agentd.exe --config <your_configuration_file> --start

Pour démarrer l'une des multiples instances de l'agent Zabbix :

 zabbix_agentd.exe --config <configuration_file_for_this_instance> --start --multiple-agents

Arrêt de l'agent

Pour arrêter le service de l'agent, vous pouvez utiliser le Panneau de configuration ou le faire à partir de ligne de commande.

Pour arrêter une seule instance de l'agent Zabbix démarrée avec la valeur par défaut du fichier de configuration:

 zabbix_agentd.exe --stop

Pour arrêter une seule instance de l'agent Zabbix démarrée avec un autre fichier de configuration:

 zabbix_agentd.exe --config <votre_fichier_de_configuration> --stop

Pour arrêter l'une des multiples instances de l'agent Zabbix :

 zabbix_agentd.exe --config <fichier_de_configuration_pour_cette_instance> --stop --multiple-agents

Désinstallation du service Windows de l'agent

Pour désinstaller une seule instance de l'agent Zabbix en utilisant la valeur par défaut du fichier de configuration:

   zabbix_agentd.exe --uninstall

Pour désinstaller une seule instance de l'agent Zabbix à l'aide d'un autre fichier de configuration que celui par défaut :

   zabbix_agentd.exe --config <votre_fichier_de_configuration> --uninstall

Pour désinstaller plusieurs instances de l'agent Zabbix des services Windows :

  zabbix_agentd.exe --config <configuration_file_for_instance_1> --uninstall --multiple-agents
         zabbix_agentd.exe --config <fichier_de_configuration_pour_instance_2> --uninstall --multiple-agents
         ...
         zabbix_agentd.exe --config <configuration_file_for_instance_N> --uninstall --multiple-agents

Limitations

L'agent Zabbix pour Windows ne prend pas en charge les configurations Windows non standard dans lesquelles les processeurs sont répartis de manière non uniforme sur les nœuds NUMA. Si les processeurs logiques ne sont pas distribués de manière uniforme, les métriques de performances du processeur peuvent ne pas être disponibles pour certains processeurs. Par exemple, s'il y a 72 CPU logiques avec 2 nœuds NUMA, les deux nœuds doivent avoir 36 CPU chacun.