Service
Installer l'agent sous Windows

Installer l'agent sous Windows

Installez l'agent de supervision Logiserv sur un poste ou un serveur Windows en une commande PowerShell, vérifiez qu'il remonte bien ses données et corrigez les erreurs les plus courantes.

Vue d'ensemble

L'agent est le petit service qui collecte les mesures de votre machine Windows (processeur, mémoire, disques, services, journaux de sécurité) et les envoie au serveur de supervision Logiserv. Sous Windows, Logiserv installe Zabbix Agent 2, la version officielle publiée par Zabbix, déjà configurée pour votre parc.

L'installation tient en une seule commande PowerShell. Le script télécharge l'agent, l'installe sans fenêtre, enregistre la machine dans votre parc et démarre le service. Comptez deux à trois minutes.

Ce guide fonctionne pour Windows 10 et 11 comme pour Windows Server.

✅ Avant de commencer

Vérifiez ces quatre points :

  • Un abonnement actif (ou une période d'essai) sur votre compte Logiserv.
  • Un parc renseigné dans votre profil. Sans parc, la page Agent ne propose pas de commande.
  • Un compte administrateur sur la machine Windows à superviser.
  • Un accès sortant vers zabbix.logiserv.re sur le port 10051/TCP. C'est autorisé par défaut sur la plupart des réseaux.

Aucun port entrant n'est à ouvrir : c'est l'agent qui contacte le serveur Logiserv, jamais l'inverse. La machine peut se trouver derrière une box, un NAT ou un pare-feu d'entreprise sans configuration particulière.

🚀 Installation pas à pas

Ouvrir la page Agent

Dans votre tableau de bord, ouvrez la page Agents puis choisissez l'onglet Windows.

Si votre parc compte des clients (offre Business), choisissez d'abord le client concerné dans la liste : la machine sera rangée directement chez lui.

Copier la commande

Cliquez sur Copier. Un lien personnel et signé est généré à ce moment-là. Il est valable une heure et lié à votre parc : ne le partagez pas et ne le publiez pas dans un ticket ou un wiki.

Ouvrir PowerShell en administrateur

Appuyez sur Win + X, puis choisissez Terminal (administrateur) ou Windows PowerShell (administrateur). Acceptez la demande de contrôle de compte d'utilisateur.

Un PowerShell ouvert sans droits administrateur ne pourra pas installer le service : l'installation échouera dès la première étape.

Coller et lancer la commande

Collez la commande, de la forme suivante, puis appuyez sur Entrée :

irm "https://logiserv.app/api/agent-script/windows?token=..." | iex

Le script affiche six étapes : recherche d'une version existante, enregistrement de la machine, téléchargement, installation silencieuse, écriture de la configuration et démarrage du service. Il se termine par la ligne Service Zabbix Agent 2 : démarré (Running).

🔍 Vérifier que tout fonctionne

Dans la même fenêtre PowerShell, vérifiez l'état du service :

Get-Service "Zabbix Agent 2"

La colonne Status doit afficher Running.

Ouvrez ensuite la page Parc de Logiserv : la machine y apparaît sous son nom Windows en quelques minutes. Les premières valeurs (processeur, mémoire, disques) arrivent tout de suite. Les graphiques sur plusieurs jours, eux, se remplissent au bout d'environ une heure : les moyennes horaires ne sont calculées qu'à la fin de chaque heure pleine.

Si la machine est un hôte Hyper-V, le script le détecte tout seul et l'enregistre comme hyperviseur : vous n'avez rien à cocher.

🛠️ Problèmes fréquents

« Le lien a expiré » ou erreur 401

Le lien de la commande n'est valable qu'une heure. Retournez sur la page Agents, cliquez de nouveau sur Copier et relancez la commande.

Le service ne démarre pas

Le script affiche alors Service Zabbix Agent 2 : NON démarré. Consultez les deux journaux :

  • le journal d'installation : %TEMP%\zabbix_install.log ;
  • le journal de l'agent : C:\Program Files\Zabbix Agent 2\zabbix_agent2.log.

Un antivirus ou un EDR qui bloque l'installeur MSI est la cause la plus fréquente. Autorisez-le, puis relancez la commande.

La machine n'apparaît pas dans le parc

Testez l'accès au serveur de supervision depuis la machine :

Test-NetConnection zabbix.logiserv.re -Port 10051

Si TcpTestSucceeded vaut False, un pare-feu filtre le trafic sortant. Demandez l'ouverture de cette seule destination : zabbix.logiserv.re, port 10051/TCP, en sortie.

Le journal parle d'un échec TLS ou de clé PSK

La configuration ne correspond plus à l'enregistrement de la machine, souvent après une installation manuelle. Relancez simplement la commande depuis la page Agents : le script remplace la configuration et la clé de chiffrement par des valeurs cohérentes.

🔄 Mettre à jour ou réinstaller

Pour passer à une version plus récente de l'agent ou repartir sur une installation propre, relancez la commande de la page Agents. Le script détecte l'agent déjà présent, le désinstalle puis installe la dernière version, sans créer de doublon dans votre parc.

📚 Pour aller plus loin

Partagez ce lien