Early AccessNur auf Einladung, und die SDKs sind noch nicht veröffentlicht.Einladung anfragen
Zum Inhalt springen
Docs

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

AlertWann
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:

EinstellungStandardBereich
A spike is this many times the usual rate (Faktor der üblichen Rate, ab dem ein Anstieg zählt)31,5 bis 20
With at least this many events in the hour (mit mindestens so vielen Events in der Stunde)201 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)51 bis 50
Once it has this many sessions (sobald sie so viele Sessions hat)5010 bis 100.000

Ein Alert, den ein Inhaber ausschaltet, ist für alle im Projekt aus, egal was sie gewählt haben.

Pläne

PlanAlerts
FreeKeine
ProE-Mail und Slack
BusinessE-Mail, Slack und Webhooks

Slack

Inhaber verbinden unter Also send to einen Slack-Channel pro Projekt:

  1. Erstelle in Slack einen Incoming Webhook für den Channel (eine App mit eingeschaltetem Incoming Webhooks, dann Add New Webhook).
  2. 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.
  3. 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.