Configuration et déploiement de l'agent Zabbix

L'agent Zabbix est le composant essentiel qui permet à notre plateforme Logiserv de surveiller vos serveurs en temps réel. Notre système automatise entièrement la génération et le déploiement des agents avec une configuration sécurisée par PSK.

Architecture de surveillance

graph TD
    A[Serveur Windows] --> B[Agent Zabbix]
    B --> C[Connexion PSK sécurisée]
    C --> D[Serveur Zabbix]
    D --> E[Logiserv Platform]
    E --> F[Tableau de bord temps réel]
    E --> G[Alertes IA]

Génération automatique des fichiers

Dans la section Agent de votre tableau de bord, notre système génère automatiquement trois fichiers essentiels :

1. Fichier de configuration (.conf)

# Exemple de configuration générée automatiquement
TLSConnect=psk
TLSAccept=psk
TLSPSKFile=C:\ProgramData\Zabbix\zabbix_agentd.psk
TLSPSKIdentity=PSKAUTOREGLOGISERV
HostMetadata=VOTRE_PARC
Server=zabbix.logiserv.re
ServerActive=zabbix.logiserv.re

2. Fichier PSK (.psk)

Le fichier PSK contient une clé de chiffrement unique qui sécurise la communication entre votre serveur et notre infrastructure de monitoring.

3. Script d'installation (.bat)

Notre script batch automatise entièrement l'installation :

@echo off
:: Script généré automatiquement par Logiserv
:: Vérification des privilèges administrateur
NET SESSION >nul 2>&1
if %ERRORLEVEL% neq 0 (
    echo ERREUR: Privilèges administrateur requis!
    pause
    exit 1
)
 
:: Installation de l'agent avec configuration personnalisée
msiexec.exe /i "zabbix_agent.msi" /qn /l*v "install.log"

Processus de déploiement sécurisé

Étape 1 : Génération personnalisée

Basé sur votre nom de parc configuré dans votre profil, le système génère :

// Code de génération automatique
interface ZabbixConfigData {
  confFileContent: string;      // Configuration de l'agent
  pskFileContent: string;       // Clé de chiffrement
  confFileName: string;         // zabbix_agentd.conf
  pskFileName: string;          // zabbix_agentd.psk
  installScriptContent: string; // Script d'installation
  installScriptFileName: string; // install_zabbix_[parc].bat
}

Étape 2 : Téléchargement sécurisé

Le système télécharge automatiquement :

• Fichier de configuration personnalisé pour votre parc
• Clé PSK unique pour la sécurisation
• Script d'installation automatisé
• Agent Zabbix MSI depuis les serveurs officiels

Étape 3 : Installation automatisée

Le script d'installation vérifie automatiquement :

1. Privilèges administrateur requis
2. Présence de tous les fichiers nécessaires
3. Création des répertoires système
4. Installation de l'agent avec votre configuration
5. Démarrage automatique du service

Fonctionnalités avancées du script

Vérification intelligente des fichiers

echo Verification du fichier zabbix_agentd.conf...
if exist "%SCRIPT_DIR%\zabbix_agentd.conf" (
    echo [OK] Fichier trouve
    set confFilePath=%SCRIPT_DIR%\zabbix_agentd.conf
) else (
    echo [ATTENTION] Fichier NON TROUVE
    :: Recherche avec variations de casse
    for %%F in ("zabbix_agentd.conf" "Zabbix_agentd.conf") do (
        if exist "%%F" (
            echo [INFO] Trouve un fichier similaire: %%~nxF
            echo Utiliser ce fichier? (O/N)
            set /p CHOIX="> "
            if /i "%CHOIX%"=="O" set confFilePath=%%F
        )
    )
)

Gestion d'erreurs complète

Le script gère automatiquement :

• Fichiers manquants avec suggestions de solution
• Problèmes de permissions avec messages explicites
• Échecs d'installation avec logs détaillés
• Intervention utilisateur minimale requise

Installation silencieuse

:: Installation avec journalisation complète
echo Lancement de l'installation...
msiexec.exe /i "%MSI_FILE_PATH%" /qn ^
    /l*v "C:\zabbix\logs\zabbix_install.log" ^
    NONMSICONFNAME="C:\ProgramData\Zabbix\zabbix_agentd.conf"
 
if %ERRORLEVEL% neq 0 (
    echo [ERREUR] Installation échouée avec le code %ERRORLEVEL%
    echo Consultez le fichier journal pour plus de détails
    pause
    exit %ERRORLEVEL%
)

Sécurité et chiffrement

Authentification PSK

Notre système utilise l'authentification Pre-Shared Key (PSK) qui offre :

• Chiffrement des communications agent-serveur
• Authentification mutuelle des deux parties
• Protection contre l'interception des données
• Clés uniques par installation

Configuration sécurisée

# Configuration de sécurité automatique
TLSConnect=psk
TLSAccept=psk
TLSPSKFile=C:\ProgramData\Zabbix\zabbix_agentd.psk
TLSPSKIdentity=PSKAUTOREGLOGISERV
 
# Métadonnées pour l'enregistrement automatique
HostMetadata=VOTRE_PARC_UNIQUE

Monitoring en temps réel

Une fois l'agent installé, il commence immédiatement à collecter :

Métriques système

• CPU : Utilisation par cœur et globale
• Mémoire : RAM utilisée, disponible, cache
• Disque : Espace libre, vitesse I/O, latence
• Réseau : Trafic entrant/sortant, erreurs

Services et processus

• Services Windows : État, mode de démarrage
• Processus critiques : Consommation ressources
• Logs système : Événements importants
• Performances applicatives : Temps de réponse

Métriques personnalisées

# Exemples de métriques custom
UserParameter=app.status,powershell "Get-Service MyApp"
UserParameter=db.connections,sqlcmd -Q "SELECT COUNT(*) FROM sys.dm_exec_connections"
UserParameter=custom.metric,C:\Scripts\check_custom.bat

Enregistrement automatique

Processus d'auto-découverte

Lors de la première connexion, l'agent :

1. Se connecte au serveur Zabbix avec ses identifiants PSK
2. Transmet ses métadonnées (nom du parc)
3. Déclenche l'enregistrement automatique dans votre compte Logiserv
4. Reçoit sa configuration de monitoring
5. Commence la collecte des métriques

Intégration plateforme

// Processus d'intégration automatique
export async function processAutoRegistration(hostMetadata: string) {
  // Identification du parc client
  const parcName = extractParcFromMetadata(hostMetadata);
  
  // Création/mise à jour du serveur dans Logiserv
  const server = await createOrUpdateServer({
    name: hostMetadata,
    parc: parcName,
    status: 'active',
    lastSeen: new Date()
  });
  
  // Configuration des alertes par défaut
  await setupDefaultAlerts(server.id);
  
  // Notification de l'utilisateur
  await notifyUserNewServer(server);
}

Maintenance et mise à jour

Logs et diagnostic

L'agent génère automatiquement :

• Logs d'installation : C:\zabbix\logs\zabbix_install.log
• Logs de fonctionnement : C:\ProgramData\Zabbix\zabbix_agentd.log
• Métriques de performance : Accessibles via l'interface

Mise à jour automatique

# Script de mise à jour
echo Vérification des mises à jour...
if "%CURRENT_VERSION%" LSS "%LATEST_VERSION%" (
    echo Nouvelle version disponible: %LATEST_VERSION%
    echo Téléchargement en cours...
    # Processus de mise à jour automatique
)

Dépannage courant

Agent non connecté

1. Vérifiez le service : services.msc → "Zabbix Agent"
2. Contrôlez les logs : C:\ProgramData\Zabbix\zabbix_agentd.log
3. Testez la connectivité : telnet zabbix.logiserv.re 10051

Problèmes de PSK

# Vérification de la configuration PSK
echo Vérification de la configuration PSK...
if not exist "C:\ProgramData\Zabbix\zabbix_agentd.psk" (
    echo [ERREUR] Fichier PSK manquant
    echo Régénérez les fichiers depuis votre tableau de bord
)

Métriques manquantes

1. Permissions insuffisantes : Vérifiez que le service s'exécute avec les bons droits
2. Firewall bloquant : Autorisez les ports 10050-10051
3. Configuration incorrecte : Régénérez les fichiers de configuration

Bonnes pratiques

Sécurité

• Utilisez toujours des connexions PSK chiffrées
• Limitez les permissions du service Zabbix
• Surveillez les logs régulièrement
• Mettez à jour l'agent périodiquement

Performance

• Ajustez les intervalles de collecte selon vos besoins
• Désactivez les métriques non utilisées
• Utilisez le cache pour les données statiques
• Monitorer la charge de l'agent lui-même

Monitoring

# Configuration optimisée
Timeout=10
StartAgents=5
ServerActive=zabbix.logiserv.re:10051
Hostname=VOTRE_SERVEUR
RefreshActiveChecks=60
UnsafeUserParameters=0

Conclusion

Le système d'agent Zabbix de Logiserv simplifie drastiquement le déploiement du monitoring sur vos serveurs. Avec la génération automatique des fichiers de configuration, l'installation en un clic et l'enregistrement automatique, vous pouvez surveiller vos infrastructures en quelques minutes.

Pour configurer vos premiers agents, rendez-vous dans la section Configuration Agent de votre tableau de bord.

Besoin d'aide pour l'installation ? Consultez notre documentation ou contactez notre équipe de support.