Sentry-Alarme als Push-Benachrichtigung aufs iPhone

Verbinde Sentry mit Honk, und ein neuer Fehler in deiner App kommt als Push auf dein iPhone, mit der Stufe, die Sentry ihm gegeben hat: Ein Issue mit fatal ist ein Dauerhupen, eines mit error ein Langes Hupen. Markierst du das Issue in Sentry als gelöst (Resolve), gibt Honk Entwarnung und schließt das Problem. Auch deine Alarmregeln, Metrik-Alarme eingeschlossen, können an Honk senden.

Das läuft über eine interne Integration in Sentry, die jede Zustellung mit ihrem eigenen Schlüssel signiert. Du änderst kein SDK und deployst nichts, und die Fehler aus Sentry liegen im selben Posteingang wie deine Server, Zahlungen und Cronjobs.

Voraussetzungen

• Ein Honk-Konto. Honk gibt es vorerst nur auf Einladung: Zugang anfragen.
• Ein Projekt für die App, in einem Workspace, in dem du Inhaber oder Admin bist.
• Die Berechtigung, in deiner Sentry-Organisation Integrationen anzulegen.

1. Die Verbindung in Honk anlegen

Öffne in der Honk-Web-App das Projekt, geh zu Verbindungen und klick auf Dienst verbinden. Wähle Sentry, behalte den Namen oder ändere ihn, und klick auf Verbinden.

Honk zeigt die Webhook-URL der Verbindung. Sie beginnt mit https://honk-honk.app/v1/hooks/sentry/. Kopiere sie und lass die Seite für Schritt 3 offen.

2. Eine interne Integration in Sentry anlegen

Öffne in Sentry Settings ▸ Developer Settings ▸ Custom Integrations, klick auf Create New Integration und wähle Internal Integration. Gib ihr einen Namen, zum Beispiel „Honk“, und dann:

• füge die URL von Honk bei Webhook URL ein;
• stell unter Permissions den Punkt Issue & Event auf Read;
• hake unter Webhooks den Punkt issue an;
• schalte Alert Rule Action ein, wenn du Honk in Alarmregeln nutzen willst.

Lass error ohne Haken: Damit käme jedes einzelne Ereignis, und Honk ignoriert es. Speichere die Integration.

3. Das Client Secret in Honk einfügen

Sobald die Integration gespeichert ist, zeigt Sentry ihre Credentials. Kopiere das Client Secret, füge es in Honk bei Signaturschlüssel ein und klick auf Schlüssel speichern.

Bis der Schlüssel gespeichert ist, weist Honk die Zustellungen von Sentry ab. Danach prüft es die Signatur jeder Zustellung und weist alle ab, die nicht passen. Die Verbindung zeigt, wann zuletzt etwas zugestellt wurde, oder den letzten Fehler.

4. Honk zu Alarmregeln hinzufügen

Der Issue-Webhook deckt neue, wiederkehrende und behobene Issues schon ab, dieser Schritt ist also optional. Um eine Alarmregel an Honk zu schicken, öffne die Regel in Sentry und füg die Aktion Send a notification via … mit deiner Integration hinzu. Das geht für Issue-Alarme und für Metrik-Alarme, etwa eine Fehlerrate über einem Schwellenwert.

Du kannst beides eingeschaltet lassen. Ein Alarm zu einem Issue landet in der Gruppe dieses Issues, neben den Nachrichten des Webhooks: Er kommt zum selben Problem hinzu, statt ein zweites zu öffnen, und wenn du das Issue in Sentry behebst, wird das Problem geschlossen.

Was aus jedem Ereignis wird

Issues. Ein neues Issue oder eines, das wieder offen ist (so meldet Sentry eine Regression), öffnet ein Problem mit der Stufe des Issues:

• fatal: Dauerhupen;
• error: Langes Hupen;
• warning: Lautes Hupen;
• info und debug: Leichtes Hupen.

Die Nachricht enthält den Titel des Issues, die Stelle, an der es auftrat, seine Kurz-ID und das Sentry-Projekt, und sie verlinkt auf das Issue. Markierst du das Issue in Sentry als gelöst, kommt eine Entwarnung, „Resolved: …“, und das Problem ist geschlossen. Zuweisen oder Archivieren ändert in Honk nichts. Jedes Issue hat seine eigene Gruppe, und Sentry meldet ein Issue einmal, nicht bei jedem Ereignis: Ein Fehler, der 500-mal auftritt, ist trotzdem nur ein Push.

Issue-Alarme. Ein ausgelöster Alarm öffnet ein Problem mit der Stufe des Ereignisses, das ihn ausgelöst hat. Er landet in der Gruppe des Issues, um das es geht: Behebst du das Issue in Sentry, wird auch dieses Problem geschlossen.

Metrik-Alarme. Critical ist ein Dauerhupen, warning ein Lautes Hupen, und resolved gibt Entwarnung. Ein Alarm bleibt vom Auslösen bis zur Entwarnung eine Gruppe, und wird aus einer Warnung ein kritischer Alarm, kommt sofort ein neuer Push.

Hast du in Honk für iPhone Live-Aktivitäten eingeschaltet, kann ein Langes Hupen oder Dauerhupen auf deinem Sperrbildschirm bleiben, bis das Problem behoben ist oder du es als erledigt markierst.

Tarife und Limits

Jede Verbindung zählt zum Tarif deines Workspaces: Free enthält 2, Pro 20 und Team 100. Nachrichten von Sentry zählen wie alle anderen zu den täglichen Limits des Tarifs für Nachrichten und Pushes; die Preise listen sie auf.

Für Uptime- und Infrastruktur-Alarme im selben Posteingang gibt es die Anleitung zu Grafana und Alertmanager und die Uptime-Kuma-Anleitung. Läuft deine App auf Laravel, meldet die Anleitung zu Laravel-Exceptions Fehler auch ohne Sentry, und Alarmmüdigkeit vermeiden erklärt, wie Honk aus einem Problem einen einzigen Push macht.