Documentation

Notifications : qui, quand et par quel canal

Pingsured vous notifie quand quelque chose change pour un ping : quand il tombe, quand il revient, quand un certificat est remplacé. Qui l’apprend, pour quels événements et par quel canal, ce sont les abonnements qui le fixent. Un abonnement relie un destinataire — un membre du compte ou un webhook — à un canal et aux événements pour lesquels il est notifié.

Les abonnements se trouvent à deux endroits. Les valeurs par défaut du compte couvrent tous les pings ; les propriétaires et les gestionnaires les fixent sous Paramètres → Notifications. La page de chaque ping comporte une section Notifications qui affiche ses destinataires effectifs et permet d’ajouter des abonnements pour ce seul ping.

Qui est notifié

Sont notifiés les membres du compte, chacun par un abonnement qui lui est propre, ainsi que les webhooks du compte. Personne n’est notifié du fait de son rôle : un gestionnaire sans abonnement n’apprend rien. Un nouveau compte démarre avec un abonnement, celui du propriétaire, par e-mail, pour tous les pings.

Destinataires effectifs, sur la page d’un ping, montre qui est notifié pour ce ping, par quel canal, et si c’est par la valeur par défaut du compte ou par un abonnement posé sur le ping lui-même.

  • Les valeurs par défaut du compte couvrent tous les pings du compte. Les propriétaires et les gestionnaires les fixent pour n’importe quel membre.
  • Un abonnement sur un ping remplace, pour ce ping, la valeur par défaut de ce membre sur ce canal — par exemple pour être notifié de chaque vérification en échec d’un ping critique. Les valeurs par défaut des autres membres continuent de s’y appliquer.
  • Qui peut abonner qui. Chaque membre, lecteurs compris, peut s’abonner lui-même à un ping avec M’abonner par e-mail et modifier ses propres abonnements. Les propriétaires et les gestionnaires peuvent abonner d’autres membres et ajouter des webhooks.
  • Les personnes extérieures au compte ne peuvent pas être abonnées par e-mail, pas plus qu’une personne invitée qui n’a pas encore accepté. Pour joindre une astreinte, une boîte partagée ou un canal de discussion, utilisez un webhook.
  • Un membre de plusieurs comptes voit le nom du compte dans l’objet de chaque e-mail d’alarme, et son bouton ouvre le ping dans le bon compte.

Quand vous êtes notifié

Un abonnement indique les événements pour lesquels il notifie, ses déclencheurs :

DéclencheurNotifie quand
Première erreurle ping commence à échouer
Premier avertissementle ping commence à afficher un avertissement
Premier OKle ping est de nouveau OK après une erreur ou un avertissement
Certificat changéune vérification TLS voit un autre certificat
Toute erreur, Tout avertissement, Tout OKà chaque vérification ayant ce résultat
Premier inconnu, Tout inconnunous n’avons pas pu vérifier le ping

La sélection recommandée est Première erreur, Premier OK et Certificat changé : vous apprenez quand quelque chose casse, quand c’est réparé et quand un certificat est remplacé. L’abonnement du propriétaire d’un nouveau compte démarre exactement avec ceux-là.

Un changement d’état est envoyé immédiatement. Les déclencheurs Tout notifient à chaque vérification correspondante, pas seulement lors d’un changement, et peuvent donc être bruyants : les notifications répétées pour un même ping et un même canal sont retenues pendant 15 minutes. « Inconnu » renseigne sur notre côté plutôt que sur votre site, c’est pourquoi il ne fait pas partie de la sélection recommandée.

Quand un ping est considéré en échec

C’est le seuil d’alarme qui décide si un ping « commence à échouer » : « déclencher après M vérifications en échec sur les N dernières ». Avec 1 sur 1, la valeur par défaut, une seule vérification en échec suffit. Avec 3 sur 5, une réponse isolée lente ou perdue ne suffit pas, et une panne est quand même signalée dès que trois vérifications sur cinq l’ont constatée. Les deux nombres vont jusqu’à 50.

La page indique ce que cela représente dans le temps. Pour un ping vérifié toutes les 5 minutes, 3 sur 5 notifie entre 15 et 25 minutes après le début d’une panne, selon que celle-ci est continue ou non.

Le seuil de rétablissement fonctionne de la même manière pour les vérifications réussies. Il reprend le seuil d’alarme tant que Identique à l’alarme est activé. Un seuil de rétablissement de 2 sur 2, par exemple, évite qu’un site qui revient le temps d’une vérification puis retombe vous envoie entre-temps un message de fin d’incident.

Ce qui compte :

  • Une vérification qui échoue est une erreur. Un avertissement ne vient que des vérifications TLS : un certificat entré dans sa période d’avertissement, ou un constat sur sa configuration. Les deux comptent comme un échec, et un ping passe de l’avertissement à l’erreur, ou l’inverse, selon le seuil d’alarme.
  • Les vérifications sont comptées par intervalle de vérification. Un résultat que nous n’avons pas pu obtenir — la vérification a dépassé son délai de notre côté ou n’a pas eu lieu — est inconnu : il ne compte ni comme un échec ni comme une réussite, et à lui seul il ne change jamais l’état d’un ping.
  • Chaque emplacement est jugé séparément, avec le seuil du ping, et un ping échoue dès qu’il échoue depuis l’un quelconque de ses emplacements. Un emplacement qui perd sa route vers votre site suffit à vous notifier ; les autres, qui l’atteignent encore, ne le masquent pas.
  • Un ping dont les emplacements se relaient n’a pas de seuil : c’est le dernier résultat de chaque emplacement qui décide.

Le seuil appartient au ping, pas à un abonnement : toutes les personnes abonnées à un ping sont notifiées au même moment. Un ping sans abonnement propre utilise le seuil du compte. Un ping qui a ses propres abonnements a son propre seuil, affiché et modifié dans sa section Notifications ; au premier abonnement, il reprend celui du compte. Les propriétaires et les gestionnaires peuvent le modifier.

Par quel canal

CanalOffresOù la notification arrive
E-mailtoutes les offresà l’adresse e-mail du membre
Sur le webtoutes les offresdans Notifications, dans le menu utilisateur de l’application, compté sur son badge et mis à jour en direct tant que l’application est ouverte
Webhookà partir de Teamà une adresse HTTPS de votre choix ; voir la page sur les alertes par webhook

Un webhook est ajouté par un propriétaire ou un gestionnaire, pour le compte ou pour un seul ping, et Envoyer un test lui adresse aussitôt une notification de test. Un compte peut avoir plusieurs webhooks — un outil de gestion d’incidents et un canal de discussion, par exemple, chacun avec ses propres déclencheurs —, et les webhooks d’un ping s’ajoutent à ceux du compte. Un webhook de ping ayant la même adresse qu’un webhook du compte remplace celui-ci pour ce ping.

Arrêter les notifications

Chaque e-mail d’alarme se termine par Se désabonner des alertes de ce ping. Le lien arrête vos e-mails d’alarme pour ce ping, et pour lui seul : votre valeur par défaut du compte continue de couvrir les autres. Pour vous réabonner, passez par la page du ping. Je n’aurais pas dû recevoir ceci nous signale qu’un e-mail ne vous était pas destiné.

Pour arrêter tous les e-mails d’alarme d’un compte, désactivez E-mails d’alarme dans Mes préférences d’e-mail (Notifications, dans le menu utilisateur). Les notifications sur le web continuent d’y arriver.

Quand un membre quitte le compte, ses abonnements partent avec lui.

Pas encore disponible

  • Les notifications par SMS, et les notifications envoyées directement dans un outil de discussion. Pour ces dernières, une plateforme d’automatisation placée entre un webhook et l’outil fait l’affaire dès aujourd’hui.