Hilfe-Center / Benachrichtigungen

Benachrichtigungen und Kanäle

E-Mail, Slack, Discord, Teams, Telegram, Webhooks, ntfy, Pushover, PagerDuty und Opsgenie; Regeln, Eskalation und Ruhezeiten.

Kanäle

Ein Kanal ist ein Ort, an den Benachrichtigungen gehen. Sie richten Kanäle auf der Seite Benachrichtigungen ein:

KanalWas Sie brauchen
E-MailEine oder mehrere Adressen. Adressen, die nicht zu Ihren Teammitgliedern gehören, bekommen zuerst einen Bestätigungslink.
SlackEine Incoming-Webhook-URL. In Slack: Apps › Incoming Webhooks › Add to Slack, den Kanal wählen und die Webhook-URL kopieren.
DiscordEine Webhook-URL des Kanals (Kanaleinstellungen › Integrationen › Webhooks).
Microsoft TeamsEine Teams-Workflow- oder Incoming-Webhook-URL.
TelegramStarten Sie einen Chat mit dem Pingerer-Bot (oder fügen Sie ihn Ihrer Gruppe hinzu) und geben Sie dann die ID des Chats ein, oder @channelname für einen öffentlichen Kanal, in dem der Bot Admin ist.
WebhookIhr HTTPS-Endpunkt. Wir signieren jede Anfrage (siehe unten).
SMSEine bestätigte Handynummer. Siehe SMS-Benachrichtigungen und Guthaben.
ntfyEin Topic, das Sie in der ntfy-App abonniert haben, auf ntfy.sh oder Ihrem eigenen Server, und ein Zugriffstoken, falls das Topic geschützt ist. Ausfälle werden mit höchster Priorität gesendet.
PushoverIhr Pushover-User-Key (oben auf pushover.net, sobald Sie angemeldet sind) und ein Gerätename, falls die Nachricht nur auf einem Gerät ankommen soll. Ausfälle werden mit hoher Priorität gesendet.
PagerDutyEin Integration Key für die Events API V2 (Services › Ihr Service › Integrations). Eine Störung öffnet einen PagerDuty-Incident und schließt ihn, sobald alles wieder läuft.
OpsgenieDer Key einer API-Integration (Teams › Ihr Team › Integrations › API) und ob Ihr Opsgenie in den USA oder der EU liegt. Eine Störung öffnet einen Opsgenie-Alert und schließt ihn, sobald alles wieder läuft.
Handy- und Browser-BenachrichtigungenNichts einzurichten, und kostenlos. Alle im Konto, die Benachrichtigungen einschalten, oder die Personen, die Sie auswählen, bekommen Benachrichtigungen auf ihrem Computer oder Handy und in der Pingerer-App, wo sie angemeldet sind. Jede Person kann ein Gerät unter Ihre Geräte ausschalten.

Nutzen Sie Test senden, nachdem Sie einen Kanal hinzugefügt haben. Schlägt ein Kanal fünfmal hintereinander fehl, wird er auf der Seite Benachrichtigungen als fehlerhaft markiert, damit Sie ihn reparieren können.

Benachrichtigungen auf Ihrem Computer oder Handy

Pingerer kann eine Benachrichtigung auf Ihrem Bildschirm einblenden, wenn etwas kaputtgeht, auch wenn Pingerer gerade nicht geöffnet ist. Das ist kostenlos und verbraucht kein SMS-Guthaben. Jede Person schaltet es für sich selbst ein, auf jedem Gerät:

  1. Öffnen Sie auf diesem Computer oder Handy die Seite Benachrichtigungen und scrollen Sie zu Benachrichtigungen auf Ihren Geräten.
  2. Klicken Sie auf Benachrichtigungen auf diesem Gerät einschalten und wählen Sie Zulassen, wenn Ihr Browser fragt.
  3. Klicken Sie auf Testbenachrichtigung senden, um eine zu sehen.

Das funktioniert in Chrome, Edge, Firefox und Safari auf Computern und Android-Handys. Auf einem iPhone oder iPad legen Sie Pingerer zuerst auf den Home-Bildschirm: Tippen Sie in Safari auf die Teilen-Taste, dann auf Zum Home-Bildschirm, und öffnen Sie Pingerer von dort. Falls Sie Benachrichtigungen versehentlich blockiert haben, klicken Sie auf das Symbol links neben der Webadresse, stellen Sie Benachrichtigungen auf Zulassen und laden Sie die Seite neu.

Benachrichtigungen gehen an alle, die in einem Kanal Handy- und Browser-Benachrichtigungen enthalten sind. Hat Ihr Konto noch keinen, bekommt es einen, sobald die erste Person Benachrichtigungen einschaltet: für Ausfälle, Wiederherstellungen, Langsamkeit und ausgebliebene Heartbeats auf allen Websites. Ausfälle bleiben auf dem Bildschirm, bis Sie sie wegklicken, und ein Klick auf eine Benachrichtigung öffnet die Störung.

Auf dem Sperrbildschirm Ihres iPhones

Mit der Pingerer-App für das iPhone (ab iOS 17.2) und eingeschalteten Benachrichtigungen erscheint eine ausgefallene Website auf Ihrem Sperrbildschirm und in der Dynamic Island: ihre Adresse, was wir gesehen haben, und ein Zähler, wie lange sie schon nicht erreichbar ist. Ist sie wieder da, wird die Anzeige grün („Nach 14 Min. wieder erreichbar“) und verschwindet ein paar Minuten später. Tippen Sie darauf, um die Störung zu öffnen.

Während Pingerer geöffnet ist

Das Symbol Ihres Browser-Tabs zeigt einen grünen, gelben oder roten Punkt, und ein Balken läuft oben über die Seite, wenn eine Website ausfällt oder wieder erreichbar ist. Schalten Sie Hier einen leisen Ton abspielen unter Benachrichtigungen auf Ihren Geräten ein, um es auch zu hören. Weitere Tastenkürzel.

Regeln: welche Websites, welche Ereignisse

Jeder Kanal hat Regeln: alle Websites (auch solche, die Sie später hinzufügen) oder ausgewählte Websites, und welche Ereignisse: Ausfall, eingeschränkt (langsam), SSL oder Domain läuft ab, DNS geändert, Probleme bei der E-Mail-Einrichtung, ausgebliebene Heartbeats und Website-Zustand (ein neuer kritischer Befund im wöchentlichen Check-up). Entwarnungen gehen an die Kanäle, die über das Problem informiert wurden.

Was in einer Benachrichtigung steht

Jede Benachrichtigung sagt, was ausgefallen ist, wie (zum Beispiel „502 Bad Gateway aus 3 Regionen“), wann es angefangen hat und was das meistens bedeutet. Eine Ausfall-E-Mail hat außerdem 1 Stunde pausieren, falls Sie schon an der Website arbeiten, und Kunden informieren, wenn eine Ihrer veröffentlichten Statusseiten diese Website zeigt: Das öffnet eine Statusmeldung, die schon mit den Angaben zum Ausfall ausgefüllt ist. Ist die Website wieder da, nennt die Entwarnung die wahrscheinliche Ursache, falls ihr Hoster, CDN oder Website-Baukasten zur selben Zeit Probleme hatte. Wenn eine Störung gemeldet und dann bestätigt wird, bekommen Sie eine Benachrichtigung, nicht zwei, und eine weitere, wenn alles wieder läuft. Fällt eine Website aus, merken das meist ihre Verfügbarkeits-, Port- und Ping-Prüfungen gleichzeitig: Sie bekommen trotzdem nur eine Benachrichtigung, und eine weitere, wenn die letzte davon wieder in Ordnung ist.

Wenn es an Ihrem Hoster liegt, nicht an Ihnen

Fallen viele andere Websites beim selben Hoster, CDN oder Website-Baukasten im selben Moment aus wie Ihre, steht in der Benachrichtigung, dass es wahrscheinlich an diesem Unternehmen liegt. Wird das erst ein paar Minuten später klar, bekommen Sie eine kurze Nachmeldung. Siehe Liegt es an meinem Hoster? Internetwetter.

Wenn eine Website ständig ausfällt und wiederkommt

Fällt eine Überwachung innerhalb von 2 Stunden zum 3. Mal aus, behandeln wir nicht mehr jedes Auf und Ab als neues Problem. Die Störung bleibt offen, bis die Prüfungen 30 Minuten lang ohne Unterbrechung erfolgreich waren, und der Verlauf erklärt, warum. Sie bekommen eine Benachrichtigung beim Ausfall und eine, wenn sich alles beruhigt hat, statt jedes Mal ein Paar.

Viele Benachrichtigungen auf einmal

Nach 30 Benachrichtigungs-E-Mails in einer Stunde halten wir weitere E-Mails zurück und schicken sie eine Stunde später als eine Zusammenfassung pro Kanal, mit allen Benachrichtigungen und den Störungen, die noch offen sind. Andere Kanäle wie Slack, SMS und Benachrichtigungen auf Geräten sind davon nicht betroffen.

Übernehmen

Klicken Sie in einer Benachrichtigung (oder bei der Störung) auf Übernehmen, damit Ihr Team weiß, dass sich jemand darum kümmert. Damit wird die Störung nicht weiter eskaliert.

Eskalation

Geben Sie einer Regel eine Zeit für „eskalieren nach“, dann wird sie zur Eskalationsregel: Dieser Kanal wird nur informiert, wenn eine Störung nach so vielen Minuten noch niemand übernommen hat. Zum Beispiel: sofort eine E-Mail ans Team, und eine SMS an die Inhaberin, wenn nach 15 Minuten niemand übernommen hat.

Bereitschaftspläne

Im Tarif Bezahlt kann sich ein Team mit der Bereitschaft abwechseln. Öffnen Sie Bereitschaft, legen Sie einen Plan an, bringen Sie Ihr Team in die Reihenfolge, in der es sich abwechselt, und wählen Sie, wann übergeben wird (zum Beispiel jede Woche montags um 9 Uhr, in Ihrer Zeitzone). Jeder Plan zeigt, wer jetzt und als Nächstes Bereitschaft hat, und die kommende Woche. Fügen Sie eine Ausnahme hinzu, wenn jemand eine Zeit lang einspringt, etwa bei einem Tausch oder im Urlaub.

Ein Plan erscheint auf der Seite Benachrichtigungen als Kanal namens „On call: Name“. Haken Sie ihn für die Websites an, die er abdecken soll, oder wählen Sie ihn unter Eskalieren an, damit nur dann die Person in Bereitschaft benachrichtigt wird, wenn niemand rechtzeitig übernimmt. Wir schicken der Person in Bereitschaft eine E-Mail und auch eine SMS, wenn sie ihre Telefonnummer auf der Seite Bereitschaft hinzugefügt und bestätigt hat (SMS verbrauchen das SMS-Guthaben des Kontos).

Ruhezeiten

Legen Sie Ruhezeiten fest (zum Beispiel 22 bis 7 Uhr), um weniger dringende Benachrichtigungen wie ablaufende Zertifikate oder DNS-Änderungen bis zum Morgen zurückzuhalten. Ausfälle und ausgebliebene Heartbeats kommen immer durch, außer Sie haben gesagt, dass eine Website warten kann: Wählen Sie auf ihrer Seite unter Nachts die Option Kann bis morgens warten, etwa für ein Nebenprojekt oder eine Test-Website, dann warten auch ihre Ausfallmeldungen bis zum Ende der Ruhezeit. Eine zurückgehaltene Benachrichtigung, deren Problem sich bis zum Morgen von selbst erledigt, wird nie verschickt. Sie können auch das ganze Wochenende über alles zurückhalten. Wählen Sie Ihr Wochenende neben den Ruhezeiten: Samstag und Sonntag, Freitag und Samstag oder nur ein Tag. Lassen Sie es offen, nehmen wir das, was in Ihrer Zeitzone üblich ist (Freitag und Samstag in der Golfregion). Entwickler können Ruhezeiten und Wochenende auch über die API lesen und ändern.

Was ein Webhook bekommt

Ein Webhook-Kanal bekommt für jede Benachrichtigung einen JSON-POST. Der Header X-Pingerer-Event sagt, um welches Ereignis es sich handelt:

  • opened: Etwas ist schiefgelaufen. confirmed und escalated folgen, wenn weitere Regionen es bestätigen oder niemand es rechtzeitig übernommen hat.
  • recovered: Es funktioniert wieder.
  • update: Ihre Website ist noch nicht erreichbar, und seit unserer ersten Meldung sind viele andere Websites beim selben Hoster, CDN oder Website-Baukasten ebenfalls ausgefallen. Es liegt also wahrscheinlich an denen, nicht an Ihnen. Sie bekommen höchstens eine pro Störung, und nur auf Kanälen, die über den Ausfall informiert wurden.
  • test: Sie haben auf Test senden geklickt.
{
  "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 ist nur vorhanden, wenn die Website ausgefallen ist und ihr Hoster die wahrscheinliche Ursache ist (wie wir das erkennen). kind ist hosting, cdn oder platform (ein Website-Baukasten wie Shopify oder Wix). Es steht nie darin, wie viele andere Websites ausgefallen sind oder wessen. Die Störungen in der API haben dasselbe Feld provider_trouble. Die vollständige Beschreibung steht unter webhooks in /openapi.yaml.

Webhook-Signaturen

Webhook-Anfragen sind JSON-POSTs mit einem Header X-Pingerer-Signature wie t=1760000000,v1=5257a8.... Um eine zu prüfen, berechnen Sie einen HMAC-SHA256 von "#{t}.#{body}" mit dem Secret Ihres Kanals und vergleichen ihn mit v1. Lehnen Sie Anfragen ab, deren t älter als ein paar Minuten ist.

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

Ihr Lagebericht

Neben Benachrichtigungen kann Pingerer Ihnen einen wöchentlichen oder täglichen Lagebericht schicken: was passiert ist, was Sie erledigen sollten und was demnächst ansteht, in einfachen Worten, auf Wunsch mit einer kurzen Notiz obendrauf. Siehe Ihr Lagebericht.

Kommen Sie nicht weiter? Schreiben Sie uns, ein Mensch antwortet Ihnen.