Centre d'aide / Alertes

Alertes et canaux

E-mail, Slack, Discord, Teams, Telegram, webhooks, ntfy, Pushover, PagerDuty et Opsgenie ; règles, escalade et heures calmes.

Canaux

Un canal, c'est l'endroit où partent les alertes. Ajoutez-les sur la page Alertes :

CanalCe qu'il vous faut
E-mailUne ou plusieurs adresses. Les adresses qui n'appartiennent pas à des membres de votre équipe reçoivent d'abord un lien de confirmation.
SlackUne URL de webhook entrant. Dans Slack : Apps › Incoming Webhooks › Add to Slack, choisissez le canal et copiez la Webhook URL.
DiscordUne URL de webhook de salon (Paramètres du salon › Intégrations › Webhooks).
Microsoft TeamsUne URL de workflow Teams ou de webhook entrant.
TelegramLancez une conversation avec le bot Pingerer (ou ajoutez-le à votre groupe), puis saisissez l'identifiant de la conversation, ou @channelname pour un canal public où le bot est administrateur.
WebhookVotre adresse HTTPS. Nous signons chaque requête (voir plus bas).
SMSUn numéro de mobile vérifié. Voir Alertes SMS et crédits.
ntfyUn sujet auquel vous êtes abonné dans l'application ntfy, sur ntfy.sh ou sur votre propre serveur, et un jeton d'accès si le sujet est protégé. Les pannes sont envoyées en priorité urgente.
PushoverVotre clé utilisateur Pushover (en haut de pushover.net une fois connecté), et un nom d'appareil si vous ne voulez les recevoir que sur un seul. Les pannes sont envoyées en priorité haute.
PagerDutyUne clé d'intégration Events API V2 (Services › votre service › Integrations). Un incident ouvre un incident PagerDuty et le résout quand le site est rétabli.
OpsgenieLa clé d'une intégration API (Teams › votre équipe › Integrations › API), et si votre Opsgenie est aux États-Unis ou dans l'UE. Un incident ouvre une alerte Opsgenie et la ferme quand le site est rétabli.
Notifications téléphone et navigateurRien à configurer, et gratuit. Toutes les personnes du compte qui activent les notifications, ou celles que vous choisissez, reçoivent les alertes sous forme de notifications sur leur ordinateur ou leur téléphone, et dans l'application Pingerer là où elles sont connectées. Chacun peut désactiver un appareil dans Vos appareils.

Utilisez Envoyer un test après avoir ajouté un canal. Si un canal échoue cinq fois de suite, il est signalé comme défaillant sur la page Alertes pour que vous puissiez le réparer.

Notifications sur votre ordinateur ou votre téléphone

Pingerer peut afficher une notification sur votre écran quand quelque chose ne va plus, même quand Pingerer n'est pas ouvert. C'est gratuit et cela n'utilise pas de crédits SMS. Chacun l'active pour lui-même, sur chaque appareil :

  1. Ouvrez la page Alertes sur cet ordinateur ou ce téléphone et descendez jusqu'à Notifications sur vos appareils.
  2. Cliquez sur Activer les notifications sur cet appareil, puis choisissez Autoriser quand votre navigateur vous le demande.
  3. Cliquez sur Envoyer une notification de test pour en voir une.

Cela fonctionne dans Chrome, Edge, Firefox et Safari sur ordinateur et sur les téléphones Android. Sur un iPhone ou un iPad, ajoutez d'abord Pingerer à votre écran d'accueil : dans Safari, touchez le bouton Partager, puis Sur l'écran d'accueil, et ouvrez Pingerer depuis là. Si vous avez bloqué les notifications par erreur, cliquez sur l'icône juste à gauche de l'adresse web, réglez Notifications sur Autoriser et rechargez la page.

Les notifications vont à toutes les personnes incluses dans un canal Notifications téléphone et navigateur. Si votre compte n'en a pas encore, il en reçoit un dès que la première personne active les notifications, pour les pannes, les rétablissements, les lenteurs et les heartbeats manqués sur tous les sites. Une panne reste à l'écran jusqu'à ce que vous la fermiez, et un clic sur une notification ouvre l'incident.

Sur l'écran verrouillé de votre iPhone

Avec l'application Pingerer pour iPhone (iOS 17.2 et plus récent) et ses notifications activées, un site qui tombe en panne s'affiche sur votre écran verrouillé et dans la Dynamic Island : son adresse, ce que nous avons constaté et un compteur indiquant depuis combien de temps il est hors ligne. Quand il revient, il passe au vert (« De nouveau en ligne après 14 min ») et disparaît quelques minutes plus tard. Touchez-le pour ouvrir l'incident.

Quand Pingerer est ouvert

L'icône de l'onglet de votre navigateur affiche un point vert, orange ou rouge, et une barre traverse le haut de la page quand un site tombe en panne ou revient. Activez Jouer un son discret ici dans Notifications sur vos appareils pour l'entendre aussi. Plus de raccourcis.

Règles : quels sites, quels événements

Chaque canal a ses règles : tous les sites (y compris ceux que vous ajouterez plus tard) ou certains sites choisis, et quels événements : hors ligne, dégradé (lent), SSL ou domaine qui expire, DNS modifié, problèmes de configuration e-mail, heartbeats manqués et santé du site (un nouveau problème critique dans la vérification hebdomadaire). Les messages de rétablissement vont aux canaux qui ont été prévenus du problème.

Ce que dit une alerte

Chaque alerte indique ce qui a échoué, comment (par exemple « 502 Bad Gateway depuis 3 régions »), quand cela a commencé et ce que cela signifie en général. Un e-mail d'alerte de panne propose aussi Mettre en pause 1 heure, pour quand vous travaillez déjà sur le site, et Prévenir vos clients quand l'une de vos pages de statut publiées affiche ce site : cela ouvre une mise à jour de statut préremplie à partir de la panne. Quand un site revient, le message de rétablissement indique la cause probable si son hébergeur, son CDN ou son créateur de site avait des soucis au même moment. L'ouverture puis la confirmation d'un incident envoient une seule alerte, pas deux ; vous en recevez une de plus au rétablissement. Quand un site tombe en panne, ses vérifications de disponibilité, de port et de ping le remarquent généralement toutes : vous ne recevez quand même qu'une alerte, et une de plus quand la dernière est de nouveau en ligne.

Quand c'est votre hébergeur, pas vous

Quand beaucoup d'autres sites chez le même hébergeur, le même CDN ou le même créateur de site tombent en panne en même temps que le vôtre, l'alerte indique que c'est probablement cette entreprise, et si cela ne devient clair que quelques minutes plus tard, vous recevez un court message de suivi. Voir Est-ce mon hébergeur ? La météo d'Internet.

Quand un site n'arrête pas de tomber et de revenir

Si une surveillance tombe en panne pour la 3e fois en 120 minutes, nous arrêtons de traiter chaque rebond comme un nouveau problème. Son incident reste ouvert jusqu'à ce que les vérifications réussissent pendant 30 minutes d'affilée, et la chronologie explique pourquoi. Vous recevez une alerte quand le site tombe et une quand il s'est stabilisé, au lieu d'une paire à chaque rebond.

Beaucoup d'alertes d'un coup

Après 30 e-mails d'alerte en une heure, nous retenons les alertes e-mail suivantes et les envoyons une heure plus tard en un seul e-mail récapitulatif par canal, qui liste chaque alerte et les incidents encore ouverts. Les autres canaux, comme Slack, les SMS et les notifications, ne sont pas concernés.

Prendre en charge

Cliquez sur Prendre en charge dans une alerte (ou sur l'incident) pour que votre équipe sache que quelqu'un s'en occupe. La prise en charge arrête l'escalade pour cet incident.

Escalade

Donnez à une règle un délai « escalader après » pour en faire une règle d'escalade : ce canal n'est prévenu que si un incident n'a toujours pas été pris en charge après ce nombre de minutes. Par exemple, envoyez un e-mail à l'équipe tout de suite, et un SMS au responsable si personne ne l'a pris en charge au bout de 15 minutes.

Plannings d'astreinte

Avec le forfait Payant, une équipe peut assurer l'astreinte à tour de rôle. Ouvrez Astreinte, créez un planning, numérotez les membres de votre équipe dans l'ordre de leur tour, et choisissez quand le relais se fait (par exemple chaque lundi à 9 h, dans votre fuseau horaire). Chaque planning indique qui est d'astreinte maintenant et ensuite, ainsi que la semaine à venir. Ajoutez un remplacement quand quelqu'un prend le relais pour un temps, comme un échange ou des vacances.

Un planning apparaît sur la page Alertes comme un canal appelé « On call: nom ». Cochez-le pour les sites qu'il doit couvrir, ou choisissez-le dans Escalader vers pour alerter la personne d'astreinte seulement si personne ne prend en charge à temps. Nous envoyons un e-mail à la personne d'astreinte, et aussi un SMS si elle a ajouté et vérifié son téléphone sur la page Astreinte (les SMS utilisent les crédits SMS du compte).

Heures calmes

Définissez des heures calmes (par exemple de 22 h à 7 h) pour retenir jusqu'au matin les alertes moins urgentes, comme les certificats qui expirent ou les changements DNS. Les pannes et les heartbeats manqués passent toujours, sauf si vous avez indiqué qu'un site peut attendre : sur sa page, sous La nuit, choisissez Ça peut attendre le matin pour un projet perso ou un site de test, et ses alertes de panne attendront aussi la fin des heures calmes. Une alerte retenue dont le problème se règle tout seul avant le matin n'est jamais envoyée. Vous pouvez aussi toutes les retenir le week-end. Choisissez votre week-end à côté des heures calmes : samedi et dimanche, vendredi et samedi, ou un seul jour. Si vous ne touchez à rien, nous prenons ce qui est habituel dans votre fuseau horaire (vendredi et samedi dans le Golfe). Les développeurs peuvent aussi lire et modifier les heures calmes et le week-end avec l'API.

Ce que reçoit un webhook

Un canal webhook reçoit un POST JSON pour chaque alerte. L'en-tête X-Pingerer-Event indique de quel événement il s'agit :

  • opened : quelque chose ne va pas. confirmed et escalated suivent quand d'autres régions le confirment ou que personne ne l'a pris en charge à temps.
  • recovered : tout refonctionne.
  • update : votre site est toujours hors ligne, et depuis notre premier message, beaucoup d'autres sites chez le même hébergeur, CDN ou créateur de site sont tombés aussi, donc c'est probablement eux, pas vous. Vous en recevez au plus un par incident, et seulement sur les canaux prévenus de la panne.
  • test : vous avez appuyé sur Envoyer un test.
{
  "event": "update",
  "test": false,
  "incident": {"id": "inc_2bQ7", "reference": "INC-0042", "kind": "down", "state": "open",
               "cause": "Connection timed out", "opened_at": "...", "resolved_at": null, "url": "..."},
  "site": {"id": "site_4xT9", "name": "Online shop", "host": "shop.yourbakery.com", "url": "..."},
  "monitor": {"id": "mon_8xKq2", "name": "Homepage", "kind": "http", "target": "..."},
  "account": {"id": "acct_7Hd2k", "name": "Your Bakery"},
  "summary": {"badge": "UPDATE", "subject": "...", "headline": "It's probably Cloudflare, not you", "text": "..."},
  "provider_trouble": {"kind": "cdn", "name": "Cloudflare"},
  "delivery_id": 81723,
  "sent_at": "..."
}

provider_trouble n'est présent que lorsque le site est hors ligne et que son hébergeur en est la cause probable (comment nous le savons). kind vaut hosting, cdn ou platform (un créateur de site comme Shopify ou Wix). Il n'indique jamais combien d'autres sites sont tombés, ni lesquels. Les incidents de l'API ont le même champ provider_trouble. La description complète se trouve sous webhooks dans /openapi.yaml.

Signatures des webhooks

Les requêtes webhook sont des POST JSON avec un en-tête X-Pingerer-Signature du type t=1760000000,v1=5257a8.... Pour en vérifier une, calculez un HMAC-SHA256 de "#{t}.#{body}" avec le secret de votre canal et comparez-le à v1 ; rejetez les requêtes dont le t date de plus de quelques minutes.

expected = OpenSSL::HMAC.hexdigest("SHA256", secret, "#{t}.#{request.raw_post}")
ActiveSupport::SecurityUtils.secure_compare(expected, v1)

Votre point de situation

En plus des alertes, Pingerer peut vous envoyer un point de situation hebdomadaire ou quotidien : ce qui s'est passé, ce qui demande votre attention et ce qui arrive, en termes simples, avec en option une courte note tout en haut. Voir Votre point de situation.

Toujours bloqué ? Écrivez-nous, une vraie personne vous répondra.