L’application Slack est une fonctionnalité en beta d’AppSignal Labs. Si vous avez configuré un notificateur Slack avant sa sortie, consultez Migrer un notificateur existant.
Installation
- Accédez à Notifications dans votre organisation AppSignal et sélectionnez Add new notifier.
- Choisissez Slack dans la liste des notificateurs.
- Sous Configure this integration, sélectionnez Install Slack notifier pour démarrer le flux d’autorisation Slack.
- Dans Slack, autorisez l’application AppSignal pour votre espace de travail et sélectionnez le canal dans lequel publier.
- Vous êtes redirigé vers AppSignal, où le notificateur apparaît sous Active notifiers.
- Sélectionnez Manage à côté du notificateur pour terminer sa configuration.
Ouvrez vos paramètres de notification
Configuration
Sélectionnez Manage à côté d’un notificateur sur la page Notifications pour le configurer. La page comporte quatre sections :- Settings for this notifier — le nom du notificateur, par exemple « Erreurs critiques » ou « Alertes opérationnelles ». Edit configuration on Slack ouvre les paramètres du notificateur dans Slack.
- Scope notifier to the following apps — les applications et environnements couverts par ce notificateur.
- Enable notifier for new applications — une fois activé, chaque application et environnement que vous ajoutez par la suite utilise ce notificateur par défaut.
- Send notifications for the following events — déploiements, erreurs et traces de performance. Les erreurs et les performances peuvent être filtrées par namespace : sélectionnez les namespaces souhaités, ou désélectionnez-les tous pour couvrir tous les namespaces.
À quoi ressemblent les notifications
Chaque notification Slack inclut des détails contextuels sur l’événement :- Les erreurs incluent le nom de l’exception, le message, les premières lignes du backtrace, l’action et le chemin de la requête.
- Les traces de performance incluent le nom de l’action, la durée, la méthode et le chemin de la requête.
- Les marqueurs de déploiement incluent la révision (avec un lien pour comparer les changements lorsque disponible), le namespace et l’utilisateur qui déploie.
- Les alertes de métriques incluent le nom du déclencheur, la valeur actuelle, les tags et un lien vers l’alerte dans AppSignal.
- Les alertes heartbeat et de moniteurs de processus incluent l’identifiant et l’heure d’achèvement attendue.
- Les alertes de logs incluent le nom du déclencheur, la sévérité et le message de log correspondant.
Ce que vous pouvez faire depuis une notification
Les notifications d’incidents d’erreur et de performance comportent des contrôles. Les marqueurs de déploiement et les alertes sont publiés sans contrôles.- Close incident — ferme l’incident. Le message affiche alors « Closed by » suivi de votre nom, et le bouton devient Reopen incident.
- Reopen incident — rouvre un incident fermé.
- Change assignees — ouvre une boîte de dialogue listant les membres de cette application. Recherchez par nom et sélectionnez-en autant que nécessaire.
- Change severity — ouvre une boîte de dialogue pour définir la sévérité de l’incident : non triée, critique, élevée, faible ou informative.
Les messages restent à jour
AppSignal modifie un message Slack lorsque l’incident qu’il décrit change d’état, de sévérité ou d’assignés. Les modifications que vous effectuez dans AppSignal comptent également. Un canal reflète alors l’état actuel de vos applications, et non une liste d’alertes déjà traitées.Lier votre compte Slack
AppSignal a besoin de savoir quel utilisateur AppSignal se cache derrière une action Slack. La première fois que vous en utilisez une, AppSignal vous demande de lier votre compte Slack, puis applique l’action que vous avez sélectionnée. Vos actions suivantes s’appliquent immédiatement. Les actions disponibles sont limitées aux permissions de l’utilisateur lié. Si l’utilisateur n’a pas accès à l’application, l’action demandée est refusée.Autorisations demandées par AppSignal
Pendant l’autorisation, l’application Slack d’AppSignal demande :incoming-webhook— l’accès au canal que vous sélectionnez pendant l’autorisation.chat:write— publier des messages et les modifier ensuite.chat:write.public— publier dans un canal public sans avoir à y ajouter l’application au préalable.
Migrer un notificateur existant
Les notificateurs Slack configurés avant la sortie de l’application Slack actuelle continuent d’envoyer des notifications. Ils sont dépréciés, et vous devez les migrer pour obtenir les contrôles d’incident et les mises à jour de message.Si vous devez encore migrer l’application Slack, une bannière s’affiche tant que vous êtes sur la page Notifications. Si la bannière ne s’affiche pas et que vous avez des notificateurs Slack activés, vous utilisez déjà la bonne version.
- Sur la page Notifications, sélectionnez Manage à côté du notificateur Slack.
- Dans la bannière de dépréciation, sélectionnez Migrate to Modern Slack, puis confirmez.
- Slack s’ouvre. Réautorisez l’application AppSignal à cet endroit.
- Le nom du notificateur, ses applications, ses types de notification, ses filtres de namespace et son paramètre « enable for new apps » sont conservés.
- Chaque alerte de métrique, moniteur de disponibilité, moniteur heartbeat et de processus, et alerte de log qui utilisait le notificateur est repointé vers le nouveau.
- Le notificateur précédent est supprimé.