Installer Zabbix Agent 2 sur Ubuntu 24.04 et 22.04 en 10 min

Pour superviser un serveur Ubuntu avec Zabbix, il faut y installer un agent : un service léger qui collecte les métriques système — charge processeur, mémoire, remplissage des systèmes de fichiers, services actifs, journaux — 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 Ubuntu Server 20.04 LTS, 22.04 LTS et 24.04 LTS. La procédure fonctionne 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, une commande est générée pour votre parc :

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

Le script détecte la distribution, ajoute le dépôt, installe le paquet, génère une clé PSK unique pour le système, écrit la configuration, crée l'hôte côté serveur avec les bons templates, ajuste les permissions nécessaires aux métriques 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 6 étapes et 10 minutes environ par serveur, sans compter la création de l'hôte côté serveur Zabbix. Voir la comparaison détaillée.

Agent 1 ou Agent 2 ?

Deux paquets coexistent dans le dépôt officiel :

• zabbix-agent — l'agent historique écrit en C, fichier de configuration zabbix_agentd.conf
• zabbix-agent2 — la version actuelle écrite en Go, fichier zabbix_agent2.conf

Agent 2 est recommandé pour toute nouvelle installation : plugins intégrés (PostgreSQL, MySQL, Docker, Redis…), une seule connexion persistante au serveur, empreinte mémoire moindre. Ce guide utilise Agent 2 ; les commandes pour Agent 1 sont identiques en remplaçant agent2 par agent partout.

Prérequis

• un accès sudo sur le système
• l'adresse IP ou le nom DNS de votre serveur Zabbix
• un accès réseau sortant vers le port 10051/TCP du serveur

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

Le nom du paquet zabbix-release intègre la version d'Ubuntu. Pour Ubuntu 24.04 :

wget https://repo.zabbix.com/zabbix/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
sudo dpkg -i zabbix-release_latest+ubuntu24.04_all.deb
sudo apt update

Pour Ubuntu 22.04, remplacez ubuntu24.04 par ubuntu22.04 ; pour 20.04, par ubuntu20.04.

Version automatique, quelle que soit la release :

. /etc/os-release
wget -qO /tmp/zabbix-release.deb \
  "https://repo.zabbix.com/zabbix/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu${VERSION_ID}_all.deb"
sudo dpkg -i /tmp/zabbix-release.deb
sudo apt update

Étape 2 : installer l'agent

sudo apt install -y zabbix-agent2

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

Pour installer également les plugins optionnels (PostgreSQL, MongoDB, MSSQL) :

sudo apt install -y zabbix-agent2-plugin-*

Étape 3 : configurer l'agent

Éditez /etc/zabbix/zabbix_agent2.conf :

sudo nano /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-web-01
 
LogFile=/var/log/zabbix/zabbix_agent2.log
LogFileSize=10

Le piège du Hostname

La valeur de Hostname doit être strictement identique au champ « Nom d'hôte » de l'hôte créé dans l'interface Zabbix. Une différence de casse suffit à ce que les vérifications actives ne remontent jamais, sans erreur explicite côté serveur.

Pour reprendre automatiquement le nom du système :

HostnameItem=system.hostname

Mode actif ou passif

• Passif (Server=) : le serveur interroge l'agent, qui doit être joignable sur le port 10050. Problématique derrière un NAT.
• Actif (ServerActive=) : l'agent pousse ses données. Aucun port entrant à ouvrir — à privilégier pour des systèmes distants ou en cloud.

Les deux modes peuvent cohabiter.

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

Sans chiffrement, les métriques transitent en clair. Générez une clé de 32 octets :

sudo mkdir -p /etc/zabbix
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

Complétez la configuration :

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

Reportez la même clé et la même identité dans l'onglet Chiffrement de l'hôte côté serveur. Utilisez une identité distincte par système : une clé partagée compromise expose tout le parc.

Étape 5 : ouvrir le port dans le pare-feu

Uniquement en mode passif. Avec UFW :

sudo ufw allow from 192.168.1.10 to any port 10050 proto tcp

Restreindre à l'adresse du serveur Zabbix évite d'exposer l'agent à tout le réseau. En mode actif, aucune règle entrante n'est nécessaire.

Étape 6 : démarrer et vérifier

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

Testez une métrique localement, sans passer par le serveur :

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

Une réponse du type system.cpu.load[all,avg1] [d|0.080000] confirme la collecte.

Consultez le journal :

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

Messages d'erreur courants

Sur ce dernier point, certaines métriques de sécurité nécessitent l'accès aux journaux système :

sudo usermod -aG adm zabbix
sudo systemctl restart zabbix-agent2

Superviser plusieurs serveurs Ubuntu

Répétée sur vingt systèmes, cette procédure devient coûteuse : dépôt, paquet, configuration, clé PSK unique, création de l'hôte côté serveur, report de la clé. Comptez dix minutes par serveur, avec autant d'occasions de divergence.

Les approches classiques : Ansible ou un outil de configuration équivalent (robuste, mais playbooks et coffre à secrets à maintenir), cloud-init au provisionnement, ou l'auto-enregistrement Zabbix avec des actions et métadonnées d'hôte configurées côté serveur.

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, une commande est générée pour votre parc :

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

Le script détecte la distribution, ajoute le dépôt, installe le paquet, génère une clé PSK unique pour le système, écrit la configuration, crée l'hôte côté serveur avec les bons templates, ajuste les permissions nécessaires aux métriques de sécurité et démarre le service.

Installation manuelle ou Logiserv

Distributions reconnues

Ubuntu, Debian, Raspberry Pi OS, RHEL, Rocky, AlmaLinux, Amazon Linux, SLES

La distribution est détectée automatiquement via /etc/os-release.

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.

Permissions journaux

Configurées automatiquement

L'utilisateur zabbix est ajouté aux groupes adm et shadow 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 Debian — les différences avec Ubuntu
• Installer Zabbix Agent sur Rocky Linux et AlmaLinux — la famille RHEL
• Pourquoi superviser un serveur Linux — ce que la supervision détecte avant l'incident
• Surveiller l'espace disque d'un serveur — la panne la plus fréquente et la plus évitable
• Supervision serveur Windows et Linux : le guide — la démarche complète