// travaux pratiques · Administration système
TP02 - Superviser un serveur Linux avec Zabbix agent 2
- TP 2 / 7
- 6 étapes
- ≈ 45 min
- Accès libre
Objectif : installer Zabbix agent 2 sur un serveur Linux, le déclarer dans Zabbix avec le modèle officiel Linux by Zabbix agent et lire ses premières métriques (CPU, mémoire, disques, réseau).
Contexte
Un serveur web, un serveur de fichiers ou un contrôleur de sauvegarde tombe rarement d’un coup : le disque se remplit, la charge monte, un service s’arrête. L’agent installé sur la machine collecte ces indicateurs de l’intérieur, bien plus finement qu’un simple test de disponibilité. C’est la première chose que l’on déploie sur chaque serveur Linux d’un parc.
Dans ce TP, vous travaillez en mode passif : c’est le serveur Zabbix qui interroge l’agent sur le port TCP 10050. À la fin, vous saurez installer et configurer l’agent, tester une clé en ligne de commande, créer un hôte, lui lier un modèle et lire les données dans Monitoring > Latest data.
Prérequis : TP01 terminé (serveur zbx-srv, 192.168.56.10) ; une seconde machine Debian 12 web01 (192.168.56.21) avec accès root et accès à repo.zabbix.com.
Durée estimée : 45 minutes.
Actions à réaliser
1. Ajouter le dépôt Zabbix sur web01
L’agent doit venir du même dépôt que le serveur pour rester dans la même branche 8.0 et recevoir les correctifs en même temps.
wget https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest_8.0+debian12_all.deb
dpkg -i zabbix-release_latest_8.0+debian12_all.deb
apt update
Résultat attendu : apt policy zabbix-agent2 propose une version 8.0 issue de repo.zabbix.com.
2. Installer l’agent 2
Zabbix agent 2 est la génération actuelle de l’agent, écrite en Go et extensible par greffons. Il collecte les mêmes métriques système que l’agent classique et ajoute des greffons pour Docker, MySQL, PostgreSQL ou les certificats web.
apt install -y zabbix-agent2
Résultat attendu : le fichier /etc/zabbix/zabbix_agent2.conf est présent et le service zabbix-agent2 est installé.
3. Configurer les trois directives essentielles
Éditez /etc/zabbix/zabbix_agent2.conf :
Server=192.168.56.10
ServerActive=192.168.56.10
Hostname=web01
Server liste les adresses (ou réseaux en notation CIDR) autorisées à interroger l’agent : toute autre source est refusée. ServerActive indique où l’agent récupère ses vérifications actives. Hostname doit correspondre exactement au nom technique de l’hôte dans Zabbix, sinon les vérifications actives sont rejetées.
zabbix_agent2 -T -c /etc/zabbix/zabbix_agent2.conf
systemctl restart zabbix-agent2
systemctl enable zabbix-agent2
L’option -T valide le fichier de configuration avant le redémarrage. Résultat attendu : pas d’erreur, puis service active (running).
4. Tester l’agent localement puis depuis le serveur
Avant de toucher à l’interface, on vérifie que l’agent répond. En local, l’option -t teste une clé et quitte ; l’option -p affiche toutes les clés connues.
zabbix_agent2 -t system.cpu.load[all,avg1]
Sur zbx-srv, installez l’utilitaire zabbix_get et interrogez l’agent à distance, exactement comme le fera le serveur :
apt install -y zabbix-get
zabbix_get -s 192.168.56.21 -p 10050 -k system.cpu.load[all,avg1]
Résultat attendu : une valeur numérique décimale (la charge moyenne sur une minute). Un message de refus signifie que l’IP du serveur ne figure pas dans Server.
5. Créer l’hôte dans Zabbix
Dans Data collection > Hosts, cliquez sur Create host et renseignez :
- Host name :
web01(identique à la directiveHostname) ; - Templates : Linux by Zabbix agent ;
- Host groups :
Linux servers; - Interfaces : ajoutez une interface Agent, IP
192.168.56.21, port10050.
Le modèle apporte d’un coup des dizaines d’éléments, de déclencheurs, de graphiques et des règles de découverte des systèmes de fichiers et des interfaces réseau.
6. Lire les données collectées
Ouvrez Monitoring > Latest data et filtrez sur l’hôte web01. Les premières valeurs arrivent en une à deux minutes ; les éléments issus de la découverte (un par système de fichiers, un par interface) apparaissent après le premier passage des règles de découverte, qui tournent moins souvent.
Résultat attendu : des valeurs récentes pour la charge CPU, la mémoire disponible, l’espace libre de / et le trafic de l’interface réseau ; un clic sur Graph affiche la courbe.
Vérification
- Dans Data collection > Hosts, l’indicateur ZBX de
web01est vert. zabbix_get -s 192.168.56.21 -k agent.pingrenvoie1depuiszbx-srv.- Monitoring > Latest data affiche des valeurs datées de moins de deux minutes pour
web01. - Arrêtez l’agent (
systemctl stop zabbix-agent2) : l’indicateur passe au rouge et un problème de disponibilité apparaît dans Monitoring > Problems après le délai prévu par le modèle. Redémarrez ensuite l’agent.
Problèmes fréquents
- Indicateur ZBX rouge, « connection refused ». Cause : agent arrêté ou port 10050 filtré. Correction :
systemctl status zabbix-agent2, puis autorisez 10050/tcp depuis 192.168.56.10 dans le pare-feu deweb01. - zabbix_get renvoie une erreur de connexion fermée par l’agent. Cause : l’adresse du serveur absente de
Server. Correction : ajoutez-la et redémarrez l’agent. - Les vérifications actives échouent avec « host not found ». Cause :
Hostnamedifférent du nom de l’hôte dans l’interface (la casse compte). Correction : alignez les deux valeurs. - Aucun système de fichiers dans Latest data. Cause : la règle de découverte n’a pas encore tourné. Correction : patientez ou lancez Execute now sur la règle de découverte de l’hôte.
Bonnes pratiques et sécurité
- Restreignez
Serverà l’IP du serveur ou du proxy, jamais à un réseau entier sans raison. - N’ouvrez le port 10050 qu’aux adresses de supervision dans le pare-feu de l’hôte.
- Laissez l’agent fonctionner sous son compte système dédié
zabbixplutôt que sous root. - Déployez agent et configuration avec un outil de gestion de configuration pour garder des fichiers homogènes sur tout le parc.
Questions de contrôle
1. Quelle directive empêche une machine inconnue d’interroger l’agent ?
Voir la réponse
Server : seules les adresses qui y figurent peuvent effectuer des vérifications passives sur le port 10050.
2. Pourquoi le champ Host name de l’interface doit-il être identique à la directive Hostname ?
Voir la réponse
Pour les vérifications actives, l’agent se présente au serveur avec ce nom ; s’il ne correspond à aucun hôte, le serveur refuse ses données.
3. Que vous apporte la liaison du modèle Linux by Zabbix agent ?
Voir la réponse
Un ensemble prêt à l’emploi d’éléments, de déclencheurs, de graphiques et de règles de découverte, maintenu par Zabbix et commun à tous les hôtes liés.
Pour aller plus loin
Pour automatiser le déploiement de l’agent sur des dizaines de serveurs, appuyez-vous sur le cours Introduction à Ansible. Si vous cherchez une vue temps réel à la seconde en complément de Zabbix, l’article Netdata : la supervision temps réel présente une approche différente. Explorez aussi les greffons de l’agent 2 (Docker, PostgreSQL, certificats web) décrits dans la documentation officielle.
Conservez web01 et sa configuration : il sert aux TP04, TP05 et TP07.
// formation sur mesure
Former votre équipe sur ce sujet ?
Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.