Installer Zabbix Agent 2 : Windows, Linux, macOS et PSK

Zabbix Agent 2 est le composant à installer sur chaque système à superviser. Il collecte les métriques système — processeur, mémoire, disques, services, journaux — et les transmet au serveur Zabbix. Voir la définition complète de l'agent Zabbix.

Ce guide donne la vue d'ensemble : choisir la bonne version, comprendre les deux modes de fonctionnement, sécuriser la liaison. Chaque système d'exploitation a ensuite son guide détaillé.

Le plus simple : avec Logiserv

Logiserv s'appuie sur ce même moteur Zabbix et automatise l'intégralité de la chaîne. Depuis la page Agent du tableau de bord, une commande est générée pour votre parc :

# Linux
curl -sSL "https://www.logiserv.app/api/agent-script/linux?token=..." | sudo bash

# Windows (PowerShell administrateur)
irm "https://www.logiserv.app/api/agent-script/windows?token=..." | iex

# macOS (Apple Silicon)
curl -sSL "https://www.logiserv.app/api/agent-script/macos?token=..." | sudo bash

Cette commande installe l'agent depuis les sources officielles de Zabbix — Zabbix Agent 2 sur Windows, l'agent classique sur Linux (dépôt officiel) et macOS —, 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 templates correspondant au système détecté 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 de 6 à 7 étapes et 10 à 15 minutes par système, sans compter la création de l'hôte côté serveur Zabbix. Voir la comparaison détaillée.

Choisir son guide d'installation

RHEL, CentOS Stream et Oracle Linux suivent la procédure Rocky Linux : ce sont les mêmes paquets RPM el8/el9.

Agent 1 ou Agent 2 : que choisir ?

Zabbix maintient deux agents en parallèle.

Pour une nouvelle installation, prenez Agent 2. L'Agent 1 reste maintenu et pertinent si votre parc existant l'utilise déjà partout : mélanger les deux complique la maintenance sans bénéfice immédiat.

Mode actif ou mode passif : la décision structurante

C'est le choix qui détermine votre architecture réseau, et la source la plus fréquente de blocages en entreprise.

Mode passif

Le serveur Zabbix interroge l'agent sur le port 10050/TCP.

• il faut que le serveur puisse joindre chaque système
• impraticable derrière un NAT, un pare-feu restrictif ou en multi-site
• une règle entrante à ouvrir sur chaque système

Directive : Server=192.168.1.10

Mode actif

L'agent se connecte au serveur et pousse ses données sur le port 10051/TCP.

• aucun port entrant à ouvrir sur les systèmes supervisés
• fonctionne derrière un NAT, entre sites, vers le cloud
• charge répartie côté agents plutôt que concentrée sur le serveur

Directive : ServerActive=192.168.1.10

Privilégiez le mode actif dès que les systèmes ne sont pas sur le même réseau que le serveur. Les deux modes peuvent cohabiter dans le même fichier de configuration.

La configuration minimale

Quel que soit le système, trois directives suffisent à faire fonctionner un agent :

Server=192.168.1.10
ServerActive=192.168.1.10
Hostname=srv-web-01

Le piège du Hostname

C'est l'erreur la plus répandue. 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 remontent jamais — sans message d'erreur explicite côté serveur, ce qui rend le diagnostic long.

Pour reprendre automatiquement le nom du système :

HostnameItem=system.hostname

Chiffrer la liaison avec une clé PSK

Par défaut, les métriques transitent en clair. Sur un réseau local cloisonné, cela peut se discuter. Dès que le trafic sort de votre réseau — site distant, cloud, VPN — c'est à proscrire.

Zabbix propose deux mécanismes : les certificats (adaptés à un parc important avec une PKI existante) et les clés pré-partagées PSK, plus simples à mettre en place.

Génération d'une clé de 32 octets sous Linux ou macOS :

openssl rand -hex 32

Les quatre directives à ajouter :

TLSConnect=psk
TLSAccept=psk
TLSPSKIdentity=PSK-srv-web-01
TLSPSKFile=/etc/zabbix/zabbix_agent2.psk

La même clé et la même identité doivent être renseignées dans l'onglet Chiffrement de l'hôte côté serveur.

Vérifier que l'agent fonctionne

L'agent sait tester ses propres métriques sans passer par le serveur — le premier réflexe de diagnostic :

zabbix_agent2 -t agent.version
zabbix_agent2 -t system.cpu.load[all,avg1]
zabbix_agent2 -t vfs.fs.size[/,pfree]

Sous Windows :

& "C:\Program Files\Zabbix Agent 2\zabbix_agent2.exe" -t agent.version

Une réponse de la forme [d|0.150000] indique que la collecte fonctionne localement. Si l'agent répond mais que rien n'arrive côté serveur, le problème est dans le Hostname, le PSK ou le réseau — pas dans l'agent.

Les quatre erreurs les plus fréquentes

Déployer sur un parc entier

Sur un système, l'installation prend une dizaine de minutes. Sur cinquante, la procédure manuelle atteint ses limites : dépôt, paquet, configuration, clé unique, création de l'hôte côté serveur, report de la clé, vérification. Chaque étape manuelle est une occasion de divergence entre deux systèmes, et ces divergences ne se manifestent souvent que des semaines plus tard, quand une métrique manque au moment d'un incident.

Trois approches d'industrialisation :

1. Outil de configuration (Ansible, Puppet, DSC) — robuste et auditable, mais il faut maintenir les playbooks et un coffre à secrets pour les clés PSK.
2. Auto-enregistrement Zabbix — les hôtes se créent seuls à la première connexion, à condition d'avoir configuré actions et métadonnées d'hôte côté serveur.
3. Une plateforme qui prend en charge les deux bouts — l'installation et la création de l'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é de la chaîne. Depuis la page Agent du tableau de bord, une commande est générée pour votre parc :

# Linux
curl -sSL "https://www.logiserv.app/api/agent-script/linux?token=..." | sudo bash

# Windows (PowerShell administrateur)
irm "https://www.logiserv.app/api/agent-script/windows?token=..." | iex

Cette commande installe l'agent depuis les sources officielles de Zabbix — Zabbix Agent 2 sur Windows, l'agent classique sur Linux (dépôt officiel) et macOS —, 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 templates correspondant au système détecté et démarre le service. Aucun fichier à éditer, aucune clé à recopier, aucun hôte à créer manuellement.

Installation manuelle ou Logiserv

Moteur de collecte

Zabbix 7.4

Le moteur open source de référence, opéré et mis à jour par Logiserv.

Systèmes supportés

Windows, Linux, macOS

Debian, Ubuntu, Raspberry Pi OS, RHEL, Rocky Linux, AlmaLinux, Oracle Linux, Amazon Linux, SLES et openSUSE reconnus automatiquement.

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

Mode actif : seul le trafic sortant vers le serveur est nécessaire.

Templates fournis

11 templates, 232 métriques

139 déclencheurs préréglés, dont la détection d'anomalies système et réseau.

Mise à jour de l'agent

Version stable la plus récente

Windows et macOS : version résolue à la génération du script depuis cdn.zabbix.com. Linux : paquet du dépôt officiel Zabbix.

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

Zabbix Agent 2 : questions fréquentes

Qu'est-ce que Zabbix Agent 2 ?

Zabbix Agent 2 est l'agent de supervision actuel de Zabbix, réécrit en Go. Installé sur un serveur ou un poste, il collecte les métriques système (CPU, mémoire, disques, services, journaux) et les transmet au serveur Zabbix. Il remplace progressivement l'agent historique écrit en C.

Quels ports utilise Zabbix Agent 2 ?

En mode passif, le serveur Zabbix interroge l'agent sur le port 10050/TCP, qui doit être ouvert en entrée sur chaque système. En mode actif, l'agent se connecte au serveur sur le port 10051/TCP : seul le trafic sortant est nécessaire, aucun port entrant n'est à ouvrir. Logiserv utilise exclusivement le mode actif : aucune règle de pare-feu à créer.

Zabbix Agent 2 est-il gratuit ?

Oui. Zabbix Agent 2 est un logiciel open source, téléchargeable sans licence sur le site officiel de Zabbix, pour Windows et Linux. Le coût d'une supervision Zabbix tient à l'exploitation du serveur central (hébergement, mises à jour, sauvegardes), pas à l'agent.

Comment passer de Zabbix Agent 1 à Zabbix Agent 2 ?

Installez le paquet zabbix-agent2, reportez vos directives de zabbix_agentd.conf dans zabbix_agent2.conf (Server, ServerActive, Hostname, PSK), puis arrêtez et désactivez l'ancien service zabbix-agent. Les deux agents écoutent sur le même port 10050 : ils ne peuvent pas fonctionner en même temps sur un même système.

Pour aller plus loin

• Installer sur Windows · Ubuntu · Debian · Rocky Linux · AlmaLinux · Amazon Linux · SLES et openSUSE · Raspberry Pi · macOS
• Quelles métriques surveiller sur un serveur — que faire une fois l'agent en place
• Comment surveiller Windows Server et pourquoi superviser un serveur Linux
• Supervision serveur Windows et Linux : le guide — la démarche complète, du choix des métriques aux alertes
• Éviter les faux positifs Zabbix — régler les seuils pour que les alertes restent crédibles