Accueil » Formations » Administration système » Supervision d’infrastructure avec Zabbix » TP04 – Créer des éléments et des déclencheurs personnalisés

TP04 – Créer des éléments et des déclencheurs personnalisés

← Supervision d’infrastructure avec Zabbix

// travaux pratiques · Administration système

TP04 - Créer des éléments et des déclencheurs personnalisés

  • TP 4 / 7
  • 7 étapes
  • ≈ 50 min
  • Accès libre

Objectif : superviser une donnée propre à votre entreprise grâce à un UserParameter de l’agent 2, créer l’élément correspondant puis un déclencheur paramétré par une macro utilisateur, et le tester en provoquant un problème.

Contexte

Les modèles officiels couvrent le système, mais pas ce qui fait la spécificité d’un serveur : la taille d’une file d’attente, le nombre de fichiers en attente de traitement, la présence d’un fichier de verrou, l’âge de la dernière sauvegarde. Un administrateur passe une bonne partie de son temps de supervision à ajouter ce type d’indicateurs métier.

Ici, on surveille le nombre de fichiers déposés dans un répertoire d’échange /srv/depot sur web01, que traite normalement une tâche planifiée. Si le dossier se remplit, c’est que le traitement est bloqué. À la fin, vous saurez écrire un paramètre utilisateur, le tester, créer un élément, rédiger une expression de déclencheur et la rendre ajustable par macro.

Prérequis : TP02 terminé (web01 supervisé par l’agent 2) ; accès root sur web01.

Durée estimée : 50 minutes.

Actions à réaliser

1. Préparer le répertoire d’échange

mkdir -p /srv/depot
chmod 755 /srv/depot

L’agent fonctionne sous le compte zabbix : il doit pouvoir lister le répertoire. Les droits 755 suffisent pour une lecture du contenu.

2. Écrire le paramètre utilisateur

La syntaxe est UserParameter=<clé>,<commande>. Plutôt que de modifier le fichier principal, on crée un fichier dédié dans le répertoire inclus par la directive Include (vérifiez son chemin avec grep ^Include /etc/zabbix/zabbix_agent2.conf) :

cat > /etc/zabbix/zabbix_agent2.d/depot.conf <<'EOF'
UserParameter=depot.files[*],find "$1" -maxdepth 1 -type f | wc -l
EOF

Le suffixe [*] rend la clé flexible : le premier paramètre passé entre crochets remplace $1. Une même ligne sert donc pour n’importe quel répertoire. -maxdepth 1 limite le comptage au premier niveau et -type f ne compte que les fichiers.

3. Recharger et tester l’agent

systemctl restart zabbix-agent2
zabbix_agent2 -t depot.files[/srv/depot]

Résultat attendu : la clé et la valeur 0 (répertoire vide). Depuis zbx-srv, zabbix_get -s 192.168.56.21 -k depot.files[/srv/depot] doit renvoyer la même valeur.

4. Créer l’élément dans Zabbix

Dans Data collection > Hosts, ouvrez les Items de web01 puis Create item :

  • Name : Fichiers en attente dans /srv/depot ;
  • Type : Zabbix agent ; Key : depot.files[/srv/depot] ;
  • Type of information : Numeric (unsigned) ; Update interval : 1m ;
  • History : 14d ; Trends : 365d.

Le type Zabbix agent correspond à une vérification passive : c’est le serveur qui interroge l’agent à chaque intervalle. Choisissez Zabbix agent (active) si l’hôte est supervisé en mode actif, comme au TP06.

Le bouton Test du formulaire interroge l’agent immédiatement et permet de valider la clé avant d’enregistrer. L’historique garde chaque valeur, les tendances en conservent une synthèse horaire, beaucoup moins coûteuse en stockage.

5. Définir une macro de seuil

Dans l’onglet Macros de l’hôte, créez {$DEPOT.MAX} avec la valeur 20. Le seuil pourra être ajusté par hôte sans toucher au déclencheur, et repris tel quel si vous déplacez plus tard l’élément dans un modèle.

6. Créer le déclencheur

Dans les Triggers de l’hôte, Create trigger :

  • Name : Traitement du dépôt bloqué sur {HOST.NAME} ;
  • Severity : Average ;
  • Expression :
min(/web01/depot.files[/srv/depot],5m)>{$DEPOT.MAX}

La fonction min() sur 5 minutes impose que le seuil soit dépassé en permanence pendant cette période : un pic ponctuel, normal pendant un dépôt, ne déclenche rien. Ajoutez une expression de rétablissement (Recovery expression) pour éviter les oscillations :

max(/web01/depot.files[/srv/depot],5m)<{$DEPOT.MAX}/2

7. Provoquer et résoudre le problème

for i in $(seq 1 30); do touch /srv/depot/fichier$i.csv; done

Résultat attendu : au bout d’environ cinq minutes, le problème apparaît dans Monitoring > Problems en sévérité Average. Supprimez ensuite les fichiers (rm /srv/depot/fichier*.csv) : le problème passe en RESOLVED après la fenêtre de rétablissement.

Vérification

  • Monitoring > Latest data affiche l’élément avec la valeur 30 pendant le test, puis 0.
  • Le problème a été ouvert puis résolu ; son historique est visible dans Monitoring > Problems en affichant l’historique.
  • En passant {$DEPOT.MAX} à 50 et en recréant 30 fichiers, aucun problème n’est levé.

Problèmes fréquents

  • Élément « not supported », clé inconnue. Cause : agent non redémarré ou fichier hors du répertoire inclus. Correction : vérifiez la directive Include, puis redémarrez l’agent.
  • Valeur toujours à 0 alors que des fichiers existent. Cause : le compte zabbix ne peut pas lire le dossier. Correction : testez avec sudo -u zabbix find /srv/depot -maxdepth 1 -type f et corrigez les droits.
  • Erreur de type de données. Cause : Type of information numérique alors que la commande renvoie du texte (message d’erreur de find). Correction : corrigez la commande pour qu’elle renvoie uniquement un nombre.
  • Déclencheur refusé à l’enregistrement. Cause : faute dans le nom d’hôte ou la clé de l’expression. Correction : utilisez le bouton Add du constructeur d’expression pour choisir l’élément.

Bonnes pratiques et sécurité

  • N’activez jamais l’exécution de commandes arbitraires sur l’agent ; préférez des paramètres utilisateur précis et en lecture seule.
  • Gardez les commandes rapides : une commande lente bloque la collecte et finit en délai dépassé.
  • Rangez paramètres, éléments et déclencheurs dans un modèle versionné dès qu’ils servent sur plusieurs hôtes.
  • Choisissez la sévérité selon l’impact métier et nommez le déclencheur par le symptôme, pas par la valeur.

Questions de contrôle

1. Que permet le suffixe [*] dans un UserParameter ?

Voir la réponse

De passer des paramètres entre crochets dans la clé, récupérés dans la commande par $1 à $9.

2. Pourquoi utiliser min(…,5m) plutôt que last(…) dans ce déclencheur ?

Voir la réponse

min sur 5 minutes n’est vrai que si toutes les valeurs de la période dépassent le seuil : on ignore les pics passagers et on réduit les fausses alertes.

3. Quel est l’intérêt d’une expression de rétablissement ?

Voir la réponse

Elle fixe une condition de retour à la normale distincte du seuil d’alerte, ce qui évite qu’une valeur oscillant autour du seuil ouvre et ferme sans cesse le problème.

Pour aller plus loin

Transformez cet élément en modèle réutilisable et ajoutez une règle de découverte bas niveau (LLD) pour superviser plusieurs dossiers. Le même mécanisme permet de suivre l’âge d’une sauvegarde : le cours Sauvegardes 3-2-1 avec Restic vous donne la matière pour écrire un tel contrôle.

Videz /srv/depot mais conservez l’élément et le déclencheur : ils servent de source d’alerte au TP05.

// 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.

Demander un programme
Défiler vers le haut