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

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.

SoNicht 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

attrspayload
WofürFelder zum Filtern, Aufschlüsseln und für DiagrammeDetails, die du liest, wenn du ein einzelnes Event öffnest
BeispieleIDs, Dauern, Statuscodes, Flagseine Serverantwort, ein Stacktrace
FilterbarJa, nach Pfad und Wert (attr=payment.method:card)Nein (komprimiert gespeichert)
Limits200 Blattwerte, Strings bis 1.024 Bytes, String-Arrays bis 64 Einträge, Objekte bis 4 Ebenen tief verschachteltBeliebiges 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.