Alerts
E-Mails, wenn eine neue Fehlerart auftaucht, wenn ein Fehler sprunghaft zunimmt oder wenn eine Version anfängt fehlzuschlagen.
Bei Pro und Business kann ein Projekt dir eine E-Mail schicken, wenn etwas kaputtgeht, und in Slack oder (bei Business) an einen eigenen Webhook posten. Niemand bekommt Alerts, um die er nicht gebeten hat: Jede Person wählt ihre eigenen in den Einstellungen des Projekts unter Alerts. Free-Organisationen haben keine Alerts.
Wofür du E-Mails bekommen kannst
| Alert | Wann |
|---|---|
| A new kind of error (eine neue Fehlerart) | Ein Fehler, den das Projekt in den letzten 30 Tagen nicht hatte: ein neuer Bereich und Name. Einmal pro Fehler. |
| An error spikes (ein Fehler nimmt sprunghaft zu) | In der letzten Stunde trat ein Fehler mindestens 20-mal auf und mindestens 3-mal so oft wie im stündlichen Durchschnitt der Woche davor. Höchstens einmal alle sechs Stunden pro Fehler. |
| A version starts failing (eine Version fängt an fehlzuschlagen) | Die neueste Version mit mindestens 50 Sessions hat 5 Prozentpunkte weniger fehlerfreie Sessions als die Version davor. Einmal pro Version. |
Fehler sind Events mit den Levels error und critical. Alerts beobachten die Umgebung, mit der
sich das Dashboard öffnet (siehe Umgebungen), damit
Entwicklungs-Builds niemanden wecken. Geprüft wird alle fünf Minuten; auch ein Event, das verspätet
ankommt, wird noch bemerkt.
Jede E-Mail nennt den Fehler oder die Version, wie viele Events und Personen betroffen sind, und verlinkt auf die Seite Errors oder Releases des Projekts. Sie enthält nie mehr von einem Event, als die Liste im Dashboard zeigt.
Deine eigenen wählen
Schalte unter Alerts bei Email me die ein, die du willst. Sie gehen an die E-Mail-Adresse deines Kontos, die bestätigt sein muss. Jede Person im Projekt kann ihre eigenen wählen; wer die Organisation verlässt oder aus ihr entfernt wird, bekommt keine mehr.
Für alle im Projekt
Inhaber wählen, welche Alerts das Projekt überhaupt verschickt und ab wann ein Anstieg oder eine Version zählt:
| Einstellung | Standard | Bereich |
|---|---|---|
| A spike is this many times the usual rate (Faktor der üblichen Rate, ab dem ein Anstieg zählt) | 3 | 1,5 bis 20 |
| With at least this many events in the hour (mit mindestens so vielen Events in der Stunde) | 20 | 1 bis 100.000 |
| A version is failing at this many points fewer error-free sessions (eine Version gilt als fehlschlagend bei so vielen Prozentpunkten weniger fehlerfreien Sessions) | 5 | 1 bis 50 |
| Once it has this many sessions (sobald sie so viele Sessions hat) | 50 | 10 bis 100.000 |
Ein Alert, den ein Inhaber ausschaltet, ist für alle im Projekt aus, egal was sie gewählt haben.
Pläne
| Plan | Alerts |
|---|---|
| Free | Keine |
| Pro | E-Mail und Slack |
| Business | E-Mail, Slack und Webhooks |
Slack
Inhaber verbinden unter Also send to einen Slack-Channel pro Projekt:
- Erstelle in Slack einen Incoming Webhook für den Channel (eine App mit eingeschaltetem Incoming Webhooks, dann Add New Webhook).
- Füge seine Adresse (sie beginnt mit
https://hooks.slack.com/services/) unter Slack ein, wähle, welche Alerts dorthin gehen, und wähle Connect. - Send a test postet eine Nachricht, damit du prüfen kannst, ob sie ankommt.
Die Adresse ist ein Geheimnis: Jeder, der sie hat, kann in den Channel posten. Lyrelog zeigt sie nie wieder vollständig, nur ihr Ende, und loggt sie nie. Nachrichten werden für alle im Projekt gepostet, egal was jede Person für E-Mails gewählt hat. Antwortet Slack, dass der Webhook nicht mehr existiert, hört Lyrelog auf, es zu versuchen; entferne ihn dann und verbinde einen neuen.
Webhooks
Bei Business können Inhaber zusätzlich einen Webhook verbinden: eine beliebige https://-Adresse
auf Port 443, die Lyrelog im Internet erreichen kann. Jeder Alert ist ein POST mit einem
JSON-Body:
{
"type": "alert",
"kind": "new_error",
"project": { "id": "a83810a9e984", "name": "Tilefall" },
"title": "A new kind of error in Tilefall",
"detail": "Tilefall has an error it hadn't had in the last 30 days.",
"url": "https://app.lyrelog.com/p/a83810a9e984/errors",
"issue": { "area": "save", "name": "Couldn't write the save file", "events": 4, "people": 3 },
"release": null,
"sent_at": "2026-11-20T12:54:36Z"
}kind ist new_error, spike, release oder test. Ein Anstieg enthält issue mit den Events
und Personen der letzten Stunde; eine fehlschlagende Version enthält stattdessen release:
"release": { "version": "2.1", "previous": "2.0", "error_free": 0.8, "previous_error_free": 0.95, "sessions": 200 }Prüfen, ob ein Request von Lyrelog kommt
Wenn du den Webhook verbindest, zeigt Lyrelog einmalig sein Signing Secret (whsec_...). Jeder
Request trägt X-Lyrelog-Signature: t=<unix seconds>,v1=<hex>, wobei v1 der HMAC-SHA256 von
<t>.<body> mit diesem Secret ist. Berechne ihn über den rohen Body neu, vergleiche in konstanter
Zeit und lehne ein t ab, das älter als fünf Minuten ist:
import { createHmac, timingSafeEqual } from "node:crypto"
function fromLyrelog(rawBody, header, secret) {
const { t, v1 } = Object.fromEntries(header.split(",").map((part) => part.split("=")))
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false
const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex")
return v1.length === expected.length && timingSafeEqual(Buffer.from(v1), Buffer.from(expected))
}Zustellung
Antworte innerhalb von 10 Sekunden mit einem beliebigen 2xx. Lyrelog folgt keinen Redirects. Ein
5xx, ein 408, ein 429 oder keine Antwort wird später erneut versucht (nach 30 Sekunden, dann
jeweils doppelt so lange, bis zu 8 Versuche); bei jedem anderen 4xx wird aufgegeben. Die
Einstellungen zeigen, wie die letzte Zustellung gelaufen ist.