Documentation

Alertes Discord : les alertes Pingsured dans un canal

Pingsured peut publier une alerte dans un canal Discord quand un ping se met à échouer, quand il se rétablit et quand son certificat est remplacé. C’est un webhook qui parle Discord : vous donnez à Pingsured l’URL d’un webhook Discord, et chaque alerte arrive comme un message dans ce canal. Les alertes Discord sont disponibles avec les mêmes offres que les webhooks, toutes les offres payantes. Un propriétaire ou un gestionnaire du compte les configure, pour un seul ping ou par défaut pour tous les pings du compte.

Ce qu’il vous faut

  • Un serveur Discord sur lequel vous pouvez gérer les webhooks (la permission Gérer les webhooks), et le canal où les alertes doivent aller. Un webhook publie dans un seul canal ; pour alerter dans un second, créez un second webhook.

Créer le webhook dans Discord

  • Dans Discord, ouvrez les paramètres du canal (la roue dentée à côté de son nom), allez dans Intégrations, puis Webhooks, et choisissez Nouveau webhook.
  • Donnez-lui un nom et, si vous le souhaitez, une icône, par exemple Pingsured, et vérifiez que le canal est le bon.
  • Choisissez Copier l’URL du webhook. Elle ressemble à https://discord.com/api/webhooks/…/….

Discord change de temps en temps le nom de ses menus. Ce dont Pingsured a besoin, c’est de l’URL d’un webhook.

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. Si elle fuit, supprimez le webhook dans Discord et créez-en un autre.

L’ajouter dans Pingsured

  • Pour tous les pings, ouvrez Paramètres → Notifications, allez à Intégrations sous Notifications par défaut et choisissez la carte Discord.
  • Pour un seul ping, ouvrez le ping, allez à sa section Notifications, choisissez Ajouter un abonnement et sélectionnez Discord.

Collez l’URL du webhook en entier, jeton compris. Pingsured n’accepte que les adresses des webhooks Discord (sur discord.com, sous /api/webhooks/) ; l’URL d’un autre service, ou une URL coupée avant son jeton, est refusée à l’enregistrement. Choisissez ensuite les déclencheurs. L’ensemble recommandé est Première erreur et Premier ok, avec Certificat changé si vous surveillez des certificats : vous savez quand quelque chose casse et quand c’est réparé.

Choisissez Envoyer un test à côté du canal pour publier 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 message avec une barre colorée et un titre formé du nom du ping et d’un point qui indique son état : rouge en cas d’échec, jaune s’il est dégradé, vert une fois rétabli.
  • La raison, quand il y en a une : le statut HTTP, l’erreur, ou pourquoi une vérification de contenu a échoué.
  • D’où cela a été vu : soit l’emplacement, comme Depuis de, soit, pour un ping vérifié depuis plusieurs, lesquels échouent, comme En panne depuis de, sg (2 sur 3 emplacements).
  • Un lien, Voir le ping dans Pingsured, qui ouvre le ping.

Un changement de certificat s’intitule Certificat changé sur le ping, ou Certificat inattendu sur celui-ci quand le changement ne ressemble pas à un renouvellement, avec les raisons en dessous.

Les messages ne mentionnent personne : un ping nommé @everyone, ou un texte d’erreur contenant une mention, s’affiche comme du texte et ne notifie personne au-delà de ce que fait le canal lui-même pour un nouveau message.

La langue des messages

Les messages sont écrits dans la langue des notifications du compte, qu’un propriétaire définit dans Paramètres → Compte. Ils existent en anglais, allemand, espagnol, français et italien. Tant qu’elle n’est pas définie, ils sont en anglais. Le même réglage sert de langue de repli aux e-mails d’alerte des membres qui n’ont pas choisi la leur. La ligne de raison s’affiche telle que le service vérifié l’a rapportée, dans sa langue.

Quand les messages sont envoyés

Un canal Discord 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 de statut est toujours envoyé aussitôt, et les alertes répétées pour le même ping et le même canal sont retenues pendant 15 minutes.

Si un message n’arrive pas

Quand Discord est injoignable, limite le débit de la requête ou répond par une erreur qui peut passer, l’envoi est réessayé, 5 tentatives en tout, espacées de 30 secondes, 5 minutes, 30 minutes et 2 heures. Toute autre réponse est définitive, et Pingsured affiche ce que Discord a répondu quand vous survolez le badge d’état à côté du canal dans Paramètres → Notifications. La plus courante est Unknown Webhook : le webhook a été supprimé dans Discord. Le remède est un nouveau webhook : créez-le dans Discord, ajoutez-le dans Pingsured et retirez l’ancien.

Limites

  • Les canaux Discord comptent avec les webhooks pour les mêmes limites : 50 pour tout le compte et 20 sur un ping.
  • Les messages sont publiés sous le nom et l’icône que le webhook a dans Discord. Les mentions et les messages privés ne sont pas encore disponibles.