Comment envoyer les alertes HostTracker vers Slack

Comment fonctionne l'intégration

Quand vous ajoutez un nouveau contact dans HostTracker et choisissez Slack dans le sélecteur de type de contact, vous ne créez pas un genre de contact différent en coulisses. Il est stocké comme un contact HTTP, et HostTracker le reconnaît comme une destination Slack parce que l'adresse que vous avez collée commence par https://hooks.slack.com/. C'est ce seul détail qui bascule le format du message d'une charge utile JSON générique vers un message compatible Slack, ce qui explique pourquoi la configuration ne demande qu'une URL et rien d'autre à régler.

Configurer les alertes Slack pas à pas

1. Dans Slack, ouvrez api.slack.com/apps et choisissez Create New App, puis From scratch. Donnez-lui un nom tel que « HostTracker alerts » et choisissez l'espace de travail où vous voulez que les alertes atterrissent.
2. Dans les paramètres de l'application, ouvrez Incoming Webhooks et activez-le.
3. Cliquez sur Add New Webhook to Workspace, choisissez le canal qui doit recevoir les alertes HostTracker, et cliquez sur Allow.
4. Slack génère une URL de webhook commençant par https://hooks.slack.com/services/. Copiez-la.
5. Dans HostTracker, ajoutez un nouveau contact et choisissez Slack dans la liste des types de contact, puis collez l'URL du webhook dans le champ d'adresse.
6. Enregistrez le contact, puis utilisez Send test pour confirmer qu'un message de test arrive dans le canal avant de vous y fier.

Si vous avez déjà un webhook créé via l'ancien flux de répertoire d'applications de Slack, désormais obsolète, son URL fonctionne toujours telle quelle ; collez-la de la même façon. Un tout nouveau webhook doit passer par le flux basé sur l'application ci-dessus, car Slack a retiré l'ancien flux pour les nouvelles configurations.

À quoi ressemble une alerte dans le canal

Chaque alerte arrive sous forme d'un court message en texte brut, pas d'une carte formatée. Une alerte Down nomme le site, l'heure, et une description de l'échec, par exemple un timeout de connexion ou un code d'erreur HTTP. Une alerte Up nomme le site, l'heure de sa récupération, et depuis combien de temps il était en panne. Un rappel toujours-en-panne répète la durée de la panne et l'erreur, pour que vous puissiez voir si quelque chose a changé sans ouvrir HostTracker.

Si plusieurs de vos moniteurs échouent dans une courte fenêtre, HostTracker peut les combiner en un seul message plutôt que d'en publier un après l'autre. C'est l'option « Group events » sur le contact. Les utilisateurs plus avancés peuvent aussi remplacer le message par défaut par un modèle personnalisé, tant qu'il reste du JSON de webhook Slack valide avec un champ text.

Choisir quels événements atteignent le canal

Un contact Slack, comme tout autre contact, s'abonne à des moniteurs spécifiques et à des types d'événements spécifiques plutôt qu'à tout votre compte. Il y a trois événements au choix : Down (le site vient de tomber en panne), Up (le site a récupéré), et Repeat (un rappel qu'il est toujours en panne). Un schéma courant consiste à router Down et Up vers un canal d'équipe partagé pour que tout le monde voie le début et la fin d'un incident, et à laisser Repeat désactivé si les rappels feraient du bruit, ou activé pour un canal dédié à un incident qui nécessite une attention constante jusqu'à sa résolution.

Dépannage

Quelques éléments cassent une intégration Slack sans aucun signe visible, car Slack ne transmet pas à HostTracker une erreur qu'il pourrait vous montrer dans l'application :

• Un webhook révoqué ou supprimé. Si l'application Slack a été retirée ou que le webhook a été régénéré, l'ancienne URL cesse d'accepter les publications. HostTracker continue de lui envoyer et la livraison échoue, sans aucun avis dans HostTracker indiquant que le canal est devenu silencieux. Relancez Send test chaque fois que quelqu'un touche aux paramètres de l'application Slack, ou périodiquement par habitude.
• Le mauvais canal. Un Incoming Webhook est lié au canal que vous avez choisi lors de sa création et ne peut pas être redirigé par la suite. Si les alertes atterrissent au mauvais endroit, créez un nouveau webhook pour le bon canal dans Slack et collez la nouvelle URL dans le contact.
• Un canal archivé. Slack cesse d'accepter les publications de webhook une fois le canal de destination archivé. Désarchivez-le, ou créez un nouveau webhook pointé vers un canal actif différent et mettez le contact à jour.
• Aucune permission d'ajouter des applications. Certains espaces de travail Slack restreignent qui peut installer de nouvelles applications ou approuver l'accès aux webhooks. Si l'étape 1 ou 3 ci-dessus est grisée ou bloquée, demandez à un administrateur de l'espace de travail de créer le webhook pour vous ou de vous accorder la permission de gérer les applications.

Rien de tout cela n'apparaît comme une erreur à l'intérieur de HostTracker lui-même. Le contact continue de paraître enregistré et actif, puisque HostTracker n'a aucun moyen de savoir que Slack a rejeté une livraison de son côté. Utiliser Send test après tout changement côté Slack est le seul moyen fiable de confirmer que le canal reçoit toujours les alertes.

Lecture complémentaire

Slack fonctionne mieux comme un canal parmi d'autres dans une configuration de notification plus large plutôt que le seul. Voir la liste complète des canaux et comment construire une simple chaîne d'escalade dans comment recevoir des alertes de HostTracker. Pour ce que HostTracker vérifie avant de décider que votre site est en panne, voir les fonctionnalités HostTracker et la surveillance de disponibilité distribuée.

• Tous les guides de surveillance - le centre pour chaque type de vérification qui peut publier sur Slack.
• Le site est-il en panne pour tout le monde ou juste pour moi - quoi faire en premier quand un message Down arrive dans le canal.
• Fonctionnalités HostTracker
• Surveillance de disponibilité distribuée
• Comment recevoir des alertes de HostTracker