Installation de l'Agent de Surveillance

La page Configuration et Téléchargement des Agents vous permet d'installer facilement l'agent de surveillance sur vos machines Windows, Linux et macOS. En un seul clic, vous téléchargez tous les fichiers nécessaires pour une installation automatique et sécurisée.

Prérequis

Avant d'accéder à cette page, assurez-vous d'avoir :

• Un parc configuré : Votre profil utilisateur doit contenir un nom de parc (visible dans vos paramètres)
• Droits administrateur/root : Nécessaires sur la machine où vous souhaitez installer l'agent
• Système compatible : Windows, Linux (Debian/Ubuntu/RHEL/CentOS/Rocky/AlmaLinux) ou macOS

Accéder à la page

Depuis votre tableau de bord, vous pouvez accéder à cette page de deux manières :

1. Navigation : Cliquez sur Agent dans le menu latéral gauche
2. URL directe : Accédez à /dashboard/agent

Interface de la page

La page utilise un système d'onglets pour séparer les instructions par système d'exploitation :

• Onglet Windows : Installation MSI avec script batch
• Onglet Linux : Installation automatique via script bash
• Onglet macOS : Installation PKG avec script bash

Chaque onglet contient :

1. Titre et description

En haut de la page, vous trouverez :

• Titre : "Configuration et Téléchargement des Agents"
• Description : Une explication rapide du fonctionnement

2. Détection du parc

Le système affiche automatiquement votre nom de parc :

🏭 Nom du Parc détecté : VOTRE_PARC_PRODUCTION

Cette information est récupérée depuis votre profil utilisateur et sera utilisée pour configurer automatiquement l'agent avec les bons paramètres.

Note : Si aucun parc n'est détecté, un message d'avertissement jaune s'affiche vous invitant à configurer votre profil.

3. Fichiers à télécharger

Un encadré gris liste les fichiers qui seront téléchargés selon votre système d'exploitation :

Fichiers communs à tous les OS

• Fichier .conf : Configuration personnalisée de l'agent avec vos paramètres de parc
• Fichier .psk : Clé de sécurité pour les communications chiffrées
• Script d'installation : Automatise l'installation complète

Spécifique à chaque OS

• Windows : Fichier MSI (agent_logiserv.msi) + Script batch (.bat)
• Linux : Script bash (.sh) qui télécharge l'agent selon votre distribution
• macOS : Script bash (.sh) qui télécharge le PKG adapté à votre architecture

4. Instructions d'installation

Un encadré coloré avec une icône de bouclier détaille la procédure spécifique à chaque OS :

Windows (encadré orange) :

1. Télécharger tous les fichiers
2. Placer les fichiers dans le même dossier
3. Clic droit sur le .bat → "Exécuter en tant qu'administrateur"

Linux (encadré bleu) :

1. Télécharger tous les fichiers
2. Transférer sur le serveur (SCP, SFTP)
3. Exécuter : sudo bash install_zabbix_*.sh

macOS (encadré violet) :

1. Télécharger tous les fichiers
2. Ouvrir Terminal, naviguer vers les fichiers
3. Exécuter : bash install_zabbix_*.sh

Important : Les privilèges administrateur/root/sudo sont obligatoires pour tous les systèmes.

5. Bouton de téléchargement

Chaque onglet affiche son propre bouton de téléchargement :

• Windows : 📥 Télécharger les fichiers Windows
• Linux : 📥 Télécharger les fichiers Linux
• macOS : 📥 Télécharger les fichiers macOS

Lorsque vous cliquez sur un bouton :

• Le bouton affiche un spinner de chargement
• Le bouton est désactivé pendant le téléchargement
• Les fichiers sont téléchargés automatiquement
• Un message de succès apparaît en haut à droite avec les instructions spécifiques

Processus de téléchargement

Déroulement automatique

Lorsque vous cliquez sur un bouton de téléchargement, le système :

1. Vérifie que votre parc est bien configuré
2. Génère les fichiers de configuration personnalisés pour votre parc
3. Télécharge les fichiers spécifiques :

Windows (4 fichiers)

• zabbix_agentd.conf (configuration)
• zabbix_agentd.psk (clé de sécurité)
• install_zabbix_VOTRE_PARC.bat (script d'installation)
• agent_logiserv.msi (installeur version 7.2.13)

Linux (3 fichiers)

• zabbix_agentd.conf (configuration)
• zabbix_agentd.psk (clé de sécurité)
• install_zabbix_VOTRE_PARC.sh (script bash avec détection de distribution)

macOS (3 fichiers)

• zabbix_agentd.conf (configuration)
• zabbix_agentd.psk (clé de sécurité)
• install_zabbix_VOTRE_PARC.sh (script bash avec détection d'architecture)

Notifications

Vous recevez une notification toast en haut à droite selon l'OS :

• Windows : "Fichiers Windows pour 'VOTRE_PARC' téléchargés ! N'oubliez pas d'exécuter le script en administrateur."
• Linux : "Fichiers Linux pour 'VOTRE_PARC' téléchargés ! Exécutez avec : sudo bash install_zabbix_*.sh"
• macOS : "Fichiers macOS pour 'VOTRE_PARC' téléchargés ! Exécutez avec : bash install_zabbix_*.sh"
• Erreur : Message explicite si le téléchargement échoue (parc non configuré, erreur serveur)

Installation sur la machine

Installation Windows

Étape 1 : Préparer les fichiers

1. Créez un dossier temporaire (ex: C:\Temp\Logiserv)
2. Copiez les 4 fichiers téléchargés dans ce dossier
3. Vérifiez que tous les fichiers sont présents

Étape 2 : Lancer l'installation

1. Localisez install_zabbix_VOTRE_PARC.bat
2. Clic droit → "Exécuter en tant qu'administrateur"
3. Confirmez l'élévation de privilèges

Étape 3 : Vérification

Le script s'exécute automatiquement et :

• Vérifie vos privilèges administrateur
• Installe l'agent MSI
• Configure l'agent avec vos paramètres
• Démarre le service Windows automatiquement

Installation Linux

Étape 1 : Transférer les fichiers

1. Utilisez SCP, SFTP ou autre pour transférer les 3 fichiers sur votre serveur
2. Placez-les dans un dossier temporaire (ex: /tmp/logiserv)

Étape 2 : Rendre le script exécutable

chmod +x install_zabbix_*.sh

Étape 3 : Exécuter l'installation

sudo bash install_zabbix_VOTRE_PARC.sh

Étape 4 : Vérification

Le script :

• Détecte automatiquement votre distribution (Debian, Ubuntu, RHEL, CentOS, Rocky, AlmaLinux)
• Installe les dépendances nécessaires
• Télécharge et installe l'agent Zabbix
• Configure l'agent avec vos paramètres
• Démarre le service zabbix-agent

Commandes utiles après installation :

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

Installation macOS

Étape 1 : Ouvrir Terminal

1. Ouvrez Terminal (Applications → Utilitaires → Terminal)
2. Naviguez vers le dossier de téléchargement :

cd ~/Downloads

Étape 2 : Rendre le script exécutable

chmod +x install_zabbix_*.sh

Étape 3 : Exécuter l'installation

bash install_zabbix_VOTRE_PARC.sh

Entrez votre mot de passe administrateur quand demandé.

Étape 4 : Vérification

Le script :

• Détecte votre architecture (Apple Silicon M1/M2/M3 ou Intel x86_64)
• Télécharge le PKG Zabbix adapté
• Installe l'agent
• Configure l'agent avec vos paramètres
• 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
 
# Arrêter l'agent
sudo launchctl unload /Library/LaunchDaemons/com.zabbix.zabbix_agentd.plist
 
# Démarrer l'agent
sudo launchctl load /Library/LaunchDaemons/com.zabbix.zabbix_agentd.plist

Vérification finale (tous les OS)

Une fois l'installation terminée :

• Le service de surveillance est actif
• Votre machine commence à envoyer des métriques
• Attendez 2-3 minutes
• Vérifiez l'apparition de la machine dans Tableau de bord

Messages d'erreur possibles

⚠️ Nom de parc non trouvé

Message affiché : "Aucun nom de parc n'est associé à votre compte utilisateur. Veuillez mettre à jour vos informations de profil."

Solution :

1. Accédez à vos Paramètres
2. Remplissez le champ "Parc"
3. Enregistrez les modifications
4. Revenez sur la page Agent

❌ Erreur lors de la génération des fichiers

Cause possible : Problème temporaire de la machine

Solution :

1. Rafraîchissez la page (F5)
2. Réessayez le téléchargement
3. Si le problème persiste, contactez le support

🔒 Privilèges administrateur requis

Message dans le script : "ERREUR: Privilèges administrateur requis!"

Solution :

1. Fermez la fenêtre de script
2. Localisez à nouveau le fichier .bat
3. Clic droit → "Exécuter en tant qu'administrateur" (ne pas double-cliquer)

Comportement selon le rôle

👤 Utilisateur standard (USER)

En tant qu'utilisateur standard, vous pouvez :

• ✅ Voir la page Agent
• ✅ Télécharger les fichiers de configuration
• ✅ Installer l'agent sur les machines (si vous avez les droits administrateur système)

👑 Administrateur (ADMIN)

En tant qu'administrateur, vous avez les mêmes accès qu'un utilisateur standard pour cette page. Les privilèges ADMIN concernent principalement la gestion de l'équipe et des fonctionnalités avancées (alertes manuelles, rapports, etc.).

Sécurité et confidentialité

Fichiers générés

Les fichiers de configuration sont générés dynamiquement pour votre parc :

• Configuration unique : Chaque téléchargement génère une nouvelle configuration
• Clé de sécurité : Le fichier .psk contient une clé de chiffrement unique pour sécuriser les communications
• Pas de données sensibles : Les fichiers ne contiennent que des paramètres de connexion

Communications chiffrées

Une fois l'agent installé :

• Toutes les communications entre votre machine et la plateforme Logiserv sont chiffrées
• La clé PSK garantit que seuls vos machines autorisés peuvent envoyer des données
• Aucune donnée n'est transmise en clair sur Internet

Fonctionnement après installation

Collecte automatique

L'agent installé collecte automatiquement :

• Performances CPU : Utilisation par cœur et globale
• Mémoire RAM : Utilisation, disponibilité
• Espace disque : Occupation, vitesse de lecture/écriture
• Réseau : Trafic entrant et sortant
• Services Windows : État des services critiques

Visualisation des données

Une fois l'agent actif, vous pouvez consulter les données :

• Tableau de bord : Vue d'ensemble de tous vos machines (Tableau)
• Temps réel : Graphiques en direct (Plan Business, Temps réel)
• Statistiques : Historiques et tendances (Statistiques)
• Alertes : Notifications en cas de problème (Alertes)

Fréquence de mise à jour

Les métriques sont collectées et mises à jour :

• Toutes les 30 secondes pour les métriques temps réel (CPU, RAM, réseau)
• Toutes les 5 minutes pour les métriques moins volatiles (espace disque, services)

Affichage responsive

La page s'adapte à votre écran :

🖥️ Ordinateur (desktop)

• Carte centrée avec largeur optimale
• Instructions complètes visibles
• Bouton de téléchargement en bas à gauche

📱 Tablette

• Mise en page identique mais adaptée à la largeur
• Instructions déroulantes si nécessaire
• Bouton pleine largeur pour faciliter le clic

📱 Mobile

• Carte occupant toute la largeur
• Instructions empilées verticalement
• Bouton pleine largeur
• Texte adapté pour la lecture sur petit écran

Dépannage

Le bouton ne répond pas

Vérifications :

1. Votre navigateur autorise-t-il les téléchargements multiples ?
2. Avez-vous un bloqueur de popup activé ?
3. Votre connexion Internet est-elle stable ?

Solution : Désactivez temporairement le bloqueur de popup pour le site Logiserv et réessayez.

Fichiers téléchargés incomplets

Symptôme : Moins de 4 fichiers téléchargés

Solution :

1. Vérifiez votre dossier Téléchargements
2. Supprimez les fichiers partiels
3. Réessayez le téléchargement

L'installation échoue sur la machine

Windows

Causes possibles :

• Fichiers manquants dans le dossier d'installation
• Antivirus bloquant le script
• Droits administrateur insuffisants

Solutions :

1. Placez tous les fichiers dans le même dossier
2. Désactivez temporairement l'antivirus
3. Vérifiez que vous lancez bien le script en tant qu'administrateur

Linux

Causes possibles :

• Distribution non supportée
• Dépendances manquantes
• Droits sudo insuffisants
• Problèmes de dépôts (repository)

Solutions :

1. Vérifiez votre distribution : cat /etc/os-release
2. Mettez à jour les dépôts : sudo apt update ou sudo yum update
3. Vérifiez les logs : cat /var/log/zabbix/zabbix_agentd.log
4. Exécutez bien avec sudo

macOS

Causes possibles :

• Gatekeeper bloquant l'installation
• Droits insuffisants
• Architecture non détectée correctement

Solutions :

1. Autorisez l'exécution : Préférences Système → Sécurité
2. Vérifiez votre architecture : uname -m
3. Consultez les logs : tail -f /var/log/zabbix/zabbix_agentd.log
4. Redémarrez le service manuellement

La machine n'apparaît pas dans le tableau de bord

Délai normal : Attendez 2-3 minutes après l'installation

Si la machine n'apparaît toujours pas, vérifiez selon votre OS :

Windows

1. Vérifiez le service : services.msc → Cherchez "Zabbix Agent"
2. Vérifiez les logs : C:\Program Files\Zabbix Agent\zabbix_agentd.log
3. Vérifiez le pare-feu Windows (port 10050)

Linux

1. Vérifiez le service : sudo systemctl status zabbix-agent
2. Vérifiez les logs : journalctl -u zabbix-agent -n 50
3. Vérifiez le pare-feu : sudo firewall-cmd --list-all ou sudo ufw status
4. Redémarrez si nécessaire : sudo systemctl restart zabbix-agent

macOS

1. Vérifiez le service : sudo launchctl list | grep zabbix
2. Vérifiez les logs : tail -f /var/log/zabbix/zabbix_agentd.log
3. Vérifiez les permissions : ls -la /usr/local/etc/zabbix/
4. Redémarrez manuellement si nécessaire

Problèmes réseau communs à tous les OS :

• Vérifiez que le port 10050 (TCP) est ouvert
• Vérifiez la connectivité réseau vers le serveur Logiserv
• Vérifiez que la clé PSK est correctement installée

Cas d'usage typiques

Nouvelle machine

Situation : Vous venez d'ajouter une nouvelle machine à votre parc

Procédure :

1. Accédez à la page Agent et sélectionnez l'onglet de votre OS
2. Téléchargez les fichiers
3. Transférez les fichiers sur la nouvelle machine
4. Exécutez le script d'installation avec les privilèges appropriés
5. Vérifiez l'apparition de la machine dans le tableau de bord

Réinstallation

Situation : L'agent a été désinstallé ou ne fonctionne plus correctement

Procédure :

1. Désinstallez complètement l'ancien agent :
   • Windows : Panneau de configuration → Désinstaller un programme
   • Linux : sudo apt/yum/dnf remove zabbix-agent
   • macOS : sudo launchctl unload puis suppression manuelle
2. Re-téléchargez les fichiers (nouvelles clés PSK générées)
3. Réinstallez avec le nouveau script
4. La machine réapparaît dans votre tableau de bord

Installation groupée (infrastructure mixte)

Situation : Vous devez installer l'agent sur plusieurs machines de différents OS

Procédure :

1. Téléchargez les fichiers pour chaque OS depuis les onglets respectifs
2. Organisez les fichiers par OS dans des dossiers séparés
3. Déployez sur chaque machine selon son OS
4. Toutes les machines partageront la même configuration de parc (même PSK)

Note : Les fichiers téléchargés peuvent être réutilisés pour plusieurs machines du même parc, même si elles utilisent des OS différents.

Distributions et versions supportées

Windows

• Windows Server 2012 R2 et supérieur
• Windows Server 2016, 2019, 2022
• Windows 10, 11 (toutes éditions)
• Architecture : x64 (64 bits)

Linux

Debian/Ubuntu :

• Debian 11 (Bullseye)
• Debian 12 (Bookworm)
• Ubuntu 22.04 LTS (Jammy)
• Ubuntu 24.04 LTS (Noble)

RHEL/CentOS/Rocky/AlmaLinux :

• RHEL 8, 9
• CentOS Stream 8, 9
• Rocky Linux 8, 9
• AlmaLinux 8, 9

Architecture : x86_64 (64 bits)

macOS

• macOS 11 Big Sur
• macOS 12 Monterey
• macOS 13 Ventura
• macOS 14 Sonoma
• macOS 15 Sequoia
• Architecture : Apple Silicon (M1/M2/M3/M4) et Intel x86_64

Bonnes pratiques

Organisation des fichiers

• ✅ Conservez une copie des fichiers téléchargés dans un dossier sécurisé
• ✅ Notez la date de téléchargement pour tracer vos installations
• ✅ Supprimez les anciens fichiers après une nouvelle génération

Sécurité

• ✅ Ne partagez jamais vos fichiers de configuration avec d'autres parcs
• ✅ Lancez toujours le script en administrateur
• ✅ Vérifiez que l'installation s'est bien déroulée avant de supprimer les fichiers

Maintenance

• ✅ Vérifiez régulièrement que vos machines envoient bien des données
• ✅ Consultez les alertes pour détecter d'éventuels problèmes de connexion
• ✅ Re-téléchargez les fichiers si vous changez de parc ou de configuration

Informations techniques avancées

Ports et protocoles

L'agent utilise les ports suivants :

• Port 10050 (TCP) : Communication agent → serveur (mode passif)
• Port 10051 (TCP) : Communication serveur → agent (mode actif, optionnel)

Tous les échanges sont chiffrés via PSK (Pre-Shared Key).

Fichiers de configuration

Les fichiers sont placés selon l'OS :

• Windows : C:\Program Files\Zabbix Agent\
• Linux : /etc/zabbix/ (configuration) + /var/log/zabbix/ (logs)
• macOS : /usr/local/etc/zabbix/ (configuration) + /var/log/zabbix/ (logs)

Métriques collectées automatiquement

L'agent collecte nativement :

• 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
• Processus : Nombre de processus, processus spécifiques
• Services : État des services système (Windows services, systemd units, launchd services)

Pour aller plus loin

• Configuration du parc - Gérer vos machines surveillées
• Tableau de bord - Visualiser vos métriques en temps réel
• Alertes - Configurer les notifications

L'installation de l'agent est la première étape essentielle pour surveiller vos machines avec Logiserv. Que vous utilisiez Windows, Linux ou macOS, l'installation est automatisée et sécurisée. Une fois installé, votre machine commence immédiatement à envoyer des métriques et vous pouvez profiter de toutes les fonctionnalités de surveillance en temps réel.