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

Fehler, Sessions und Personen

Die Seiten Errors, Sessions, People, Releases, Insights und Usage des Dashboards als Befehle.

Diese Befehle zeigen, was die Seiten des Dashboards zeigen. Bis auf usage arbeitet jeder mit einem Projekt und nimmt die Filter und Zeit-Flags von lyrelog events: --level, --attr, --version, --platform, --env, --since, --from, --to und den Rest. Ihr Fenster sind die letzten 7 Tage, sofern du nichts anderes angibst.

Die Beispiele verwenden ein Projekt, dessen Personen Spieler heißen. Das Tool verwendet das eigene Wort jedes Projekts (siehe Project settings).

Fehler

lyrelog errors (oder lyrelog issues) ist die Seite Errors: Events mit den Levels error und critical, gruppiert nach Bereich und Event-Name, die schlimmsten zuerst. Jede Zeile zeigt, wie oft es passiert ist, die Veränderung gegenüber dem vorherigen Fenster, wie viele Personen es getroffen hat, wann es zuletzt aufgetreten ist, in welchen Versionen es vorkam und wie es sich entwickelt.

lyrelog errors
Tilefall · production · last 7 days

   Event                   Area          Count  Change  Players  Last seen  Versions    Trend
●  cloud_save_failed       sync            823     new      124  7m ago     1.6.3       ▄▇▁▄▇▂▅▇▁▃▇▂▄▇▂▄▇▁▄█▂▁
●  daily_upload_failed     daily           178     new      124  32m ago    2.0, 1.6.3  ▄▄ ▃▅ ▃▇▂▃█▂▄▇▁▄▄▂▂▅▂▂
●  match_update_denied     multiplayer      43     new       38  38m ago    2.0, 1.6.3  ▂▇ ▄▅ ▂▂ █▂▄▅█▂▄▇ ▅▇ ▂
●  chat_socket_gave_up     chat             28     new       28  20m ago    2.0, 1.6.3  ▃▃ ▆█▃ █ ▆▆ ▆▆▃▃▃ ▃█ ▆
●  leaderboard_submit_fa…  leaderboards     29     new       17  1d ago     2.0, 1.6.3                 █
●  database_open_failed    app              17     new       16  26m ago    2.0, 1.6.3   ▃▃▆▃  ▃   ▃▃ ▃▃▆▃ █ ▃
●  purchase_failed         purchases         9     new        8  12h ago    2.0, 1.6.3      ▄  █  █ ▄  ▄▄  ▄
FlagWas
--warningsAuch Warnungen zählen
lyrelog errors --since 24h --warnings
lyrelog errors --version 2.4.1 --json | jq '.[0]'

Im JSON trägt jedes Problem ein sample_event, sample_user und sample_session, bereit für lyrelog events get, lyrelog person und lyrelog events --session.

Sessions

lyrelog sessions ist die Seite Sessions: wer, wie lange, wie viele Events und Fehler, Gerät und Version sowie das erste und letzte Event (mit dem ersten Fehler, falls es einen gab).

lyrelog sessions --with-event purchase_failed --sort longest
Tilefall · production · last 7 days

Started  Player        Length  Events  Errors  Device      Version  From → to                                     Session
3d ago   pl-3860c35c  37m 21s      34       1  iPad14,1    2.0      app_launch → app_background  ✗ purchase_fai…  cfc2523d-c1a3-4b4f-b576-53d98d2826e1
12h ago  pl-6405980a  28m 15s      24       1  iPhone17,1  1.6.3    app_launch → app_background  ✗ purchase_fai…  e567122a-70f9-42de-9f5b-f088684aa0a2
1d ago   pl-dcb099d1  23m 23s      25       1  iPhone18,1  2.0      app_launch → app_background  ✗ purchase_fai…  c8c02c07-0f64-4d20-9575-835f2758432f
FlagWas
--errorsNur Sessions mit Fehlern
--with-eventNur Sessions, die dieses Event (Message) enthalten
--min-durationNur Sessions, die mindestens so lang sind: 30s, 5m
--sortrecent (Standard), longest, errors oder events
--pageDie Seite, 50 Sessions pro Seite, ab 0 gezählt

Um die Events einer Session der Reihe nach zu lesen, übergib ihre ID (das Feld sid im JSON) an lyrelog events --session <id> --oldest-first.

Personen

lyrelog people ist die Seite People: wer die App im Zeitfenster benutzt hat, mit Events, Sessions, Fehlern und dem letzten Gerät und der letzten Version. Es hört auch auf lyrelog users und lyrelog players.

lyrelog people --sort errors
Tilefall · production · last 7 days

Player       Events  Sessions  Errors  Last seen  First seen  Device      Version  OS          Country
pl-4e5d999b     553        30      24  1h ago     6d ago      iPhone18,2  1.6.3    iOS 27.0.3  ES
pl-eb2cd82f     455        27      24  7h ago     6d ago      iPad16,6    1.6.3    iOS 27.2.0  IT
pl-519465f0     443        27      20  11h ago    6d ago      iPad14,1    1.6.3    iOS 27.0.3  FR

50 of 300 players. Next: --page 1
FlagWas
--searchIDs, die damit beginnen
--sortlast_seen (Standard), events, errors, sessions oder first_seen
--pageDie Seite, 50 Personen pro Seite, ab 0 gezählt

Person

lyrelog person <user-id> (oder user, player) ist die Seite einer Person: wie viele Events sie hat, ihre letzten Sessions und ihre neuesten Events. Die ID ist die user_id, die die App sendet, exakt abgeglichen.

lyrelog person pl-fe0958c6 -n 4
Player pl-fe0958c6 in Tilefall
  290 events in all, first 6d ago, last 8m ago

Sessions last 7 days
Started   Length  Events  Errors  Device      Version  From → to                                         Session
8m ago       40s       5       1  iPhone18,2  1.6.3    app_launch → app_background  ✗ cloud_save_failed  51e19a18-ca3e-4428-a10b-baeadc7eaaf8
2h ago   23m 58s      23       1  iPhone18,2  1.6.3    app_launch → app_background  ✗ cloud_save_failed  2f396cf7-4741-4102-acba-abe64fe9b31e
12h ago  20m 38s      19       0  iPhone18,2  1.6.3    app_launch → app_background                       5e9f9fee-7158-4ed1-87eb-46c6585d658e

Latest events
10:30:36 ▌info     app_background     app      seconds_open=11
10:30:07 ▌error    cloud_save_failed  sync     reason=schema_mismatch record=progress status=422
10:29:58 ▌info     sign_in_completed  account  latency_ms=641 method=apple
10:29:57 ▌debug    api_request        network  latency_ms=187 path=/app-version status=200

Everything of theirs: lyrelog events --user pl-fe0958c6 --since 7d
FlagWas
-n, --limitWie viele der letzten Events angezeigt werden. Standard 20.
--since, --from, --toDas Fenster für Sessions und Events. Standard 7d.
--env, --platformWie bei events
--export <file>Alle ihre Events als JSON-Zeilen in diese Datei schreiben, - für stdout
--deleteAlle ihre Events löschen (nur Inhaber; lässt sich nicht rückgängig machen)
-y, --yesMit --delete: nicht um Bestätigung bitten

Datenschutzanfragen

Das sind die Werkzeuge aus A person's data im Dashboard (siehe Datenschutzanfragen):

lyrelog person pl-fe0958c6 --export pl-fe0958c6.ndjson   # an access request (any member)
lyrelog person pl-fe0958c6 --export - | jq .message
lyrelog person pl-fe0958c6 --delete                      # an erasure request (owners)

--delete bittet dich, zur Bestätigung die ID der Person einzutippen. Im JSON-Modus kann niemand antworten, daher braucht es dort --yes.

Releases

lyrelog releases (oder lyrelog versions) ist die Seite Releases: für jede App-Version die Personen, die Sessions, der Anteil der Sessions ohne Fehler, Fehler und kritische Events sowie wann diese Version zuerst und zuletzt gesehen wurde.

lyrelog releases
Tilefall · production · last 7 days

Version  Players  Sessions  Without errors  Errors  Critical  First seen  Last seen
2.0          171     1,849             90%     194        13  6d ago      10m ago
1.6.3        129     1,353             36%     933         4  6d ago      7m ago

Insights

lyrelog insights ist die Seite Insights: wie oft etwas passiert (trend), wie oft es fehlschlägt (rate) und wie weit Personen durch einen Ablauf kommen (funnel).

insights trend

Wie oft ein oder mehrere Events im Zeitverlauf auftreten, optional aufgeschlüsselt.

lyrelog insights trend game_won --by version
Tilefall · production · last 7 days

Event     Group  Events  Over time
game_won  2.0     1,552  ████▇▇▆▂
game_won  1.6.3   1,098  ▇██████▂
lyrelog insights trend game_won --metric users --since 30d
lyrelog insights trend game_won --metric value --value-path seconds --stat p90
FlagWas
--byAufschlüsseln nach version, country oder attr:<path>
--metricevents (Standard), users (Personen) oder value (ein Zahlenattribut)
--value-pathMit --metric value: das Attribut, das die Zahl enthält
--statMit --metric value: avg, p50, p90, p95, p99 oder max

lyrelog events attributes --numeric listet die Attribute auf, die Zahlen enthalten.

insights rate

Der Anteil einer Menge von Events an einer anderen: Fehlschläge im Verhältnis zu Versuchen.

lyrelog insights rate --hits purchase_failed --of "purchase_started|purchase_failed"
Tilefall · production · last 7 days

Event                                                   Rate  Hits / tries  Over time
purchase_failed of purchase_started, purchase_failed  10.59%        9 / 85  ▁▅██▅▇▅▁
FlagWas
--hitsDie gezählten Events (Fehlschläge): "a|b"
--ofDie Events, auf die sie sich beziehen (Versuche): "c|d"
--byAufschlüsseln nach version, country oder attr:<path>

insights funnel

Wie viele Personen jeden Schritt eines Ablaufs der Reihe nach erreichen und wie lange jeder Schritt dauert. Gib zwei oder mehr Events an.

lyrelog insights funnel app_launch game_started game_won --window 1h
Tilefall · production · last 7 days · within 1h

Step                                   Players  Of the first  Median time
1. app_launch    ████████████████████      300          100%
2. game_started  ███████████████████░      291           97%  6m 56s
3. game_won      ███████████████████░      288           96%  5m 57s
FlagWas
--windowDie erlaubte Zeit vom ersten bis zum letzten Schritt. Standard 1d.

Gespeicherte Ansichten

lyrelog insights views listet die gespeicherten Ansichten des Projekts auf. lyrelog insights delete-view <id> löscht eine; es fragt vorher nach und braucht im JSON-Modus --yes.

Nutzung

lyrelog usage zeigt die Events dieses Monats im Vergleich zu deinem Plan, für jede Organisation, der du angehörst, und wie sie sich auf deren Projekte verteilen (siehe Pläne und Nutzung).

lyrelog usage
Alex Rivera · Free plan
  ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 5.3%
  52,925 of 1,000,000 events a month · counts start again on Dec 1
                     █           per day

  Project   Events  Share
  Tilefall  52,925   100%
FlagWas
--orgEine Organisation, nach ID oder Name. Standard: alle deine.