Installer Zabbix Agent 2 sur Windows Server en 15 min

Superviser un serveur Windows avec Zabbix suppose d'installer un agent sur le système : un petit service qui collecte les métriques système (processeur, mémoire, disques, services, journaux d'événements) et les transmet au serveur de supervision. Voir la définition complète de l'agent Zabbix.

Ce guide décrit l'installation manuelle et complète de Zabbix Agent 2 sur Windows Server 2016, 2019, 2022, 2025 ainsi que Windows 10 et 11. Il fonctionne avec n'importe quel serveur Zabbix, que vous l'hébergiez vous-même ou non.

Le plus simple : avec Logiserv

Logiserv s'appuie sur ce même moteur Zabbix et automatise l'intégralité des six étapes ci-dessous. Depuis la page Agent de votre tableau de bord, une commande PowerShell est générée pour votre parc :

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

Cette commande télécharge le dernier MSI officiel, génère une clé PSK unique pour ce système, écrit la configuration, crée l'hôte côté serveur, l'associe aux bons templates et démarre le service. Aucun fichier à éditer, aucune clé à recopier, aucun hôte à créer manuellement.

Comptez 1 à 2 minutes par système avec Logiserv. L'installation manuelle détaillée ci-dessous demande 6 étapes et 15 minutes environ par serveur, sans compter la création de l'hôte côté serveur Zabbix. Voir la comparaison détaillée.

Agent 1 ou Agent 2 : lequel installer ?

Zabbix propose deux agents. Agent 2, réécrit en Go, est la version actuellement recommandée :

• architecture par plugins (MySQL, PostgreSQL, Docker, Redis… sans script externe)
• une seule connexion persistante au serveur au lieu d'une par vérification
• empreinte mémoire réduite par rapport à l'Agent 1 historique écrit en C

L'Agent 1 reste maintenu et convient si vous avez déjà un parc homogène qui l'utilise. Pour une nouvelle installation Windows, prenez l'Agent 2.

Prérequis

• un accès administrateur sur le système à superviser
• l'adresse IP ou le nom DNS de votre serveur Zabbix
• un accès réseau sortant vers le serveur Zabbix sur le port 10051/TCP
• environ 60 Mo d'espace disque

Étape 1 : télécharger l'agent

Les binaires officiels sont publiés sur le CDN de Zabbix. Pour la branche 7.4, le paquet Windows 64 bits se trouve à cette adresse :

https://cdn.zabbix.com/zabbix/binaries/stable/7.4/7.4.10/zabbix_agent2-7.4.10-windows-amd64-openssl.msi

En PowerShell (ouvert en tant qu'administrateur) :

$version = "7.4.10"
$url = "https://cdn.zabbix.com/zabbix/binaries/stable/7.4/$version/zabbix_agent2-$version-windows-amd64-openssl.msi"
Invoke-WebRequest -Uri $url -OutFile "$env:TEMP\zabbix_agent2.msi" -UseBasicParsing

Étape 2 : installer l'agent

Installation silencieuse

msiexec /i "$env:TEMP\zabbix_agent2.msi" /qn `
  SERVER="192.168.1.10" `
  SERVERACTIVE="192.168.1.10" `
  HOSTNAME="$env:COMPUTERNAME" `
  ENABLEPATH=1

Remplacez 192.168.1.10 par l'adresse de votre serveur Zabbix. Les propriétés MSI renseignent directement la configuration, ce qui évite d'éditer le fichier ensuite.

Installation graphique

Double-cliquez sur le MSI et suivez l'assistant. Il demande le nom d'hôte, l'adresse du serveur et propose d'activer le chiffrement PSK.

L'agent s'installe par défaut dans C:\Program Files\Zabbix Agent 2\ et s'enregistre comme service Windows sous le nom Zabbix Agent 2.

Étape 3 : configurer l'agent

Le fichier de configuration est :

C:\Program Files\Zabbix Agent 2\zabbix_agent2.conf

Les directives indispensables :

# Adresse du serveur Zabbix autorisé à interroger cet agent (mode passif)
Server=192.168.1.10
 
# Adresse du serveur vers lequel l'agent pousse ses métriques (mode actif)
ServerActive=192.168.1.10
 
# Nom de l'hôte — doit correspondre EXACTEMENT au nom d'hôte créé côté serveur
Hostname=SRV-FICHIERS-01
 
# Journal de l'agent
LogFile=C:\Program Files\Zabbix Agent 2\zabbix_agent2.log
LogFileSize=10

Le piège du Hostname

C'est l'erreur la plus fréquente. La valeur de Hostname doit correspondre au caractère près au champ « Nom d'hôte » de l'hôte créé dans l'interface Zabbix. Une majuscule de différence et les vérifications actives ne remonteront jamais, sans message d'erreur explicite côté serveur.

Pour utiliser automatiquement le nom du système, remplacez la ligne par :

HostnameItem=system.hostname

Actif ou passif ?

• Mode passif (Server=) : le serveur Zabbix interroge l'agent. Il faut que le serveur puisse joindre le système sur le port 10050 — compliqué derrière un NAT ou un pare-feu.
• Mode actif (ServerActive=) : l'agent se connecte au serveur et pousse ses données. Aucun port entrant à ouvrir. C'est le mode à privilégier pour des systèmes distants.

Les deux peuvent cohabiter dans le même fichier.

Étape 4 : chiffrer la liaison avec une clé PSK

Sans chiffrement, les métriques circulent en clair. Sur un réseau local cloisonné, cela peut se discuter ; dès que le trafic sort de votre réseau, c'est à proscrire.

Générez une clé de 32 octets (64 caractères hexadécimaux) :

$bytes = New-Object byte[] 32
[Security.Cryptography.RandomNumberGenerator]::Create().GetBytes($bytes)
$psk = ($bytes | ForEach-Object { $_.ToString("x2") }) -join ""
Set-Content -Path "C:\Program Files\Zabbix Agent 2\zabbix_agent2.psk" -Value $psk -Encoding ASCII -NoNewline
$psk

Puis complétez zabbix_agent2.conf :

TLSConnect=psk
TLSAccept=psk
TLSPSKIdentity=PSK-SRV-FICHIERS-01
TLSPSKFile=C:\Program Files\Zabbix Agent 2\zabbix_agent2.psk

Reportez la même clé et la même identité dans l'onglet Chiffrement de l'hôte, côté serveur Zabbix. Une identité PSK distincte par système est fortement conseillée : une clé partagée compromise expose tout le parc.

Étape 5 : ouvrir le port dans le pare-feu

Uniquement nécessaire en mode passif :

New-NetFirewallRule -DisplayName "Zabbix Agent 2" `
  -Direction Inbound -Protocol TCP -LocalPort 10050 `
  -Action Allow -RemoteAddress 192.168.1.10

Restreindre -RemoteAddress à l'adresse du serveur Zabbix évite d'exposer l'agent à tout le réseau.

En mode actif, aucune règle entrante n'est nécessaire : seul le trafic sortant vers le port 10051 du serveur doit être autorisé.

Étape 6 : vérifier que tout fonctionne

Démarrez le service :

Restart-Service "Zabbix Agent 2"
Get-Service "Zabbix Agent 2"

Testez une métrique en local, sans passer par le serveur :

& "C:\Program Files\Zabbix Agent 2\zabbix_agent2.exe" -t system.cpu.load[all,avg1]
& "C:\Program Files\Zabbix Agent 2\zabbix_agent2.exe" -t vm.memory.size[pavailable]

Une réponse de la forme system.cpu.load[all,avg1] [d|0.150000] indique que l'agent collecte correctement.

Consultez enfin le journal :

Get-Content "C:\Program Files\Zabbix Agent 2\zabbix_agent2.log" -Tail 30

Messages d'erreur courants

Superviser plusieurs serveurs Windows

Répétée sur dix systèmes, cette procédure devient fastidieuse : télécharger le MSI, générer une clé PSK unique, éditer le fichier, créer l'hôte côté serveur, reporter la clé, vérifier le nom d'hôte. Comptez un quart d'heure par serveur, et chaque étape manuelle est une occasion de divergence entre deux systèmes.

Trois approches pour industrialiser :

1. GPO ou SCCM : déploiement du MSI avec des propriétés communes. Simple, mais la clé PSK devient partagée sur tout le parc — ce qui affaiblit le chiffrement.
2. Ansible, DSC ou Puppet : configuration par système, clés distinctes. Robuste, mais il faut maintenir les playbooks et un coffre à secrets.
3. L'auto-enregistrement Zabbix : les hôtes se créent automatiquement à la première connexion, à condition d'avoir configuré les actions et les métadonnées d'hôte côté serveur.

La même installation avec Logiserv

Logiserv s'appuie sur ce même moteur Zabbix et automatise l'intégralité des six étapes ci-dessus. Depuis la page Agent de votre tableau de bord, une commande PowerShell est générée pour votre parc :

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

Cette commande télécharge le dernier MSI officiel, génère une clé PSK unique pour ce système, écrit la configuration, crée l'hôte côté serveur, l'associe aux bons templates et démarre le service. Aucun fichier à éditer, aucune clé à recopier, aucun hôte à créer manuellement.

Installation manuelle ou Logiserv

Agent installé

Zabbix Agent 2

Dernière version stable, MSI officiel depuis cdn.zabbix.com.

Chiffrement

PSK unique par système

Clé de 32 octets générée à l'enrôlement, jamais partagée entre deux hôtes.

Port entrant requis

Aucun

L'agent fonctionne en mode actif : seul le trafic sortant est nécessaire.

Templates appliqués

Automatiquement

Windows, détection d'anomalies système et réseau, selon le rôle détecté.

Le détail du fonctionnement de la page Agent est décrit dans la documentation Logiserv.

Pour aller plus loin

• Installer Zabbix Agent 2 : le guide par système — la vue d'ensemble et les autres OS
• Installer Zabbix Agent sur Ubuntu et sur Debian — les équivalents Linux
• Comment surveiller Windows Server — quelles métriques et quels seuils une fois l'agent en place
• Supervision serveur Windows et Linux : le guide — la démarche complète, du choix des métriques aux alertes
• Quelles métriques surveiller sur un serveur — pour construire votre plan de supervision