Agent Zabbix : installation automatique en une commande

Cette page documente l'usage de la page Agent du tableau de bord Logiserv : comment générer la commande d'installation propre à votre parc, l'exécuter et vérifier que le système remonte bien.

L'agent Zabbix est le composant à installer sur chaque serveur pour le superviser — voir la définition complète. Logiserv installe Zabbix Agent 2 sur Windows, et l'agent classique (zabbix-agent) sur Linux et macOS. L'installation manuelle demande de télécharger le bon paquet, configurer le fichier de l'agent (adresse du serveur, nom d'hôte, chiffrement PSK), créer l'hôte côté serveur et y reporter la clé, séparément sur chaque système.

Avec Logiserv, la page Agent du tableau de bord génère une commande d'installation unique, personnalisée pour votre parc. En une seule ligne à coller dans un terminal, l'agent est téléchargé, configuré et enregistré automatiquement — sans aucun fichier à éditer manuellement.

Prérequis

Avant de commencer, vérifiez les points suivants :

• Abonnement actif : La génération de la commande nécessite un abonnement en cours (actif, en essai ou en retard de paiement)
• Parc configuré : Un nom de parc doit être renseigné dans vos paramètres
• Droits administrateur : Nécessaires sur le système cible (Admin Windows, root/sudo Linux/macOS)

Accéder à la page Agent

Depuis votre tableau de bord, cliquez sur Agent dans le menu latéral, ou accédez directement à /dashboard/agent.

La page présente trois onglets : Windows, Linux et macOS.

Générer et copier la commande

Sélectionnez l'onglet correspondant au système d'exploitation du système à surveiller, puis cliquez sur Copier.

À cet instant, un lien signé est généré côté serveur, incorporant votre parc de façon sécurisée. Ce lien est valable 1 heure — au-delà, il est automatiquement invalidé.

Le lien contient un token HMAC-SHA256 signé avec votre secret d'authentification. Le parc n'est jamais visible en clair dans l'URL.

Installation par système d'exploitation

Windows

Ouvrez PowerShell en tant qu'administrateur :

• Win + X → Windows PowerShell (Admin) ou Terminal (Admin)

Collez la commande copiée et appuyez sur Entrée :

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

Ce que fait le script :

1. Détecte si Zabbix Agent est déjà installé via le registre Windows
2. Si oui : arrête le service, désinstalle l'ancienne version via son GUID MSI
3. Sauvegarde l'ancienne configuration (.bak horodaté)
4. Télécharge le dernier MSI Zabbix Agent 2 depuis zabbix.com
5. Installe et configure l'agent avec les paramètres de votre parc
6. Démarre le service Zabbix Agent 2 automatiquement

Compatible : Windows Server 2012 R2+, Windows 10/11, architecture x64.

Linux

Ouvrez un terminal sur le serveur et collez la commande :

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

Ce que fait le script :

1. Détecte automatiquement votre distribution (Debian, Ubuntu, Raspberry Pi OS, RHEL, Rocky Linux, AlmaLinux, Oracle Linux, Amazon Linux, SLES, openSUSE Leap)
2. Ajoute le dépôt officiel Zabbix pour votre distro
3. Installe ou met à jour zabbix-agent via le gestionnaire de paquets
4. Sauvegarde l'ancienne configuration si elle existe
5. Déploie la configuration de votre parc
6. Démarre (ou redémarre) le service zabbix-agent

Commandes utiles après installation :

# Vérifier le statut
sudo systemctl status zabbix-agent
 
# Consulter les logs en temps réel
journalctl -u zabbix-agent -f
 
# Redémarrer l'agent
sudo systemctl restart zabbix-agent

Compatibilité : Debian 11/12/13, Ubuntu 22.04/24.04/26.04, Raspberry Pi OS, RHEL / Rocky Linux / AlmaLinux / Oracle Linux 8/9, Amazon Linux 2 / 2023, SLES / openSUSE Leap 15 — architectures x86_64 et ARM64.

macOS

Ouvrez Terminal (Finder → Applications → Utilitaires) et collez la commande :

curl -sSL "https://logiserv.app/api/agent-script/macos?token=..." | sudo bash

Ce que fait le script :

1. Vérifie que le Mac est équipé d'une puce Apple Silicon (M1/M2/M3/M4)
2. Télécharge le PKG Zabbix Agent adapté
3. Installe l'agent et sauvegarde l'ancienne configuration si présente
4. Déploie la configuration de votre parc
5. Charge le service via launchd

Commandes utiles après installation :

# Vérifier le statut
sudo launchctl list | grep zabbix
 
# Consulter les logs
tail -f /var/log/zabbix/zabbix_agentd.log
 
# Redémarrer l'agent
sudo launchctl unload /Library/LaunchDaemons/com.zabbix.zabbix_agentd.plist
sudo launchctl load /Library/LaunchDaemons/com.zabbix.zabbix_agentd.plist

Compatibilité : macOS 11 Big Sur et supérieur, Apple Silicon uniquement (Zabbix ne publie plus d'agent pour les Mac Intel).

Vérifier l'installation

Une fois la commande exécutée, l'agent démarre automatiquement et s'enregistre sur le serveur de supervision. Votre système apparaît dans le Tableau de bord sous 2 à 3 minutes.

Si le système n'apparaît pas, vérifiez :

Côté réseau, rien n'est à configurer dans la grande majorité des cas : l'agent fonctionne uniquement en mode actif. C'est lui qui se connecte au serveur Logiserv, en sortie sur le port 10051 (TCP), et il n'écoute sur aucun port. Aucun port entrant à ouvrir, aucune règle de pare-feu à créer. Seul un réseau qui filtre aussi le trafic sortant doit autoriser zabbix.logiserv.re:10051.

Réinstallation ou mise à jour

Il suffit de régénérer une commande depuis la page Agent et de la réexécuter — le script détecte et désinstalle automatiquement l'ancienne version avant d'installer la nouvelle. Aucune manipulation manuelle n'est nécessaire.

Sécurité

• Token signé : chaque lien est signé côté serveur et expire après 1 heure
• Parc protégé : le nom de votre parc est encodé dans le token, jamais exposé en clair
• Communications chiffrées : toutes les communications entre l'agent et la plateforme utilisent un chiffrement PSK (Pre-Shared Key)

Métriques collectées automatiquement

Une fois l'agent installé, il collecte en continu :

• CPU : utilisation globale et par cœur, charge système
• Mémoire : RAM utilisée/disponible, swap
• Disque : espace utilisé/libre, I/O read/write
• Réseau : trafic entrant/sortant par interface
• Services : état des services système (Windows services, systemd, launchd)

Questions fréquentes

Comment télécharger Zabbix Agent 2 pour Windows ?

Le plus simple est de générer la commande depuis la page Agent de Logiserv : elle télécharge automatiquement le dernier MSI officiel depuis zabbix.com et l'installe avec la configuration de votre parc, sans étape manuelle. Pour un téléchargement manuel, le MSI est disponible sur le site officiel Zabbix, mais il faudra alors configurer zabbix_agent2.conf vous-même.

Zabbix Agent 1 ou Zabbix Agent 2, lequel installer ?

Zabbix Agent 2, réécrit en Go, est la version actuelle recommandée : architecture par plugins, empreinte mémoire réduite par rapport à l'Agent 1 historique en C. La page Agent de Logiserv installe Zabbix Agent 2 sur Windows, et l'agent classique sur Linux et macOS (Zabbix ne publie pas de paquet macOS pour Agent 2) : les métriques collectées pour la supervision système sont équivalentes.

L'agent doit-il rester connecté en permanence au serveur Zabbix ?

Oui, l'agent envoie ses métriques en continu. Avec Logiserv, il fonctionne uniquement en mode actif : il se connecte lui-même au serveur de supervision en sortie sur le port 10051 (TCP) et n'écoute sur aucun port. Aucun port entrant à ouvrir, aucune règle de pare-feu à créer.

Comment vérifier que l'agent Zabbix est bien installé ?

Windows : services.msc puis chercher le service Zabbix Agent 2. Linux : sudo systemctl status zabbix-agent. macOS : sudo launchctl list | grep zabbix. Avec Logiserv, le système apparaît aussi automatiquement dans le tableau de bord sous 2 à 3 minutes après l'installation.

Pour aller plus loin

• Configuration du parc - Gérer vos systèmes surveillés
• Tableau de bord - Visualiser vos métriques
• Alertes - Configurer les notifications

Prêt à surveiller votre infrastructure ?

Rendez-vous sur la page Agent de votre tableau de bord, copiez la commande pour votre OS et exécutez-la en tant qu'administrateur. En moins d'une minute, votre système est opérationnelle et visible dans votre tableau de bord.