Service
Installer l'agent sous Linux

Installer l'agent sous Linux

Installez l'agent de supervision Logiserv sur un serveur Linux (Debian, Ubuntu, RHEL, Rocky, AlmaLinux, Amazon Linux, SUSE) en une commande, vérifiez la remontée des données et dépannez l'installation.

Vue d'ensemble

L'agent est le service qui collecte les mesures de votre serveur Linux (processeur, mémoire, disques, interfaces réseau, services) et les transmet au serveur de supervision Logiserv. Sous Linux, Logiserv installe le paquet officiel zabbix-agent depuis les dépôts Zabbix, déjà configuré pour votre parc.

Une seule commande suffit : le script détecte votre distribution, ajoute le dépôt Zabbix, installe le paquet, enregistre le serveur dans votre parc et démarre le service. Comptez deux à trois minutes.

🐧 Distributions prises en charge

  • Debian et Ubuntu, ainsi que Raspberry Pi OS
  • RHEL, Rocky Linux, AlmaLinux et Oracle Linux
  • Amazon Linux 2 et Amazon Linux 2023
  • SLES et openSUSE Leap

Le script s'appuie sur le gestionnaire de paquets de la distribution : apt, dnf, yum ou zypper.

✅ Avant de commencer

  • Un abonnement actif (ou une période d'essai) sur votre compte Logiserv.
  • Un parc renseigné dans votre profil.
  • Un accès root, directement ou via sudo.
  • Un accès sortant vers zabbix.logiserv.re sur le port 10051/TCP, et vers les dépôts de paquets Zabbix et de votre distribution en HTTPS.

L'agent fonctionne uniquement en mode actif : il ne se met à l'écoute sur aucun port. Inutile d'ouvrir le port 10050 ou de toucher à iptables, firewalld ou ufw.

🚀 Installation pas à pas

Ouvrir la page Agent

Dans votre tableau de bord, ouvrez la page Agents et choisissez l'onglet Linux.

Si votre parc compte des clients (offre Business), sélectionnez d'abord le client auquel appartient le serveur.

Copier la commande

Cliquez sur Copier. Le lien généré est personnel, lié à votre parc et valable une heure. Ne le collez pas dans un dépôt Git, un ticket ou un canal de discussion partagé.

Lancer la commande sur le serveur

Connectez-vous au serveur en SSH, collez la commande, de la forme suivante, et appuyez sur Entrée :

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

Sur une image minimale sans curl, installez-le d'abord (apt install curl ou dnf install curl).

Le script se termine par un message confirmant que le service zabbix-agent est actif.

🔍 Vérifier que tout fonctionne

Vérifiez l'état du service :

systemctl status zabbix-agent

La ligne Active doit indiquer active (running). Le service est activé au démarrage : il repartira tout seul après un redémarrage du serveur.

Le serveur apparaît ensuite dans la page Parc sous son nom d'hôte, en quelques minutes. Les valeurs instantanées arrivent tout de suite. Les graphiques sur plusieurs jours se remplissent au bout d'environ une heure, le temps que la première moyenne horaire soit calculée.

Un hôte de virtualisation KVM/libvirt est reconnu automatiquement et enregistré comme hyperviseur.

🛠️ Problèmes fréquents

« Le lien a expiré » ou erreur 401

Le lien n'est valable qu'une heure. Copiez une nouvelle commande sur la page Agents et relancez-la.

Le paquet ne s'installe pas

Le serveur doit pouvoir joindre les dépôts Zabbix en HTTPS. Derrière un proxy, exportez https_proxy avant de lancer la commande, et vérifiez que apt ou dnf fonctionnent pour un autre paquet.

Sur RHEL et ses dérivées, le dépôt EPEL fournit lui aussi un paquet zabbix-agent. Le script exclut automatiquement les paquets Zabbix d'EPEL pour utiliser ceux du dépôt officiel.

Le serveur n'apparaît pas dans le parc

Testez l'accès au serveur de supervision :

timeout 5 bash -c '</dev/tcp/zabbix.logiserv.re/10051' && echo OK

Sans OK, un pare-feu filtre le trafic sortant : autorisez zabbix.logiserv.re, port 10051/TCP, en sortie.

Consultez ensuite le journal de l'agent :

sudo tail -n 50 /var/log/zabbix/zabbix_agentd.log

Le journal mentionne une erreur TLS ou PSK

La clé de chiffrement locale ne correspond plus à l'enregistrement du serveur, souvent après une modification manuelle de /etc/zabbix/zabbix_agentd.conf. Relancez la commande depuis la page Agents : le script réécrit la configuration et la clé.

🔄 Mettre à jour ou réinstaller

Relancez la commande de la page Agents. Le script remplace l'installation existante par la version courante et conserve la machine au même endroit dans votre parc.

Évitez de modifier la configuration de l'agent à la main : elle est réécrite à chaque réinstallation, et une erreur de paramètre suffit à couper la remontée des données.

📚 Pour aller plus loin

Partagez ce lien