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 7dTilefall · 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.
| Flag | Filtert nach |
|---|---|
--level | Levels: error, error,critical oder warning+ für warning und schlimmer. Die Levels sind trace, debug, info, notice, warning, error, critical. |
--message | Dem Event-Namen (Message), exakt |
-q, --query | Suche in Message, Bereich und Attributen |
--category | Bereich (Category): checkout, "a|b" oder "!a" |
--attr | Einem Attribut, path:value, oder path!:value für „nicht“. Für mehrere wiederholen. |
--user | Der ID einer Person (der user_id, die die App sendet) |
--session | Der ID einer Session |
--install | Der ID einer Installation |
--version | App-Version: 2.4.0 oder "2.4.0|2.4.1" |
--platform | Plattform: ios, android, web, python... |
--device | Gerätemodell |
--os | Version des Betriebssystems |
--country | Ländercode: ES oder "ES|PT" |
--locale | Locale: es_ES |
--verified | Wie der Absender nachgewiesen wurde: server, app_attest, key_attestation, none. "!none" behält nur verifizierte Events. |
--env | Umgebung. 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
| Flag | Was |
|---|---|
--since | Ein Fenster, das jetzt endet: 15m, 1h, 6h, 24h, 7d, 30d oder eine beliebige Zahl von s, m, h, d oder w. Standard 24h. |
--from | Der Anfang |
--to | Das Ende. Standard: jetzt. |
--oldest-first | Die ä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-firstTilefall · 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
| Flag | Was |
|---|---|
-n, --limit | Wie viele Events höchstens. Standard 100. Seiten mit bis zu 1.000 werden nach Bedarf geholt. |
--cursor | Dort 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 -fTilefall · production · following, Ctrl-C to stop
10:41:52 ▌info app_launch app cold_start_ms=612 launch_reason=iconlyrelog 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.
| Flag | Was |
|---|---|
--ts | Die 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 7dTilefall · 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 7dTilefall · 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 8lyrelog events values attr.board.size| Flag | Was |
|---|---|
--search | Nur 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 --numericAttribute Events
hints_used 360
seconds 360| Flag | Was |
|---|---|
--of | Nur in diesen Events (Messages): "a|b" |
--numeric | Nur Attribute mit Zahlen, also die, die insights trend --metric value darstellen kann |
Es nimmt außerdem die Filter und Zeit-Flags von events.