2 Configuration d’un déclencheur

Cette page décrit comment configurer un déclencheur dans l’interface web de Zabbix.

Notez que les modèles Zabbix officiels contiennent des déclencheurs prédéfinis. Consultez le guide pour surveiller Linux en appliquant un modèle. Il est également possible de mettre à jour en masse les déclencheurs configurés.

Autres ressources :

Configuration

Pour configurer un déclencheur, procédez comme suit :

  • Allez dans : Collecte de données > Hôtes
  • Cliquez sur Déclencheurs sur 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 de saisie 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.*}, ainsi que 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 correctement résolues si elles font référence à des constantes dans des expressions relativement simples et directes. Par exemple, le nom « Charge processeur supérieure à $1 sur {HOST.NAME} » deviendra automatiquement « Charge 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 sera 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 explicites contenant des données de problème (voir exemple).
Le même ensemble de macros est pris en charge que pour le nom du déclencheur, plus {TIME}, {TIMESTAMP} et les macros d'expression {?EXPRESSION}.
Données opérationnelles Les données opérationnelles permettent de définir des chaînes arbitraires avec des macros. Les macros seront résolues dynamiquement en données en temps réel dans Surveillance > Problèmes. Alors que les macros dans le nom du déclencheur (voir ci-dessus) seront résolues vers leurs valeurs au moment où un problème survient et deviendront la base d'un nom de problème statique, les macros dans les données opérationnelles conservent la capacité d'afficher dynamiquement les informations les plus récentes. Si aucune donnée opérationnelle n'est configurée au niveau du déclencheur, les dernières valeurs de tous les éléments de l'expression seront affichées.
Le même ensemble de macros est pris en charge que pour le nom du déclencheur.
Sévérité Définissez la sévérité 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 de temps et les suffixes de taille mémoire sont pris en charge.
Un problème est créé une fois que toutes les conditions incluses dans l'expression sont remplies, c'est-à-dire que l'expression est évaluée à TRUE. Le problème sera résolu dès que l'expression sera évaluée à 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énement OK Options de génération d'événement 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 est évaluée à FALSE et l'expression de récupération à TRUE ;
Aucune - dans ce cas, le déclencheur ne reviendra jamais de lui-même à un état OK.
Expression de récupération Expression logique (facultative) définissant des conditions supplémentaires qui doivent être remplies avant que le problème ne soit résolu, après que l'expression du problème d'origine a déjà été évaluée à FALSE.
L'expression de récupération est utile pour l'hystérésis du déclencheur. Il n'est pas possible de résoudre un problème par la seule expression de récupération si l'expression du problème est toujours TRUE.
Ce champ n'est disponible que si « Expression de récupération » est sélectionné pour Génération d'événement OK.
Mode de génération d'événement PROBLEM Mode de génération des événements de problème :
Unique - un seul événement est généré lorsqu'un déclencheur passe à l'état « Problème » pour la première fois ;
Multiple - un événement est généré à chaque évaluation « Problème » du déclencheur.
Fermeture par événement OK Sélectionnez si l'événement OK ferme :
Tous les problèmes - tous les problèmes de ce déclencheur ;
Tous les problèmes si les valeurs de tag correspondent - uniquement les problèmes de ce déclencheur dont les valeurs de tags d'événement correspondent.
Tag pour la correspondance Saisissez le nom du tag d'événement à utiliser pour la corrélation d'événements.
Ce champ s'affiche si « Tous les problèmes si les valeurs de tag correspondent » est sélectionné pour la propriété Fermeture par événement OK et il est obligatoire dans ce cas.
Autoriser la fermeture manuelle Cochez cette case 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 l'acquittement des événements de problème.
Nom de l'entrée de menu S'il n'est pas vide, le nom saisi ici (jusqu'à 64 caractères) est utilisé à plusieurs endroits de l'interface comme libellé pour 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 est pris en charge que pour le nom du déclencheur, plus {EVENT.ID}, {HOST.ID} et {TRIGGER.ID}.
URL de l'entrée de menu S'il n'est pas vide, l'URL saisie ici (jusqu'à 2048 caractères) est disponible comme lien dans le menu d'événement à plusieurs endroits de l'interface, par exemple en cliquant 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 est pris en charge que pour le nom du déclencheur, plus {EVENT.ID}, {HOST.ID} et {TRIGGER.ID}. Remarque : les macros utilisateur avec des valeurs secrètes ne seront pas résolues dans l'URL.
Description Champ de texte utilisé pour fournir plus d'informations sur ce déclencheur. Peut contenir des instructions pour corriger un problème spécifique, les coordonnées du personnel responsable, etc.
Le même ensemble de macros est pris en charge que pour le nom du déclencheur.
Activé Décocher cette case désactivera 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 Tags vous permet de définir des tags au niveau du déclencheur. Tous les problèmes de ce déclencheur seront marqués avec les valeurs saisies ici.

En outre, l'option Tags hérités et tags du déclencheur vous permet d'afficher les tags définis au niveau du modèle si le déclencheur provient de ce modèle. S'il existe plusieurs modèles avec le même tag, ces tags sont affichés une seule fois et les noms des modèles sont séparés par des virgules. Un déclencheur n'« hérite » pas des tags au niveau de l'hôte et ne les affiche pas.

Paramètre Description
Nom/Valeur Définissez des tags personnalisés pour marquer les événements du déclencheur.
Les tags sont une paire composée d'un nom de tag et d'une valeur. Vous pouvez utiliser uniquement le nom ou l'associer à une valeur. Un déclencheur peut avoir plusieurs tags portant le même nom, mais avec 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 tags d'événement. Les macros de découverte de bas niveau peuvent être utilisées dans le contexte de macro.
La macro {TRIGGER.ID} est prise en charge dans les valeurs de tag du 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 de ces déclencheurs pendant une maintenance.
Si la longueur totale de la valeur développée dépasse 255, elle sera tronquée à 255 caractères.
Voir toutes les macros prises en charge pour les tags d'événement.
Les tags d'événement peuvent être utilisés pour la corrélation d'événements, dans les conditions d'action, et seront é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 appuyant 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 provenant 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 d'expression.

Dans le constructeur d'expression, toutes les expressions individuelles sont répertorié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 affiché.

« TRUE » signifie que l'expression spécifiée est correcte. Dans ce cas particulier A, « 80 » est supérieur à la valeur spécifiée {$TEMP_WARN}, soit « 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 particulier B, {$TEMP_WARN_STATUS} « 1 » doit être égal à la valeur spécifiée, soit « 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.