Installer Zabbix Agent sur SLES et openSUSE Leap : guide complet

Superviser un serveur SUSE avec Zabbix passe par l'installation d'un agent sur le système : un service léger qui collecte les métriques système et les transmet au serveur de supervision. Voir la définition complète de l'agent Zabbix.

Ce guide couvre l'installation manuelle et complète sur SUSE Linux Enterprise Server (SLES) 15 et 16 ainsi que sur openSUSE Leap, qui partage la même base et les mêmes paquets.

Le plus simple : avec Logiserv

Logiserv s'appuie sur ce même moteur Zabbix et automatise l'ensemble. Depuis la page Agent du tableau de bord :

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

Le script reconnaît SLES et openSUSE Leap via /etc/os-release, ajoute le dépôt correspondant à la version majeure, importe la clé GPG, installe le paquet avec zypper, génère une clé PSK unique, écrit la configuration, crée l'hôte côté serveur dans le groupe de votre parc avec les bons templates et démarre le service.

Comptez 1 à 2 minutes par système avec Logiserv. L'installation manuelle détaillée ci-dessous demande 6 étapes et une douzaine de minutes par serveur, sans compter la création de l'hôte côté serveur Zabbix. Voir la comparaison détaillée.

SLES, openSUSE Leap, Tumbleweed : quels paquets ?

Le dépôt Zabbix publie des paquets par version majeure de SLES :

Agent 2 est recommandé pour une nouvelle installation : plugins intégrés, connexion persistante unique, empreinte mémoire réduite. Ce guide l'utilise ; pour Agent 1, remplacez agent2 par agent dans les commandes et zabbix_agent2.conf par zabbix_agentd.conf.

Prérequis

• un accès root : sur SUSE, sudo demande par défaut le mot de passe de root et non celui de l'utilisateur
• l'adresse IP ou le nom DNS de votre serveur Zabbix
• un accès sortant vers le port 10051/TCP du serveur
• sur SLES, un système enregistré (SUSEConnect) pour accéder aux dépendances des modules de base

Étape 1 : ajouter le dépôt officiel Zabbix

Pour SLES 15 et openSUSE Leap 15 :

sudo rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/7.4/release/sles/15/noarch/zabbix-release-latest.sles15.noarch.rpm
sudo zypper --gpg-auto-import-keys refresh

Pour SLES 16, remplacez les deux 15 par 16.

Version automatique :

. /etc/os-release
MAJOR=$(echo "$VERSION_ID" | cut -d. -f1)
sudo rpm -Uvh --nosignature "https://repo.zabbix.com/zabbix/7.4/release/sles/${MAJOR}/noarch/zabbix-release-latest.sles${MAJOR}.noarch.rpm"
sudo zypper --gpg-auto-import-keys refresh

Étape 2 : installer l'agent

sudo zypper install -y zabbix-agent2

Vérifiez que le paquet provient bien du dépôt Zabbix et non de la distribution :

zypper info zabbix-agent2 | grep -E "Version|Repository"

Le paquet crée l'utilisateur système zabbix, installe l'unité systemd et dépose la configuration dans /etc/zabbix/.

Étape 3 : configurer l'agent

sudo vi /etc/zabbix/zabbix_agent2.conf

Les directives essentielles :

# Serveur autorisé à interroger cet agent (mode passif)
Server=192.168.1.10
 
# Serveur vers lequel l'agent pousse ses métriques (mode actif)
ServerActive=192.168.1.10
 
# Doit correspondre EXACTEMENT au nom d'hôte défini côté serveur Zabbix
Hostname=srv-sap-01
 
LogFile=/var/log/zabbix/zabbix_agent2.log
LogFileSize=10

Le piège du Hostname

Hostname doit être strictement identique au champ « Nom d'hôte » de l'hôte côté serveur. Une casse différente et les vérifications actives ne remontent jamais, sans erreur explicite.

Mode actif ou passif

• Passif (Server=) : le serveur interroge l'agent sur le port 10050.
• Actif (ServerActive=) : l'agent pousse ses données, aucun port entrant à ouvrir. À privilégier pour les systèmes distants.

Étape 4 : chiffrer la liaison avec une clé PSK

openssl rand -hex 32 | sudo tee /etc/zabbix/zabbix_agent2.psk > /dev/null
sudo chown zabbix:zabbix /etc/zabbix/zabbix_agent2.psk
sudo chmod 600 /etc/zabbix/zabbix_agent2.psk

Puis dans la configuration :

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

Reportez la clé et l'identité dans l'onglet Chiffrement de l'hôte côté serveur. Une identité distincte par système est nécessaire.

Étape 5 : ouvrir le port dans firewalld

Uniquement en mode passif. SLES et openSUSE Leap utilisent firewalld ; restreignez l'accès à l'adresse du serveur Zabbix :

sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.1.10" port port="10050" protocol="tcp" accept'
sudo firewall-cmd --reload

En mode actif, aucune règle entrante n'est nécessaire.

AppArmor et SELinux

SLES 15 et openSUSE Leap 15 utilisent AppArmor, qui ne fournit pas de profil pour l'agent Zabbix : il n'est donc pas confiné et rien n'est à ajuster. SLES 16 passe à SELinux ; en cas de refus, le diagnostic est le même que sur la famille RHEL (ausearch -m AVC), décrit dans le guide Rocky Linux.

Étape 6 : démarrer et vérifier

sudo systemctl enable --now zabbix-agent2
sudo systemctl status zabbix-agent2

Testez des métriques localement :

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

Consultez le journal :

sudo tail -f /var/log/zabbix/zabbix_agent2.log

Messages d'erreur courants

SUSE écrit ses journaux système dans journald. Pour les métriques qui les lisent :

sudo usermod -aG systemd-journal zabbix
sudo systemctl restart zabbix-agent2

Superviser plusieurs serveurs SUSE

Sur un parc SLES, souvent dédié à des charges critiques comme SAP, la procédure manuelle devient coûteuse : dépôt, paquet, configuration, clé PSK unique, firewalld, création de l'hôte côté serveur. Les approches classiques sont SUSE Manager (ou Uyuni) avec ses états Salt, Ansible, AutoYaST au provisionnement, ou l'auto-enregistrement Zabbix.

La même installation avec Logiserv

Logiserv s'appuie sur ce même moteur Zabbix et automatise l'ensemble. Depuis la page Agent du tableau de bord :

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

Le script reconnaît SLES et openSUSE Leap via /etc/os-release, ajoute le dépôt correspondant à la version majeure, importe la clé GPG, installe le paquet avec zypper, génère une clé PSK unique, écrit la configuration, crée l'hôte côté serveur dans le groupe de votre parc avec les bons templates et démarre le service.

Installation manuelle ou Logiserv

Versions reconnues

SLES 15/16, openSUSE Leap

Détection automatique via /etc/os-release, dépôt choisi selon la version majeure.

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.

Sauvegarde de configuration

Automatique

Toute configuration existante est copiée en .bak horodaté avant réécriture.

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

Pour aller plus loin

• Installer Zabbix Agent 2 : le guide par système — vue d'ensemble et autres OS
• Installer Zabbix Agent sur Rocky Linux — la famille RHEL, également en RPM
• Installer Zabbix Agent sur Debian — la famille Debian
• Pourquoi superviser un serveur Linux — ce que la supervision détecte avant l'incident
• Quelles métriques surveiller sur un serveur — construire son plan de supervision