Options de notification
Chaque fois qu’un nouvel incident est créé, il héritera des valeurs par défaut de notification de l’application. Lorsqu’un incident d’erreur ou de performance a été créé, ses paramètres de notification peuvent être modifiés sur la page de l’incident elle-même. Si un incident a été fermé, il sera rouvert lorsqu’une nouvelle notification est envoyée. Six options de notification sont disponibles :- Chaque occurrence
- Première dans le déploiement
- Première après la fermeture
- Ne jamais notifier
- Toutes les N occurrences par heure
- Toutes les N occurrences par jour
Chaque occurrence
Une notification est envoyée chaque fois qu’un incident est déclenché. Cette option a un temps de recharge de 5 minutes. Cela signifie que si un incident est déclenché 20 fois par minute, pendant 20 minutes, vous recevrez une notification à la minute 0, 5, 10, 15 et 20.Première dans le déploiement
Une notification est envoyée à la première occurrence d’un incident après qu’un nouveau marqueur de déploiement soit reçu. Vous devrez configurer les marqueurs de déploiement pour qu’AppSignal détecte un déploiement et sache quand un incident s’est produit pour la première fois dans un déploiement.Première après la fermeture
Une notification est envoyée à la première occurrence d’un incident après que l’incident a été précédemment fermé. Les incidents peuvent être ouverts et fermés dans la barre latérale de la page de détail de l’incident. Cette option est une bonne option pour les incidents qui ne sont pas déclenchés par un bug de code, mais par une source externe (par exemple, un tiers a un problème de connexion) et ne peuvent pas être fermés en déployant une nouvelle version de l’application.Ne jamais notifier
Aucune notification n’est jamais envoyée lorsque l’incident est déclenché. Principalement utilisé pour les erreurs qui continueront à se produire et que vous souhaitez suivre, mais qui ne seront pas corrigées rapidement. Si vous ne souhaitez pas recevoir l’incident du tout, ignorer l’action ou ignorer l’erreur peut aider.Toutes les N occurrences par heure/jour
Aucune notification n’est envoyée toutes les n fois par heure, ou par jour, selon vos préférences. Il existe de nombreux scénarios où cela peut être bénéfique :- Erreur de facturation : Imaginez qu’une erreur de facturation se produise de temps en temps, en dehors de votre contrôle. Cela se produit au maximum 5 fois par jour, et vous voulez savoir quand cela augmente soudainement. Le régler sur « toutes les 10 fois par jour » vous enverra une alerte à chaque 10e, 20e, 30e occurrence, etc.
- Erreur d’API : Vous pouvez avoir une API que beaucoup de personnes utilisent. Lors d’expérimentations avec une API, faire des erreurs qui déclenchent des erreurs est courant. Vous pouvez vouloir n’être alerté que lorsque le nombre d’erreurs atteint un seuil. Vous pourriez, par exemple, le régler pour vous notifier toutes les 1000 fois par heure, ce qui pourrait indiquer que l’API échoue pour différentes raisons.
- Pendant un incident : Imaginez que quelque chose soit gravement cassé. Des centaines d’erreurs par heure se produisent, mais vous êtes au courant. Il pourrait ne pas être judicieux d’ignorer complètement toutes les alertes, mais recevoir chacune d’elles vous noiera sous les notifications. C’est le moment parfait pour gérer le nombre de notifications que vous recevez en réglant temporairement vos erreurs sur N/heure.
Paramètres de notification des incidents d’erreur
Les incidents d’erreur sont identifiés par le nom de la classe d’erreur, tel queActiveRecord::RecordNotFound et si l’erreur s’est produite à l’intérieur d’une action, le nom de l’action. (par exemple, StandardError dans BlogpostsController#show).
Paramètres de notification des incidents de performance
Les incidents de performance sont identifiés par leur nom d’« action », tel queBlogpostsController#show.
Une fois que nous détectons une nouvelle action, nous créons un incident pour celle-ci. À ce stade, vous pouvez remplacer les paramètres de notification par défaut et modifier quand vous souhaitez être notifié et quel seuil la durée de l’incident de performance doit atteindre avant qu’une notification ne soit envoyée.
Par exemple, pour les actions où les temps de réponse peuvent être lents, parce qu’elles interagissent avec des tiers, vous pouvez définir le seuil de durée à 10 secondes, tandis que pour la page d’accueil, vous pouvez définir un seuil de 200 millisecondes.
Le filtre de seuil est utilisé en combinaison avec les paramètres de notification. Par exemple, si vous avez Première dans le déploiement et 200ms comme paramètres de notification et seuil, une occurrence d’incident doit satisfaire les deux pour qu’une notification soit envoyée.
Valeurs par défaut de l’organisation et de l’espace de noms de l’application
Les paramètres de notification sur un incident ne peuvent être modifiés qu’après qu’il se soit produit au moins une fois. Cela peut poser problème si vous ne souhaitez jamais être notifié, ou si vous souhaitez définir un seuil d’incident de performance différent de la valeur par défaut de 200 millisecondes. Il est possible de configurer les valeurs par défaut de notification par espace de noms d’application ou même pour l’ensemble de l’organisation. Cela facilitera l’application des paramètres de notification souhaités à tous les nouveaux incidents et à tous les incidents existants, pour lesquels les paramètres de notification n’ont pas été personnalisés.Valeurs par défaut de notification de l’application
Chaque application a ses propres valeurs par défaut d’espace de noms pour les paramètres de notification. Un nouvel incident dans l’espace de noms spécifié héritera des paramètres par défaut définis sur cette page. Pour plus d’informations, consultez la section héritage des valeurs par défaut de notification. Il est recommandé de diviser l’application en espaces de noms qui regroupent les incidents potentiels par sévérité. De cette façon, vous pouvez configurer les paramètres de notification pour un groupe d’incidents et il n’est pas nécessaire de configurer chaque incident séparément. Par exemple, pour le panneau d’administration d’une application, vous pourriez créer un espace de noms appeléadmin avec un paramètre de notification par défaut de « Ne jamais notifier » car les erreurs qui se produisent dans cet espace de noms ont moins de priorité.
Valeurs par défaut de notification de l’organisation
Il est également possible de configurer les valeurs par défaut de notification au niveau de votre organisation. Ces valeurs par défaut seront utilisées lorsqu’AppSignal détecte et crée une nouvelle application. Lorsqu’il crée la nouvelle application, il applique les valeurs par défaut de notification de l’organisation comme valeurs par défaut de notification de l’application. Les modifications apportées aux valeurs par défaut de notification de l’organisation ne s’appliquent pas aux applications existantes. Pour plus d’informations, consultez la section héritage des valeurs par défaut de notification. Ces valeurs par défaut de notification au niveau de l’organisation peuvent être configurées dans le panneau d’administration de l’organisation. Il est possible de configurer des valeurs par défaut pour chaque espace de noms détecté dans n’importe laquelle des applications actuelles de votre organisation.Héritage des valeurs par défaut de notification
Les paramètres de notification remontent des paramètres d’incident aux paramètres d’espace de noms de l’application. Si les paramètres de notification d’un incident ne sont pas modifiés, les valeurs par défaut de l’espace de noms de l’application sont utilisées. Cela signifie que vous pouvez également modifier tous les paramètres de notification d’incident pour les incidents qui n’ont pas personnalisé leurs paramètres de notification en modifiant les valeurs par défaut de l’application.- Lorsqu’une nouvelle application est détectée par AppSignal, les valeurs par défaut d’espace de noms de l’organisation sont appliquées.
- Lorsque les valeurs par défaut de notification d’espace de noms de l’organisation sont modifiées, elles ne s’appliquent qu’aux nouvelles applications.
- Lorsque les valeurs par défaut de notification d’espace de noms d’une application sont modifiées, elles s’appliquent à tous les nouveaux incidents et aux incidents existants sans paramètres de notification personnalisés.
- Lorsqu’un nouvel incident est détecté par AppSignal, les valeurs par défaut d’espace de noms de l’application sont utilisées.
- Lorsque les paramètres de notification d’un incident sont personnalisés, les paramètres de notification personnalisés de l’incident sont utilisés à partir de ce moment.