Prototypes LLD (Item, Trigger, Graph)
Auteur : [‘Gautier RAYEROUX’] | Date : 2026-04-08 14:01:00
Prototypes LLD — Item, Trigger et Graph
Section titled “Prototypes LLD — Item, Trigger et Graph”Prérequis
Section titled “Prérequis”- Serveur Zabbix opérationnel et hôte ajouté
- Une règle de découverte (Discovery Rule) configurée sur l’hôte
- Accès à l’interface web avec droits d’administration
Étape 1 — Créer une règle de découverte
Section titled “Étape 1 — Créer une règle de découverte”Avant de pouvoir créer des prototypes, une règle de découverte doit exister.
- Aller dans Data collection → Hosts
- Cliquer sur Discovery sur la ligne de l’hôte cible
- Cliquer sur Create discovery rule
| Champ | Valeur exemple | Description |
|---|---|---|
| Name | Discover filesystems | Nom lisible de la règle |
| Type | Zabbix agent | Source de la découverte |
| Key | vfs.fs.discovery | Clé retournant un JSON avec les macros |
| Update interval | 1h | Fréquence de découverte |
- Cliquer sur Add pour enregistrer la règle
Étape 2 — Créer un Item prototype
Section titled “Étape 2 — Créer un Item prototype”Un Item prototype définit la métrique à collecter pour chaque élément découvert.
Dans la liste des règles de découverte, cliquer sur Item prototypes sur la ligne de la règle, puis sur Create item prototype.
Configuration
Section titled “Configuration”| Champ | Valeur exemple | Description |
|---|---|---|
| Name | Free space on {#FSNAME} | Nom avec macro LLD |
| Type | Zabbix agent | Type de collecte |
| Key | vfs.fs.size[{#FSNAME},free] | Clé avec macro LLD |
| Type of information | Numeric (float) | Format de la valeur |
| Units | B | Unité affichée |
| Update interval | 5m | Fréquence de collecte |
Onglets complémentaires
Section titled “Onglets complémentaires”- Preprocessing : transformer la valeur brute (multiplication, regex, JSON path…)
- Tags : ajouter des étiquettes pour filtrer dans les dashboards
- Custom intervals : planifier des collectes ponctuelles
Cliquer sur Add pour enregistrer.
Étape 3 — Créer un Trigger prototype
Section titled “Étape 3 — Créer un Trigger prototype”Un Trigger prototype définit une condition d’alerte pour chaque élément découvert.
Dans la règle de découverte, cliquer sur Trigger prototypes → Create trigger prototype.
Configuration
Section titled “Configuration”| Champ | Valeur exemple | Description |
|---|---|---|
| Name | Low free space on {#FSNAME} | Nom avec macro LLD |
| Severity | Warning / High / Disaster | Sévérité de l’alerte |
| Expression | (voir ci-dessous) | Condition de déclenchement |
| Description | Espace disque < 10% | Détail affiché dans l’alerte |
Construire l’expression
Section titled “Construire l’expression”Cliquer sur Expression constructor pour utiliser l’assistant graphique.
last(/Nom_hôte/vfs.fs.size[{#FSNAME},pfree])<10Sévérités disponibles
Section titled “Sévérités disponibles”| Sévérité | Couleur | Usage typique |
|---|---|---|
| Not classified | Gris | Inconnu |
| Information | Bleu | Informatif |
| Warning | Jaune | Surveiller |
| Average | Orange | Dégradation |
| High | Rouge | Impact fort |
| Disaster | Rouge foncé | Service hors ligne |
Cliquer sur Add pour enregistrer.
Étape 4 — Créer un Graph prototype
Section titled “Étape 4 — Créer un Graph prototype”Un Graph prototype génère automatiquement un graphique pour chaque élément découvert.
Dans la règle de découverte, cliquer sur Graph prototypes → Create graph prototype.
Configuration
Section titled “Configuration”| Champ | Valeur exemple | Description |
|---|---|---|
| Name | Disk usage on {#FSNAME} | Nom avec macro LLD |
| Width / Height | 900 / 200 | Dimensions en pixels |
| Graph type | Normal / Stacked / Pie | Type de graphique |
| Y axis MIN/MAX | Fixed ou Calculated | Échelle de l’axe Y |
Ajouter des items au graphique
Section titled “Ajouter des items au graphique”Dans la section Items, cliquer sur Add :
| Champ | Valeur | Description |
|---|---|---|
| Item | vfs.fs.size[{#FSNAME},free] | Item prototype à tracer |
| Color | #00AA00 | Couleur de la courbe |
| Draw style | Line / Filled / Bold line | Style de tracé |
| Y axis side | Left / Right | Axe associé |
Cliquer sur Add pour enregistrer.
Étape 5 — Vérifier la découverte
Section titled “Étape 5 — Vérifier la découverte”- Aller dans Monitoring → Hosts et cliquer sur l’hôte
- Ouvrir l’onglet Discovery pour voir l’état de la règle
- Attendre le prochain cycle de découverte (ou forcer via Check now)
- Vérifier dans Items, Triggers et Graphs que les entrées ont bien été créées dynamiquement
Dépannage
Section titled “Dépannage”| Symptôme | Cause probable | Solution |
|---|---|---|
| Aucun item créé | Règle de découverte en erreur | Vérifier la clé et la connectivité agent |
| Macro non remplacée | Faute de frappe dans {#NOM} | Vérifier le nom exact retourné par la règle |
| Trigger jamais déclenché | Expression incorrecte | Tester via Configuration → Hosts → Items → Check now |
| Graphique vide | Item non collecté | Vérifier que l’item prototype collecte des données |
| Découverte trop lente | Intervalle trop long | Réduire l’Update interval de la règle |