Passer au contenu principal
L’application Slack d’AppSignal envoie des notifications en temps réel à vos canaux Slack lorsque des événements se produisent dans vos applications surveillées. Soyez notifié des erreurs, des requêtes lentes, des déploiements, des alertes de métriques, des alertes heartbeat, des alertes de moniteurs de processus et des alertes de logs sans quitter Slack. Les notifications sont bidirectionnelles. Le message d’un incident comporte des contrôles pour le fermer ou le rouvrir, changer ses assignés, ou définir sa sévérité, et AppSignal modifie le message chaque fois que l’incident change, que ce soit dans Slack ou dans AppSignal. Chaque action est enregistrée dans le journal de l’incident, sous votre utilisateur AppSignal lié. Site web : Slack.com
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

  1. Accédez à Notifications dans votre organisation AppSignal et sélectionnez Add new notifier.
  2. Choisissez Slack dans la liste des notificateurs.
  3. Sous Configure this integration, sélectionnez Install Slack notifier pour démarrer le flux d’autorisation Slack.
  4. Dans Slack, autorisez l’application AppSignal pour votre espace de travail et sélectionnez le canal dans lequel publier.
  5. Vous êtes redirigé vers AppSignal, où le notificateur apparaît sous Active notifiers.
  6. Sélectionnez Manage à côté du notificateur pour terminer sa configuration.
Si le canal est privé, ajoutez-y AppSignal.

Ouvrez vos paramètres de notification

Canaux privés

AppSignal publie dans un canal public dès que vous l’autorisez. Pour un canal privé, vous devez également ajouter AppSignal au canal directement dans Slack :
  1. Dans le canal privé, ouvrez le menu à trois points et sélectionnez Open channel details.
  2. Accédez à l’onglet Agents & apps.
  3. Recherchez « AppSignal » et sélectionnez Add to Channel.
Sélectionnez ensuite Test hook sur la page du notificateur pour vérifier que les messages arrivent.
Page du notificateur Slack dans AppSignal avec le bouton Test hook à côté de Save all changes

Bouton Test hook sur la page du notificateur

Configuration

Sélectionnez Manage à côté d’un notificateur sur la page Notifications pour le configurer. Settings for this notifier contient le nom du notificateur, par exemple « Erreurs critiques » ou « Alertes opérationnelles ». Edit configuration on Slack ouvre les paramètres du notificateur dans Slack. Capture des paramètres du notificateur Slack sur AppSignal.com Sous Settings for this notifier, la page comporte trois autres sections :
  • 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.
Les alertes des déclencheurs ne s’activent pas ici. Les déclencheurs d’anomaly detection, de log et de check-in choisissent chacun les notificateurs auxquels ils envoient, ajoutez donc ce notificateur sur le déclencheur lui-même. Capture des événements de notification d'un notificateur sur AppSignal.com Sélectionnez Save all changes. AppSignal vous ramène à la page Notifications. Pour tester le notificateur, sélectionnez Manage à côté de celui-ci, puis Test hook. Le bouton devient « Test message sent » une fois qu’AppSignal a envoyé le message. Test hook et View logs apparaissent dès que le notificateur couvre au moins une application. Depuis la même page, View logs ouvre les logs du notificateur, et Remove notifier le supprime. Les notificateurs sont valables pour toute l’organisation, et vous pouvez créer plusieurs notificateurs Slack pour envoyer différents événements vers différents canaux.

À 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.
AppSignal enregistre chaque action dans le journal de l’incident, sous l’utilisateur lié à votre compte Slack.

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.
Pour migrer un notificateur :
  1. Sur la page Notifications, sélectionnez Manage à côté du notificateur Slack.
  2. Dans la bannière de dépréciation, sélectionnez Migrate to the new Slack app, puis confirmez.
    Bannière de dépréciation Slack avec le bouton Migrate to the new Slack app

    Bannière de migration de l'application Slack

  3. Slack s’ouvre. Réautorisez l’application AppSignal à cet endroit.
Si le canal est privé, ajoutez-y AppSignal. Ensuite :
  • 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é.
Il n’est pas nécessaire de reconfigurer les alertes, et les notifications devraient continuer à arriver même pendant la migration.

Désinstallation

Pour supprimer l’intégration Slack, supprimez son notificateur depuis la page Notifications dans votre organisation AppSignal. Vous pouvez également supprimer l’application AppSignal de votre espace de travail Slack dans vos paramètres de gestion des applications Slack.

Liste des intégrations