Events
Ein Event ist eine Sache, die passiert ist, mit einem festen Namen, einem Level, einem Bereich und den Feldern, nach denen du filterst.
In Lyrelog ist alles ein Event. Ein Event sagt, was passiert ist (message), wie ernst es ist
(level), in welchem Teil der App (category) und wem (user_id, session_id,
install_id). Dazu kommen ein paar kleine Felder zum Filtern und für Diagramme (attrs) und bei
Bedarf ein größerer Block, den du erst liest, wenn du das Event öffnest (payload).
{
"event_id": "6f1b2c3d-5a1e-4c1f-9e7a-0a1b2c3d4e5f",
"ts": "2026-11-18T10:00:00.123Z",
"level": "error",
"category": "checkout",
"message": "payment_declined",
"user_id": "user-1",
"attrs": { "code": 51, "attempt": 2, "method": "card" },
"payload": { "response": "..." }
}Die Message ist ein fester Name
Schreib message als Event-Namen, nicht als Fließtext: payment_declined, checkout_done,
http_request_failed. Namen, die sich nie ändern, lassen sich zählen, in Diagrammen darstellen,
in einen Funnel stecken und zu Fehlern gruppieren. Was sich ändert (IDs, Dauern, Codes), gehört
in attrs.
| So | Nicht so |
|---|---|
payment_declined mit attrs: { code: 51 } | "Payment declined with code 51 for user-1" |
Die Message darf bis zu 2.048 Bytes lang sein.
Levels
Vom leisesten zum lautesten: trace, debug, info (der Standard), notice, warning,
error, critical. Das Dashboard gibt jedem eine eigene Farbe, zeichnet Fehler im Diagramm des
Explorers unterhalb der Achse und gruppiert error- und critical-Events auf der Seite
Errors.
Die SDKs verwerfen Events unterhalb ihres minimumLevel (Standard debug), bevor sie sie in die
Warteschlange stellen.
Category: der Bereich der App
category (im Dashboard als Area angezeigt) ist der Teil der App, zu dem das Event gehört:
checkout, sync, onboarding, network. Es funktioniert wie die Category von OSLog. Das
Dashboard filtert und zählt danach. Optional, bis zu 64 Bytes. Jedes SDK hat einen Logger pro
Bereich, damit du ihn nicht jedes Mal wiederholen musst.
Attribute und Payload
attrs | payload | |
|---|---|---|
| Wofür | Felder zum Filtern, Aufschlüsseln und für Diagramme | Details, die du liest, wenn du ein einzelnes Event öffnest |
| Beispiele | IDs, Dauern, Statuscodes, Flags | eine Serverantwort, ein Stacktrace |
| Filterbar | Ja, nach Pfad und Wert (attr=payment.method:card) | Nein (komprimiert gespeichert) |
| Limits | 200 Blattwerte, Strings bis 1.024 Bytes, String-Arrays bis 64 Einträge, Objekte bis 4 Ebenen tief verschachtelt | Beliebiges JSON bis 64 KiB nach der Serialisierung |
Attributwerte können Strings, Zahlen, Booleans, null, String-Arrays und verschachtelte Objekte
sein. Namen dürfen keine Punkte enthalten (verschachtle stattdessen ein Objekt) und nicht mit _
beginnen.
Logge Zahlen als Zahlen (latency_ms: 412, nicht "412"): Dann kann
Insights ihren Durchschnitt, Median oder p95 darstellen.
Die SDKs passen jedes Event an diese Limits an, bevor sie es in die Warteschlange stellen: Lange
Strings werden an einer Zeichengrenze gekürzt, und eine zu große Payload wird ersetzt durch
{"lyrelog_truncated": true, "bytes": N, "preview": "..."}, mit dem Anfang der Payload als
Vorschau.
Kontext
Jedes Event trägt außerdem eine resource: App-ID, Version und Build, Betriebssystem und dessen
Version, Gerätemodell, Locale, SDK, Umgebung und
Plattform. Die SDKs füllen sie für dich aus. Der Server ergänzt das
Land.
IDs und Duplikate
Jedes Event hat eine event_id, eine UUID, die einmal beim Loggen erzeugt wird. Die Zustellung
erfolgt mindestens einmal (at least once): Wird ein Batch doppelt gesendet, werden Events mit
derselben event_id und demselben ts nur einmal gespeichert.