Passer au contenu principal
Cette documentation explique comment créer des déclencheurs pour vous alerter de comportements spécifiques dans les logs. Vous pouvez lire notre documentation sur la détection d’anomalies pour plus d’informations sur la fonctionnalité d’alerte d’AppSignal.

Créer des déclencheurs

Pour créer un nouveau déclencheur, accédez à Triggers dans la navigation Logging, et cliquez sur « Create a log trigger ». Il vous sera alors demandé de définir les attributs de déclencheur suivants :

Nom et description

Dans le formulaire Create new trigger, donnez à votre déclencheur un nom et une description fonctionnels, par exemple « Slow Process Trigger ».

Requête du déclencheur

Les déclencheurs de log sont basés sur des requêtes, ce qui signifie qu’une alerte est déclenchée lorsque les conditions d’une requête de log sont remplies. Par exemple, si nous avons un attribut de log appelé duration qui enregistre la durée d’une requête d’API, et que nous voulons être alertés lorsque cet attribut est supérieur à 50, nous créerions un déclencheur avec la requête suivante :
Shell
attributes.duration > 50
Vous pouvez en savoir plus sur la syntaxe de requête d’AppSignal dans notre documentation sur la syntaxe de requête.

Seuil

Vous pouvez définir un seuil pour votre déclencheur afin de ne recevoir des alertes que lorsque cela est nécessaire. Les déclencheurs de log peuvent avoir les seuils suivants :
  • Toutes les occurrences
  • Premier après fermeture
  • Nième en une heure
  • Nième en un jour
Si vous souhaitez empêcher un déclencheur de vous notifier, vous pouvez sélectionner « Never Notify ». Le seuil « Never Notify » est principalement utilisé pour les problèmes bénins que vous souhaitez suivre mais qui ne sont pas suffisamment urgents pour justifier le déclenchement d’une alerte. Vous pouvez en savoir plus sur les seuils dans notre documentation sur les paramètres de notification.

Définir la gravité du déclencheur

Les déclencheurs peuvent être limités aux gravités suivantes :
  • Critique
  • Élevé
  • Faible
  • Info
Si nous sélectionnons la gravité Critical, notre déclencheur ne sera déclenché que lorsqu’un log de gravité critique correspond à notre requête. Si vous ne souhaitez pas limiter votre déclencheur à une gravité, vous pouvez choisir « Not set », ce qui signifie que le déclencheur sera déclenché lorsque sa requête est satisfaite pour n’importe quelle gravité de log.

Source du déclencheur

Définissez à quelles sources de logs votre requête s’applique.

Notificateur du déclencheur

Définissez comment vous êtes notifié lorsqu’un déclencheur est déclenché, par exemple par e-mail ou Slack. Le logging prend actuellement en charge les notificateurs suivants :
  • Discord
  • Email
  • Google Hangouts
  • Opsgenie
  • Pagerduty
  • Slack
  • MS Teams
  • Webhook
Vous pouvez en savoir plus sur l’intégration d’AppSignal avec des notificateurs dans notre documentation sur les intégrations.

Enregistrer et gérer les déclencheurs

Une fois enregistré, si les conditions de votre déclencheur sont remplies, vous serez alerté via votre plateforme de notification préférée. Vous pouvez gérer vos déclencheurs de log depuis la page Triggers. Si vous avez des difficultés à intégrer un notificateur ou si vous ne recevez pas d’alertes, vous pouvez contacter notre support, nous sommes là pour vous aider !