Alertes Slack : envoyer les alertes Pingsured dans un canal
Pingsured peut publier une alerte dans un canal Slack quand un ping tombe en panne, quand il est rétabli et quand son certificat est remplacé. C’est un webhook qui parle Slack : vous donnez à Pingsured l’URL d’un webhook Slack, et chaque alerte arrive dans ce canal sous la forme d’un message lisible. Les alertes Slack sont disponibles dans les mêmes offres que les webhooks, c’est-à-dire toutes les offres payantes. Elles sont configurées par un propriétaire ou un gestionnaire du compte, pour un seul ping ou comme valeur par défaut de tous les pings du compte.
Ce qu’il vous faut
- Un espace de travail Slack dans lequel vous pouvez ajouter une app, ou un administrateur qui l’approuvera.
- Le canal où les alertes doivent arriver. Un webhook publie dans un seul canal ; pour alerter un second canal, créez un second webhook.
Créer le webhook dans Slack
Créez le webhook depuis une app Slack, et non depuis l’ancienne intégration « Incoming WebHooks » du répertoire d’apps de Slack. Slack ne la recommande plus et peut la retirer.
- Ouvrez
api.slack.com/appset choisissez Create New App, puis From scratch. Donnez-lui un nom, par exemple Pingsured, et choisissez votre espace de travail. - Dans les réglages de l’app, ouvrez Incoming Webhooks et activez-le.
- Choisissez Add New Webhook to Workspace, sélectionnez le canal et autorisez l’accès.
- Copiez la Webhook URL. Elle commence par
https://hooks.slack.com/services/.
Traitez l’URL comme un secret : quiconque la possède peut publier dans ce canal. Pingsured ne l’affiche en entier qu’aux propriétaires et aux gestionnaires.
L’ajouter dans Pingsured
- Pour tous les pings, ouvrez Paramètres → Notifications, allez à Intégrations sous Notifications par défaut et choisissez la carte Slack.
- Pour un seul ping, ouvrez le ping, allez à sa section Notifications, choisissez Ajouter un abonnement puis Slack.
Collez l’URL du webhook. Pingsured n’accepte que les adresses de Slack : l’URL d’un autre service est refusée à l’enregistrement. Choisissez ensuite les déclencheurs. Le réglage recommandé est Première erreur et Premier OK, avec Certificat changé si vous vérifiez les certificats : vous savez quand quelque chose tombe et quand c’est réparé.
Envoyer un test, à côté du canal, publie un message marqué comme test. C’est le moyen le plus rapide de vérifier que l’URL et le canal sont les bons avant qu’une alerte en dépende.
À quoi ressemble un message
- Un titre avec le nom du ping et un point de couleur : rouge en cas de panne, jaune s’il est dégradé, vert une fois rétabli.
- La raison, s’il y en a une : le statut HTTP, l’erreur ou la raison de l’échec d’une vérification de contenu.
- Où cela a été vu : l’emplacement, comme
Depuis de, ou, pour un ping vérifié depuis plusieurs, lesquels sont en échec, commeEn panne depuis de, sg (2 sur 3 emplacements). - Un lien, Voir le ping dans Pingsured, qui ouvre le ping.
Un changement de certificat s’écrit Certificat changé sur le ping, ou Certificat inattendu sur lui quand le changement ne ressemble pas à un renouvellement, avec les raisons en dessous.
La langue des messages
Les messages sont rédigés dans la langue des notifications du compte, qu’un propriétaire règle sous Paramètres → Compte. Ils existent en anglais, allemand, espagnol, français et italien. Tant qu’elle n’est pas réglée, ils sont en anglais. Le même réglage est la langue de repli des e-mails d’alerte pour les membres qui n’ont pas choisi la leur. La ligne de la raison s’affiche telle que le service vérifié l’a rapportée, dans sa langue.
Quand les messages sont envoyés
Un canal Slack suit les mêmes règles que tout autre canal d’alerte : quels changements, combien d’échecs d’abord, à quelle fréquence et depuis où sont décrits dans la page des notifications. Un changement d’état est toujours envoyé aussitôt, et les alertes répétées pour le même ping et le même canal sont retenues 15 minutes.
Si un message n’arrive pas
Quand Slack est injoignable ou répond par une erreur qui peut passer, l’envoi est retenté, 5 tentatives en tout, espacées de 30 secondes, 5 minutes, 30 minutes et 2 heures. Toute autre réponse de Slack est définitive. Slack répond par une courte raison, par exemple no_service quand le webhook a été supprimé ou channel_is_archived quand le canal a été archivé, et Pingsured affiche ce que Slack a dit en survolant le badge d’état à côté du canal dans Paramètres → Notifications. Le remède est le plus souvent un nouveau webhook : créez-le dans l’app Slack, ajoutez-le dans Pingsured et supprimez l’ancien.
Limites
- Les canaux Slack comptent avec les webhooks pour les mêmes limites : 50 pour tout le compte et 20 sur un ping.
- Les messages vont dans le canal pour lequel le webhook a été créé. Les mentions, les messages privés et les fils de discussion ne sont pas encore disponibles.