Configuration d'un déclencheur
Cette page décrit comment configurer un déclencheur dans l'interface Zabbix.
Notez que les modèles officiels Zabbix contiennent des déclencheurs prédéfinis. Consultez le guide pour appliquer un modèle à monitor Linux. Il est également possible d'effectuer une mise à jour en masse des déclencheurs configurés.
Autres ressources :
- Détection des problèmes avec les déclencheurs (introduction générale)
- Exemples de déclencheurs (par cas d'utilisation)
- Expression et fonctions des déclencheurs (détails de syntaxe)
- Bonnes pratiques
Configuration
Pour configurer un déclencheur, procédez comme suit :
- Accédez à Collecte de données > Hôtes.
- Cliquez sur Déclencheurs dans la ligne de l’hôte.
- Cliquez sur Créer un déclencheur à droite (ou sur le nom du déclencheur pour modifier un déclencheur existant).
- Saisissez les paramètres du déclencheur dans le formulaire.
L’onglet Déclencheur contient tous les attributs essentiels du déclencheur.

Tous les champs obligatoires sont marqués d’un astérisque rouge.
| Paramètre | Description |
|---|---|
| Nom | Nom du déclencheur. Les macros prises en charge sont : {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.VALUE.AGE}, {ITEM.VALUE.DATE}, {ITEM.VALUE.TIME}, {ITEM.VALUE.TIMESTAMP}, {ITEM.LASTVALUE}, {ITEM.LASTVALUE.AGE}, {ITEM.LASTVALUE.DATE}, {ITEM.LASTVALUE.TIME}, {ITEM.LASTVALUE.TIMESTAMP}, {ITEM.LOG.*} et les macros utilisateur {$MACRO}. Les macros $1, $2...$9 peuvent être utilisées pour faire référence à la première, deuxième... neuvième constante de l’expression. Remarque : les macros $1-$9 seront résolues correctement si elles font référence à des constantes dans des expressions relativement simples et directes. Par exemple, le nom « Charge du processeur supérieure à $1 sur {HOST.NAME} » deviendra automatiquement « Charge du processeur supérieure à 5 sur New host » si l’expression est last(/New host/system.cpu.load[percpu,avg1])>5. |
| Nom de l’événement | Lorsqu’il est défini, ce nom est utilisé pour créer le nom de l’événement de problème. Par défaut, le nom de l’événement est identique au nom du déclencheur. Le nom de l’événement peut être utilisé pour créer des alertes pertinentes contenant les données du problème (voir l’exemple). Le même ensemble de macros que pour le nom du déclencheur est pris en charge, ainsi que les macros d’expression {TIME}, {TIMESTAMP} et {?EXPRESSION}. |
| Données opérationnelles | Saisissez une chaîne (jusqu’à 2048 caractères) contenant des macros afin d’afficher des données dynamiques en temps réel dans Surveillance > Problèmes. Vous pouvez également laisser ce champ vide pour afficher les dernières valeurs de tous les éléments de l’expression du déclencheur. Le même ensemble de macros que pour le nom du déclencheur est pris en charge, avec la possibilité de les résoudre dynamiquement. Par exemple : {ITEM.VALUE<1-9>} renvoie les valeurs des éléments au moment où l’état du déclencheur est modifié (problème créé, résolu, fermé manuellement ou fermé par corrélation). {ITEM.LASTVALUE<1-9>} renvoie les dernières valeurs des éléments. Notez que la fermeture manuelle d’un problème ne produit pas de nouvelle valeur ; les deux macros affichent donc toujours la valeur au moment du problème. Notez également que les deux macros renvoient UNKNOWN si la dernière valeur est antérieure à la Période maximale d’affichage de l’historique (voir Administration > Général). La fonction de macro jsonpath n’est pas prise en charge dans l’interface et renvoie donc UNKNOWN dans Surveillance > Problèmes ; elle est résolue uniquement par le serveur Zabbix, par exemple lorsque {EVENT.OPDATA} est utilisé dans les notifications. |
| Gravité | Définissez la gravité requise du déclencheur en cliquant sur les boutons. |
| Expression | Expression logique utilisée pour définir les conditions d’un problème. Les suffixes temporels et les suffixes de taille mémoire sont pris en charge. Un problème est créé lorsque toutes les conditions incluses dans l’expression sont remplies, c’est-à-dire lorsque l’expression renvoie TRUE. Le problème est résolu dès que l’expression renvoie FALSE, sauf si des conditions de récupération supplémentaires sont spécifiées dans Expression de récupération. |
| Génération d’événements OK | Options de génération des événements OK : Expression - les événements OK sont générés sur la base de la même expression que les événements de problème ; Expression de récupération - les événements OK sont générés si l’expression du problème renvoie FALSE et si l’expression de récupération renvoie TRUE ; Aucune - dans ce cas, le déclencheur ne revient jamais de lui-même à l’état OK. |
| Expression de récupération | Expression logique (facultative) définissant des conditions supplémentaires qui doivent être remplies avant la résolution du problème, après que l’expression du problème d’origine a déjà renvoyé FALSE. L’expression de récupération est utile pour l’hystérésis des déclencheurs. Il est impossible de résoudre un problème avec la seule expression de récupération si l’expression du problème renvoie toujours TRUE. Ce champ est disponible uniquement si « Expression de récupération » est sélectionnée pour Génération d’événements OK. |
| Mode de génération des événements PROBLEM | Mode de génération des événements de problème : Unique - un seul événement est généré lorsque le déclencheur passe pour la première fois à l’état « Problème » ; Multiple - un événement est généré à chaque évaluation « Problème » du déclencheur. |
| L’événement OK ferme | Sélectionnez ce que l’événement OK ferme : Tous les problèmes - tous les problèmes de ce déclencheur ; Tous les problèmes si les valeurs des étiquettes correspondent - uniquement les problèmes de ce déclencheur dont les valeurs des étiquettes d’événement correspondent. |
| Étiquette pour la correspondance | Saisissez le nom de l’étiquette d’événement à utiliser pour la corrélation des événements. Ce champ est affiché si « Tous les problèmes si les valeurs des étiquettes correspondent » est sélectionné pour la propriété L’événement OK ferme et est obligatoire dans ce cas. |
| Autoriser la fermeture manuelle | Cochez cette option pour autoriser la fermeture manuelle des événements de problème générés par ce déclencheur. La fermeture manuelle est possible lors de la confirmation des événements de problème. |
| Nom de l’entrée de menu | Si ce champ n’est pas vide, le nom saisi ici (jusqu’à 64 caractères) est utilisé à plusieurs endroits de l’interface comme libellé de l’URL du déclencheur spécifiée dans le paramètre URL de l’entrée de menu. S’il est vide, le nom par défaut URL du déclencheur est utilisé. Le même ensemble de macros que pour le nom du déclencheur est pris en charge, ainsi que {EVENT.ID}, {HOST.ID} et {TRIGGER.ID}. |
| URL de l’entrée de menu | Si ce champ n’est pas vide, l’URL saisie ici (jusqu’à 2048 caractères) est disponible sous forme de lien dans le menu des événements à plusieurs endroits de l’interface, par exemple lorsque vous cliquez sur le nom du problème dans Surveillance > Problèmes ou dans le widget de tableau de bord Problèmes. Le même ensemble de macros que pour le nom du déclencheur est pris en charge, ainsi que {EVENT.ID}, {HOST.ID} et {TRIGGER.ID}. Remarque : les macros utilisateur contenant des valeurs secrètes ne seront pas résolues dans l’URL. |
| Description | Champ de texte permettant de fournir davantage d’informations sur ce déclencheur. Il peut contenir des instructions pour résoudre un problème spécifique, les coordonnées du personnel responsable, etc. Le même ensemble de macros que pour le nom du déclencheur est pris en charge. |
| Activé | Décochez cette case pour désactiver le déclencheur si nécessaire. Les problèmes d’un déclencheur désactivé ne sont plus affichés dans l’interface, mais ne sont pas supprimés. |
L’onglet Étiquettes permet de définir les étiquettes au niveau du déclencheur. Tous les problèmes de ce déclencheur seront associés aux valeurs saisies ici.

En outre, l’option Étiquettes héritées et du déclencheur permet d’afficher les étiquettes définies au niveau du modèle si le déclencheur provient de ce modèle. Si plusieurs modèles possèdent la même étiquette, ces étiquettes sont affichées une seule fois et les noms des modèles sont séparés par des virgules. Un déclencheur n’« hérite » pas des étiquettes définies au niveau de l’hôte et ne les affiche pas.
| Paramètre | Description |
|---|---|
| Nom/Valeur | Définissez des étiquettes personnalisées pour marquer les événements du déclencheur. Les étiquettes sont constituées d’un nom et d’une valeur. Vous pouvez utiliser uniquement le nom ou l’associer à une valeur. Un déclencheur peut posséder plusieurs étiquettes portant le même nom, mais des valeurs différentes. Les macros utilisateur, les macros utilisateur avec contexte, les macros de découverte de bas niveau et les fonctions de macro avec {{ITEM.VALUE}}, {{ITEM.LASTVALUE}} sont prises en charge dans les étiquettes d’événement. Les macros de découverte de bas niveau peuvent être utilisées dans un contexte de macro.La macro {TRIGGER.ID} est prise en charge dans les valeurs des étiquettes de déclencheur. Elle peut être utile pour identifier les déclencheurs créés à partir de prototypes de déclencheur et, par exemple, supprimer les problèmes générés par ces déclencheurs pendant une maintenance. Si la longueur totale de la valeur développée dépasse 255 caractères, elle sera tronquée à 255 caractères. Voir toutes les macros prises en charge pour les étiquettes d’événement. Les étiquettes d’événement peuvent être utilisées pour la corrélation des événements et dans les conditions des actions ; elles sont également visibles dans Surveillance > Problèmes ou dans le widget Problèmes. |
L’onglet Dépendances contient toutes les dépendances du déclencheur.
Cliquez sur Ajouter pour ajouter une nouvelle dépendance.
Vous pouvez également configurer un déclencheur en ouvrant un déclencheur existant, en cliquant sur le bouton Cloner, puis en l’enregistrant sous un autre nom.
Test d'expression de déclencheur
Il est possible de tester quel serait le résultat de l'expression en fonction de la valeur reçue.
L'expression suivante, issue d'un modèle officiel, est prise comme exemple :
avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
or
last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}
Pour tester l'expression, cliquez sur Constructeur d'expression sous le champ de l'expression.

Dans le Constructeur d'expression, toutes les expressions individuelles sont listées. Pour ouvrir la fenêtre de test, cliquez sur Test sous la liste des expressions.

Dans la fenêtre de test, vous pouvez saisir des valeurs d'exemple ('80', '70', '0', '1' dans cet exemple), puis voir le résultat de l'expression en cliquant sur le bouton Test.

Le résultat des expressions individuelles ainsi que de l'expression complète peut être consulté.
"TRUE" signifie que l'expression spécifiée est correcte.
Dans ce cas A, "80" est supérieur à la valeur spécifiée par {$TEMP_WARN}, "70" dans cet exemple.
Comme prévu, un résultat "TRUE" apparaît.
"FALSE" signifie que l'expression spécifiée est incorrecte.
Dans ce cas B, {$TEMP_WARN_STATUS} "1" doit être égal à la valeur spécifiée, "0" dans cet exemple.
Comme prévu, un résultat "FALSE" apparaît.
Le type d'expression choisi est "OR". Si au moins une des conditions spécifiées (A ou B dans ce cas) est TRUE, le résultat global sera également TRUE. Cela signifie que la valeur actuelle dépasse la valeur d'avertissement et qu'un problème s'est produit.