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

Events

lyrelog events sucht mit den Filtern des Explorers, verfolgt neue Events live und zeigt ein Event vollständig.

lyrelog events ist der Explorer im Terminal. Es listet die Events eines Projekts auf, die neuesten zuerst, aus den letzten 24 Stunden, sofern du nichts anderes angibst. Es hört auch auf lyrelog logs und lyrelog log.

lyrelog events --level warning+ --since 7d
Tilefall · production · last 7 days

10:30:07 ▌error    cloud_save_failed    sync  reason=schema_mismatch record=progress status=422
10:27:43 ▌error    cloud_save_failed    sync  reason=schema_mismatch record=progress status=422
10:24:48 ▌error    cloud_save_failed    sync  reason=schema_mismatch record=progress status=422
10:22:05 ▌error    cloud_save_failed    sync  reason=schema_mismatch record=progress status=422
10:17:06 ▌error    chat_socket_gave_up  chat  attempts=4 match_id=0d9acb1f-503f-4818-a5a1-19336d1f0d8a

Showing 5 events. For more: --cursor MTc5NTE2NjIyNjExMTo3...

Die erste Zeile nennt das Projekt, die Umgebung und das Zeitfenster. Jedes Event ist eine Zeile: seine Zeit, sein Level, sein Name (Message), sein Bereich (Category) und seine Attribute. Events von anderen Tagen zeigen auch das Datum.

Filter

Die Filter sind die des Explorers und akzeptieren dieselben Werte wie dessen URL: "a|b" für einen von mehreren Werten, "!a" für alles außer diesem. Setze sie in Anführungszeichen, weil | und ! für die Shell eine Bedeutung haben.

FlagFiltert nach
--levelLevels: error, error,critical oder warning+ für warning und schlimmer. Die Levels sind trace, debug, info, notice, warning, error, critical.
--messageDem Event-Namen (Message), exakt
-q, --querySuche in Message, Bereich und Attributen
--categoryBereich (Category): checkout, "a|b" oder "!a"
--attrEinem Attribut, path:value, oder path!:value für „nicht“. Für mehrere wiederholen.
--userDer ID einer Person (der user_id, die die App sendet)
--sessionDer ID einer Session
--installDer ID einer Installation
--versionApp-Version: 2.4.0 oder "2.4.0|2.4.1"
--platformPlattform: ios, android, web, python...
--deviceGerätemodell
--osVersion des Betriebssystems
--countryLändercode: ES oder "ES|PT"
--localeLocale: es_ES
--verifiedWie der Absender nachgewiesen wurde: server, app_attest, key_attestation, none. "!none" behält nur verifizierte Events.
--envUmgebung. Standard ist die Standardumgebung des Projekts, wie im Dashboard; all durchsucht alle.
lyrelog events --attr board.size:9 --attr result!:win
lyrelog events --level error --version "2.4.0|2.4.1" --platform '!web'
lyrelog events --user pl-fe0958c6 --since 7d --limit 500
lyrelog events --verified '!none'
lyrelog events --env all -q "card declined"

Die Standardumgebung ist die des Projekts, also erscheinen Events, die unter development gesendet wurden, nur, wenn du --env development oder --env all übergibst (siehe Umgebungen).

Zeit

FlagWas
--sinceEin Fenster, das jetzt endet: 15m, 1h, 6h, 24h, 7d, 30d oder eine beliebige Zahl von s, m, h, d oder w. Standard 24h.
--fromDer Anfang
--toDas Ende. Standard: jetzt.
--oldest-firstDie ältesten zuerst, ab dem Anfang des Fensters

--from und --to nehmen:

  • RFC 3339: 2026-11-19T10:00:00Z
  • ein Datum mit Uhrzeit in der Zeitzone deines Computers: 2026-11-19 10:00
  • ein Datum: 2026-11-19, gemeint ist Mitternacht am Anfang dieses Tages, in deiner Zeitzone
  • Unix-Millisekunden (1763550000000) oder -Sekunden
  • wie lange es her ist: 2h, 3d

--since lässt sich nicht mit --from oder --to kombinieren. Nur mit --from endet das Fenster jetzt; nur mit --to beginnt es 24 Stunden vorher.

lyrelog events --from 3d --to 2d
lyrelog events --from 2026-11-15 --to 2026-11-16 --oldest-first
Tilefall · production · Nov 15 00:00 to Nov 16 00:00

Nov 15 00:00:00 ▌info     leaderboard_submit_confirmed  leaderboards  board=tilefall.daily.pure latency_ms=420
Nov 15 00:00:11 ▌info     game_started                  game          board.seed=4052403362615 board.size=7 m…
Nov 15 00:00:17 ▌info     match_round_won               multiplayer   match_id=b60cc0cc-b294-46a3-9186-35c71a…

Wie viele, und der Rest

FlagWas
-n, --limitWie viele Events höchstens. Standard 100. Seiten mit bis zu 1.000 werden nach Bedarf geholt.
--cursorDort weitermachen, wo eine vorherige Liste aufgehört hat

Gibt es mehr Events als --limit, nennt die letzte Zeile den --cursor, den du für die nächsten übergibst. Führe denselben Befehl mit diesem zusätzlichen Flag erneut aus und behalte dieselben Filter bei. Im JSON-Modus geht der Cursor als {"more":true,"next":"--cursor ..."} auf stderr (siehe Der JSON-Vertrag).

Neue Events verfolgen

-f (--follow) gibt die letzten Events der vergangenen Stunde aus (bis zu --limit, die ältesten zuerst) und danach jedes neue, sobald es ankommt, bis du Ctrl-C drückst. Es fragt alle 4 Sekunden, wie der Live-Modus des Dashboards, was Lyrelog seit dem letzten Mal empfangen hat. Neue Events werden in der Reihenfolge ihrer Ankunft ausgegeben: Ein Batch, den ein Smartphone verspätet schickt, nachdem es offline war, erscheint also bei seiner Ankunft, mit seinen eigenen (älteren) Zeiten, solange diese innerhalb der letzten 2 Tage liegen.

lyrelog events -f
Tilefall · production · following, Ctrl-C to stop

10:41:52 ▌info     app_launch  app  cold_start_ms=612 launch_reason=icon

lyrelog events -f --level error verfolgt nur Fehler.

Die Filter funktionieren wie gewohnt. --since, --from und --to nicht, weil es zeigt, was ab jetzt ankommt. Im JSON-Modus schreibt es ein JSON-Objekt pro Zeile (NDJSON); jedes hat neben seinem eigenen ts ein received_at, wann Lyrelog es empfangen hat (Unix-ms). Ist der Server eine Weile nicht erreichbar, meldet es das auf stderr und versucht es weiter. Es hört auf, wenn die Session endet oder das Projekt nicht mehr existiert.

events get

Ein Event vollständig: wer, wo, die App, das Gerät, seine Attribute und seine Payload.

lyrelog events get adea33e4-26eb-422e-b904-96649c0e7830
▌ cloud_save_failed  error
  sync

  Time         2026-11-20 10:30:07.485 CET  8m ago
  Event        adea33e4-26eb-422e-b904-96649c0e7830
  Player       pl-fe0958c6
  Session      51e19a18-ca3e-4428-a10b-baeadc7eaaf8
  Install      76f5a7d0-81b0-4c36-8908-eefd6c936abf
  App          com.example.tilefall 1.6.3 (202609301304)
  Device       iPhone18,2 iOS 27.2.0
  Locale       fr_FR
  Country      FR
  Environment  production
  Platform     ios

Attributes
  {
    "reason": "schema_mismatch",
    "record": "progress",
    "status": 422
  }

Payload
  {
    "description": "The server refused the save",
    "detail": "field 'mode' is not allowed in format 3; expected format 4"
  }

Das Tool findet das Event anhand seiner ID unter allem, was das Projekt aufbewahrt (über seine ganze Aufbewahrungsdauer). Übergib --ts mit der Zeit des Events in Unix-Millisekunden (das Feld ts im JSON), um direkt dorthin zu gehen und diese Suche zu überspringen.

FlagWas
--tsDie Zeit des Events in Unix-Millisekunden (überspringt die Suche)

events summary

Die Summen (Events, Personen, Sessions, Fehler) und die häufigsten Werte jedes Felds, so wie das Seitenpanel des Explorers sie zeigt. Es nimmt dieselben Filter und Zeit-Flags wie events.

lyrelog events summary --since 7d
Tilefall · production · last 7 days

  52,886 events  300 players  3,202 sessions  1,127 errors

  category     game 11.6k  leaderboards 10k  app 7,110  daily 5,362  campaign 5,126  account 3,304
  level        info 36.7k  debug 13.7k  error 1,110  warning 1,074  notice 292  critical 17
  version      2.0 30.4k  1.6.3 22.5k
  ...

events values

Die häufigsten Werte eines Felds oder eines Attributs (attr.<path>) innerhalb der Filter: das, was das Filtermenü des Explorers anbietet. Zu den Feldern gehören level, category, message, version, device, country, environment, platform und verified.

lyrelog events values message --level error --since 7d
Tilefall · production · last 7 days

Message                    Events  Players
cloud_save_failed             823      124
daily_upload_failed           178      124
match_update_denied            43       38
leaderboard_submit_failed      29       17
chat_socket_gave_up            28       28
purchase_failed                 9        8
lyrelog events values attr.board.size
FlagWas
--searchNur Werte, die das enthalten

Es nimmt außerdem die Filter und Zeit-Flags von events.

events attributes

Die Attributpfade, die Events tragen, die häufigsten zuerst. Auch als lyrelog events attrs.

lyrelog events attributes --of game_won --numeric
Attribute   Events
hints_used     360
seconds        360
FlagWas
--ofNur in diesen Events (Messages): "a|b"
--numericNur Attribute mit Zahlen, also die, die insights trend --metric value darstellen kann

Es nimmt außerdem die Filter und Zeit-Flags von events.