// travaux pratiques · Administration système
TP06 - Automatiser l’ajout d’hôtes par autoenregistrement
- TP 6 / 7
- 6 étapes
- ≈ 40 min
- Accès libre
Objectif : faire en sorte qu’un nouveau serveur Linux apparaisse seul dans Zabbix, déjà classé et lié au bon modèle, grâce à l’autoenregistrement des agents actifs et aux métadonnées d’hôte.
Contexte
Créer chaque hôte à la main convient pour cinq serveurs, pas pour cinquante, ni pour des machines virtuelles créées et détruites à la demande. Le risque est connu : un serveur mis en production sans supervision, découvert le jour où il tombe. L’autoenregistrement inverse la logique : c’est l’agent, configuré dès l’installation, qui se présente au serveur Zabbix, et une action décide quoi faire de lui.
Zabbix propose deux mécanismes complémentaires. La découverte réseau, configurée dans Data collection > Discovery, fait balayer des plages d’adresses par le serveur à la recherche de services. L’autoenregistrement fait l’inverse : l’agent se signale lui-même. Le second convient mieux aux serveurs déployés en continu : aucun balayage du réseau n’est nécessaire, et l’hôte arrive avec le nom défini par sa directive Hostname plutôt qu’avec une simple adresse IP.
L’agent actif contacte le serveur sur le port TCP 10051 ; il n’est donc pas nécessaire d’ouvrir le port 10050 de l’hôte. À la fin, vous saurez préparer un agent pour l’autoenregistrement, écrire l’action correspondante et utiliser les métadonnées pour trier les machines.
Prérequis : TP01 et TP02 terminés ; une nouvelle machine Debian 12 app01 (192.168.56.23) avec le dépôt Zabbix 8.0 ajouté comme au TP02, étape 1 ; le port 10051/tcp de zbx-srv joignable depuis le réseau du lab.
Durée estimée : 40 minutes.
Actions à réaliser
1. Préparer le groupe de destination
Dans Data collection > Host groups, créez le groupe Linux - autoenregistrés. Par défaut, les hôtes autoenregistrés atterrissent dans le groupe Discovered hosts ; un groupe dédié facilite le contrôle et les droits. Vous pourrez par exemple y donner un accès en lecture seule à l’équipe d’exploitation, puis déplacer chaque hôte vers son groupe définitif une fois validé.
2. Créer l’action d’autoenregistrement
Dans Alerts > Actions > Autoregistration actions, Create action :
- Name :
Serveurs Linux du lab; - Conditions : Host metadata contains
linux-lab.
Onglet Operations, ajoutez trois opérations : Add host, Add to host group Linux - autoenregistrés, et Link templates Linux by Zabbix agent active. On choisit la variante active du modèle, car l’hôte ne sera pas interrogé en mode passif.
Résultat attendu : l’action apparaît avec le statut Enabled.
3. Installer l’agent 2 sur app01
apt install -y zabbix-agent2
4. Configurer l’agent en mode actif avec métadonnées
Dans /etc/zabbix/zabbix_agent2.conf :
ServerActive=192.168.56.10
Hostname=app01
HostMetadata=linux-lab
ServerActive indique le serveur à contacter. HostMetadata est une chaîne libre envoyée lors de l’enregistrement : c’est elle que la condition de l’action examine. Variante : HostMetadataItem=system.uname envoie le résultat d’une clé (ici la description du système) au lieu d’une valeur fixe. Laissez Server limité à l’IP du serveur Zabbix : seul lui pourra interroger l’agent en mode passif.
zabbix_agent2 -T -c /etc/zabbix/zabbix_agent2.conf
systemctl restart zabbix-agent2
systemctl enable zabbix-agent2
5. Observer l’enregistrement
L’agent demande sa liste de vérifications actives au démarrage puis à intervalle régulier ; c’est cette demande, venant d’un hôte inconnu, qui crée l’événement d’autoenregistrement.
Résultat attendu : en une à deux minutes, app01 apparaît dans Data collection > Hosts, dans le groupe Linux - autoenregistrés, lié au modèle Linux by Zabbix agent active. Son indicateur de disponibilité reflète les vérifications actives.
6. Tester le tri par métadonnées
Sur une autre machine (ou sur app01 après suppression de l’hôte dans l’interface), remplacez HostMetadata=linux-lab par HostMetadata=poste-test, puis redémarrez l’agent.
Résultat attendu : l’hôte n’est pas créé, car aucune action ne correspond. C’est le comportement souhaité : seules les machines porteuses des bonnes métadonnées entrent dans la supervision. Rétablissez ensuite linux-lab.
Vérification
app01existe dans le groupe dédié avec le bon modèle, sans aucune saisie manuelle.- Monitoring > Latest data affiche ses métriques (CPU, mémoire, systèmes de fichiers).
- Reports > Action log ou la liste des événements d’autoenregistrement montre l’exécution de l’action.
Problèmes fréquents
- L’hôte n’apparaît jamais. Cause : port 10051 de
zbx-srvfiltré ouServerActiveerroné. Correction : testez la connexion TCP vers 192.168.56.10:10051 depuisapp01et lisez le journal de l’agent (journalctl -u zabbix-agent2). - L’hôte est créé dans Discovered hosts sans modèle. Cause : opérations incomplètes dans l’action. Correction : ajoutez les opérations de groupe et de modèle, puis supprimez et laissez recréer l’hôte.
- Aucune donnée après création. Cause : modèle passif lié à un hôte sans interface agent joignable. Correction : utilisez la variante active du modèle.
- Deux machines se disputent le même hôte. Cause :
Hostnameidentique, par exemple après clonage d’une VM. Correction : donnez un nom unique à chaque agent.
Bonnes pratiques et sécurité
- Ne vous contentez pas de métadonnées faciles à deviner : combinez-les avec le chiffrement PSK de l’autoenregistrement (TP07) pour qu’un intrus ne puisse pas enregistrer un faux hôte.
- Utilisez des conditions précises et un groupe dédié, puis revoyez régulièrement les hôtes enregistrés.
- Définissez le nom d’hôte et les métadonnées dans votre gabarit de VM ou votre outil d’automatisation, jamais à la main.
- Limitez les droits des opérateurs sur le groupe des autoenregistrés tant que les hôtes ne sont pas validés.
Questions de contrôle
1. Sur quel port et dans quel sens se fait la communication d’un agent actif ?
Voir la réponse
L’agent initie la connexion vers le serveur (ou le proxy) sur le port TCP 10051.
2. Quelle est la différence entre HostMetadata et HostMetadataItem ?
Voir la réponse
HostMetadata envoie une valeur fixe définie dans la configuration ; HostMetadataItem envoie le résultat d’une clé de l’agent, par exemple system.uname.
3. Pourquoi lier la variante active du modèle Linux ?
Voir la réponse
Parce que l’hôte n’est pas interrogé par le serveur : ses éléments doivent être de type actif pour que l’agent les envoie lui-même.
Pour aller plus loin
Intégrez l’installation et la configuration de l’agent dans vos rôles Ansible ou dans le gabarit de vos VM : chaque nouveau serveur sera supervisé dès son premier démarrage. Pour les sites distants, l’autoenregistrement fonctionne aussi à travers un proxy Zabbix.
Conservez app01 : le TP07 sécurise son enregistrement.
// 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.