Early accessBy invitation, and the SDKs aren't published yet.Ask for an invitation
Skip to Content
Docs

Errors, sessions and people

The dashboard's Errors, Sessions, People, Releases, Insights and Usage pages, as commands.

These commands show what the dashboard's pages show. Except for usage, each one works on one project and takes the filters and time flags of lyrelog events: --level, --attr, --version, --platform, --env, --since, --from, --to and the rest. Their window is the last 7 days unless you say otherwise.

The examples use a project whose people are called players. The tool uses each project's own word (see Project settings).

Errors

lyrelog errors (or lyrelog issues) is the Errors page: error and critical events grouped by area and event name, worst first. Each row shows how many times it happened, the change against the window before, how many people it reached, when it was last seen, the versions it happened on and how it trends.

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      ▄  █  █ ▄  ▄▄  ▄
FlagWhat
--warningsCount warnings too
lyrelog errors --since 24h --warnings
lyrelog errors --version 2.4.1 --json | jq '.[0]'

In JSON, each problem carries a sample_event, sample_user and sample_session, ready for lyrelog events get, lyrelog person and lyrelog events --session.

Sessions

lyrelog sessions is the Sessions page: who, how long, how many events and errors, the device and version, and the first and last event (with the first error, if any).

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
FlagWhat
--errorsOnly sessions with errors
--with-eventOnly sessions with this event (message) in them
--min-durationOnly sessions at least this long: 30s, 5m
--sortrecent (default), longest, errors or events
--pageThe page, 50 sessions a page, counting from 0

To read one session's events in order, pass its id (the sid field in JSON) to lyrelog events --session <id> --oldest-first.

People

lyrelog people is the People page: who used the app in the window, with their events, sessions, errors, and latest device and version. It also answers to lyrelog users and 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
FlagWhat
--searchIds starting with this
--sortlast_seen (default), events, errors, sessions or first_seen
--pageThe page, 50 people a page, counting from 0

Person

lyrelog person <user-id> (or user, player) is one person's page: how many events they have, their recent sessions and their latest events. The id is the user_id the app sends, matched exactly.

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
FlagWhat
-n, --limitHow many recent events to show. Default 20.
--since, --from, --toThe window for sessions and events. Default 7d.
--env, --platformAs in events
--export <file>Write all their events as JSON lines to this file, - for stdout
--deleteDelete all their events (owners only; can't be undone)
-y, --yesWith --delete: don't ask to confirm

Privacy requests

These are the dashboard's A person's data tools (see Privacy requests):

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 asks you to type the person's id to confirm. In JSON mode nobody can answer, so it needs --yes.

Releases

lyrelog releases (or lyrelog versions) is the Releases page: each app version's people, sessions, the share of sessions without errors, errors and critical events, and when it was first and last seen.

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 is the Insights page: how often something happens (trend), how often it fails (rate), and how far people get through a flow (funnel).

insights trend

How often one or more events happen over time, optionally broken down.

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
FlagWhat
--byBreak down by version, country or attr:<path>
--metricevents (default), users (people), or value (a number attribute)
--value-pathWith --metric value: the attribute holding the number
--statWith --metric value: avg, p50, p90, p95, p99 or max

lyrelog events attributes --numeric lists the attributes that hold numbers.

insights rate

The share of one set of events over another: failures over attempts.

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  ▁▅██▅▇▅▁
FlagWhat
--hitsThe events counted (failures): "a|b"
--ofThe events they're out of (attempts): "c|d"
--byBreak down by version, country or attr:<path>

insights funnel

How many people reach each step of a flow, in order, and how long each step takes. Give two or more events.

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
FlagWhat
--windowTime allowed from the first step to the last. Default 1d.

Saved views

lyrelog insights views lists the project's saved views. lyrelog insights delete-view <id> deletes one; it asks first, and needs --yes in JSON mode.

Usage

lyrelog usage shows this month's events against your plan, for each organization you belong to, and how they split across its projects (see Plans and usage).

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%
FlagWhat
--orgOne organization, by id or name. Default: all of yours.