Zabbix Documentation 4.0

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


Sidebar

fr:manual:appendix:install:windows_agent

2 Agent Zabbix sur Microsoft Windows

Configuration de l'agent

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

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, chaque instance 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 est disponible dans les archives source Zabbix : conf/zabbix_agentd.win.conf.

Voir les options de 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, vous devez définir le nom d'hôte de l'agent Zabbix. De plus, la valeur du nom d'hôte définie du côté de l'agent doit correspondre exactement au nom d'hôte configuré pour l'hôte dans l'interface frontale.

La valeur du nom d'hôte du côté de l'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” et, pour la plate-forme Windows, renvoie le nom d'hôte NetBIOS.

La valeur par défaut pour Hostname est la valeur renvoyée par le paramètre HostnameItem. Donc, en réalité, 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 extraire la liste des vérifications actives du serveur Zabbix et lui envoyer les résultats.

La clé system.hostname retourne toujours le nom d'hôte NetBIOS qui est limité à 15 symboles et en majuscule uniquement - indépendamment de la longueur et des caractères minuscules/majuscules dans le nom d'hôte réel.

À partir de la version 1.8.6 de l’agent Zabbix pour Windows, la clé “system.hostname” prend en charge un paramètre facultatif - type du nom. La valeur par défaut de ce paramètre est “netbios” (pour la compatibilité ascendante) et l'autre valeur possible est “hôte”.

La clé system.hostname[host] retourne toujours le nom d'hôte Windows complet, réel (sensible à la casse).

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

  1. laissez les paramètres Hostname ou HostnameItem non défini et l'agent Zabbix utilisera le nom d'hôte NetBIOS pour le paramètre hostname ;
  2. laissez le paramètre Hostname non défini et définissez HostnameItem comme ceci :
    HostnameItem=system.hostname[host]
    et l'agent Zabbix utilisera le nom d'hôte Windows complet, réel (sensible à la casse) comme paramètre hostname.

Le nom d'hôte est également utilisé dans le nom de service Windows utilisé pour l'installation, le démarrage, l'arrêt et la désinstallation du service Windows. Par exemple, si le fichier de configuration de l'agent Zabbix spécifie Hostname=Windows_db_server, 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 le fichier de configuration par défaut c:\zabbix_agentd.conf :

zabbix_agentd.exe --install
Sur les systèmes 64-bit, une version 64-bit de l'agent Zabbix est nécessaire pour toutes les vérifications associées à l'exécution de processus 64 bits pour fonctionner correctement.

Si vous souhaitez utiliser un fichier de configuration autre que c:\zabbix_agentd.conf, vous devez utiliser la commande suivante pour l'installation du service :

zabbix_agentd.exe --config <your_configuration_file> --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 tels que :

  zabbix_agentd.exe --config <configuration_file_for_instance_1> --install --multiple-agents
  zabbix_agentd.exe --config <configuration_file_for_instance_2> --install --multiple-agents
  ...
  zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents

Les services installés doivent maintenant être visible dans le Panneau de configuration.

Démarrage de l'agent

Pour démarrer l'agent, vous pouvez utiliser le Panneau de Configuration ou le faire via une 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 une instance de l'agent Zabbix lorsqu'il en existe plusieurs :

 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 via une ligne de commande.

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

 zabbix_agentd.exe --stop

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

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

Pour arrêter une instance de l'agent Zabbix lorsqu'il en existe plusieurs :

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

Désinstallation de l'agent Zabbix en tant que service

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

   zabbix_agentd.exe --uninstall

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

   zabbix_agentd.exe --config <your_configuration_file> --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 <configuration_file_for_instance_2> --uninstall --multiple-agents
  ...
  zabbix_agentd.exe --config <configuration_file_for_instance_N> --uninstall --multiple-agents