Installer Zabbix Agent sur AlmaLinux 8 et 9 : guide complet

Superviser un serveur AlmaLinux 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 AlmaLinux 8 et 9, avec n'importe quel serveur Zabbix.

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 détecte la famille Enterprise Linux via /etc/os-release, ajoute le dépôt el8 ou el9 correspondant, installe le paquet, génère une clé PSK unique, écrit la configuration, crée l'hôte côté serveur avec les templates adaptés, pose les ACL nécessaires aux contrôles de sécurité et démarre le service.

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

AlmaLinux, Rocky Linux, RHEL : quelle différence pour l'agent ?

Aucune, du point de vue de l'installation. AlmaLinux vise une compatibilité binaire 1:1 avec Red Hat Enterprise Linux ; Rocky Linux poursuit le même objectif. Le dépôt Zabbix ne publie pas de paquets distincts par distribution : il publie des RPM el8 et el9, valables pour AlmaLinux, Rocky Linux, RHEL, CentOS Stream et Oracle Linux.

Seule la version majeure compte pour choisir le bon dépôt. Ce qui distingue ces distributions — gouvernance, modèle de support, politique de mise à jour — n'a pas d'incidence sur la procédure ci-dessous.

Agent 1 ou Agent 2 ?

Le dépôt fournit zabbix-agent (agent historique en C) et zabbix-agent2 (version actuelle en Go). Agent 2 est recommandé : 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 chemins.

Prérequis

• un accès root ou sudo
• l'adresse IP ou le nom DNS de votre serveur Zabbix
• un accès sortant vers le port 10051/TCP du serveur

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

Pour AlmaLinux 9 :

sudo rpm -Uvh https://repo.zabbix.com/zabbix/7.4/release/rhel/9/noarch/zabbix-release-latest.el9.noarch.rpm
sudo dnf clean all

Pour AlmaLinux 8, remplacez les deux 9 par 8.

Version automatique :

. /etc/os-release
MAJOR=$(echo "$VERSION_ID" | cut -d. -f1)
sudo rpm -Uvh "https://repo.zabbix.com/zabbix/7.4/release/rhel/${MAJOR}/noarch/zabbix-release-latest.el${MAJOR}.noarch.rpm"
sudo dnf clean all

Étape 2 : installer l'agent

sudo dnf install -y zabbix-agent2

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

Plugins optionnels :

sudo dnf install -y zabbix-agent2-plugin-postgresql zabbix-agent2-plugin-mongodb

Étape 3 : configurer l'agent

sudo vi /etc/zabbix/zabbix_agent2.conf

# 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-app-02
 
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.

Pour reprendre le nom du système :

HostnameItem=system.hostname

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

TLSConnect=psk
TLSAccept=psk
TLSPSKIdentity=PSK-srv-app-02
TLSPSKFile=/etc/zabbix/zabbix_agent2.psk

Reportez clé et identité dans l'onglet Chiffrement de l'hôte côté serveur, avec une identité distincte par système.

Étape 5 : ouvrir le port dans firewalld

Uniquement en mode passif :

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

firewalld connaît aussi un service prédéfini, plus permissif car ouvert à toute la zone :

sudo firewall-cmd --permanent --add-service=zabbix-agent
sudo firewall-cmd --reload

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

Étape 6 : composer avec SELinux

AlmaLinux active SELinux en mode enforcing par défaut. C'est la principale différence avec les distributions Debian.

getenforce

Après quelques minutes de fonctionnement, cherchez les refus concernant l'agent :

sudo ausearch -m AVC -ts recent | grep -i zabbix

Si nécessaire :

sudo setsebool -P zabbix_can_network on

Pour un cas non couvert par un booléen existant, générez un module ciblé :

sudo ausearch -c 'zabbix_agent2' --raw | audit2allow -M zabbix_agent2_local
sudo semodule -i zabbix_agent2_local.pp

Étape 7 : 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

Pour les métriques lisant les journaux système :

sudo usermod -aG shadow zabbix
sudo setfacl -m u:zabbix:r /var/log/secure /var/log/messages
sudo systemctl restart zabbix-agent2

Superviser plusieurs serveurs AlmaLinux

Sur un parc conséquent, la procédure manuelle devient coûteuse : dépôt, paquet, configuration, clé PSK unique, firewalld, SELinux, création de l'hôte côté serveur. Les approches classiques sont Ansible, Kickstart 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 détecte la famille Enterprise Linux via /etc/os-release, ajoute le dépôt el8 ou el9 correspondant, installe le paquet, génère une clé PSK unique, écrit la configuration, crée l'hôte côté serveur avec les templates adaptés, pose les ACL nécessaires aux contrôles de sécurité et démarre le service.

Installation manuelle ou Logiserv

Familles reconnues

RHEL, AlmaLinux, Rocky, Oracle Linux

La version majeure est extraite automatiquement pour choisir le dépôt el8 ou el9.

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.

Accès aux journaux

ACL posées automatiquement

setfacl sur /var/log/secure et /var/log/messages pour les contrôles de sécurité.

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 — distribution jumelle, mêmes paquets
• Installer Zabbix Agent sur Debian et Ubuntu — la famille Debian
• Installer Zabbix Agent sur Amazon Linux et SLES / openSUSE — les autres distributions RPM
• 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