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 errorsTilefall · 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 ▄ █ █ ▄ ▄▄ ▄| Flag | What |
|---|---|
--warnings | Count 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 longestTilefall · 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| Flag | What |
|---|---|
--errors | Only sessions with errors |
--with-event | Only sessions with this event (message) in them |
--min-duration | Only sessions at least this long: 30s, 5m |
--sort | recent (default), longest, errors or events |
--page | The 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 errorsTilefall · 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| Flag | What |
|---|---|
--search | Ids starting with this |
--sort | last_seen (default), events, errors, sessions or first_seen |
--page | The 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 4Player 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| Flag | What |
|---|---|
-n, --limit | How many recent events to show. Default 20. |
--since, --from, --to | The window for sessions and events. Default 7d. |
--env, --platform | As in events |
--export <file> | Write all their events as JSON lines to this file, - for stdout |
--delete | Delete all their events (owners only; can't be undone) |
-y, --yes | With --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 releasesTilefall · 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 agoInsights
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 versionTilefall · 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| Flag | What |
|---|---|
--by | Break down by version, country or attr:<path> |
--metric | events (default), users (people), or value (a number attribute) |
--value-path | With --metric value: the attribute holding the number |
--stat | With --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 ▁▅██▅▇▅▁| Flag | What |
|---|---|
--hits | The events counted (failures): "a|b" |
--of | The events they're out of (attempts): "c|d" |
--by | Break 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 1hTilefall · 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| Flag | What |
|---|---|
--window | Time 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 usageAlex 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%| Flag | What |
|---|---|
--org | One organization, by id or name. Default: all of yours. |