Errores, sesiones y personas
Las páginas Errors, Sessions, People, Releases, Insights y Usage del panel, como comandos.
Estos comandos muestran lo mismo que las páginas del panel. Salvo usage, cada uno trabaja
sobre un proyecto y acepta los filtros y flags de tiempo de lyrelog events:
--level, --attr, --version, --platform, --env, --since, --from, --to y el resto.
Su ventana son los últimos 7 días salvo que indiques otra cosa.
Los ejemplos usan un proyecto cuyas personas se llaman jugadores (players). La herramienta usa la palabra de cada proyecto (consulta Configuración del proyecto).
Errores
lyrelog errors (o lyrelog issues) es la página Errors: los eventos
error y critical agrupados por área y nombre de evento, los peores primero. Cada fila muestra
cuántas veces pasó, el cambio respecto a la ventana anterior, a cuántas personas afectó, cuándo
se vio por última vez, en qué versiones pasó y su tendencia.
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 | Qué |
|---|---|
--warnings | Cuenta también los warnings |
lyrelog errors --since 24h --warnings
lyrelog errors --version 2.4.1 --json | jq '.[0]'En JSON, cada problema lleva un sample_event, un sample_user y un sample_session, listos
para lyrelog events get, lyrelog person y
lyrelog events --session.
Sesiones
lyrelog sessions es la página Sessions: quién, cuánto duró, cuántos
eventos y errores, el dispositivo y la versión, y el primer y el último evento (con el primer
error, si lo hay).
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 | Qué |
|---|---|
--errors | Solo las sesiones con errores |
--with-event | Solo las sesiones que contienen este evento (message) |
--min-duration | Solo las sesiones que duran al menos esto: 30s, 5m |
--sort | recent (por defecto), longest, errors o events |
--page | La página, de 50 sesiones, contando desde 0 |
Para leer en orden los eventos de una sesión, pasa su id (el campo sid del JSON) a
lyrelog events --session <id> --oldest-first.
Personas
lyrelog people es la página People: quién usó la app en la ventana, con
sus eventos, sesiones, errores y su último dispositivo y versión. También responde a
lyrelog users y 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 | Qué |
|---|---|
--search | Los ids que empiezan por esto |
--sort | last_seen (por defecto), events, errors, sessions o first_seen |
--page | La página, de 50 personas, contando desde 0 |
Persona
lyrelog person <user-id> (o user, player) es la página de una persona: cuántos eventos
tiene, sus sesiones recientes y sus últimos eventos. El id es el user_id que envía la app, y
tiene que coincidir exactamente.
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 | Qué |
|---|---|
-n, --limit | Cuántos eventos recientes mostrar. Por defecto, 20. |
--since, --from, --to | La ventana de las sesiones y los eventos. Por defecto, 7d. |
--env, --platform | Como en events |
--export <file> | Escribe todos sus eventos como líneas JSON en este archivo, - para stdout |
--delete | Borra todos sus eventos (solo propietarios; no se puede deshacer) |
-y, --yes | Con --delete: no pide confirmación |
Solicitudes de privacidad
Son las herramientas A person's data del panel (consulta Los datos de una persona):
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 te pide que escribas el id de la persona para confirmar. En modo JSON nadie puede
responder, así que necesita --yes.
Versiones
lyrelog releases (o lyrelog versions) es la página Releases: de cada
versión de la app, sus personas, sus sesiones, el porcentaje de sesiones sin errores, los errores
y los eventos critical, y cuándo se vio por primera y por última vez.
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 es la página Insights: con qué frecuencia pasa algo
(trend), con qué frecuencia falla (rate) y hasta dónde llegan las personas en un flujo
(funnel).
insights trend
Con qué frecuencia ocurren uno o más eventos a lo largo del tiempo, con desglose opcional.
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 | Qué |
|---|---|
--by | Desglosa por version, country o attr:<path> |
--metric | events (por defecto), users (personas) o value (un atributo numérico) |
--value-path | Con --metric value: el atributo que contiene el número |
--stat | Con --metric value: avg, p50, p90, p95, p99 o max |
lyrelog events attributes --numeric lista los atributos que contienen números.
insights rate
La proporción de un conjunto de eventos sobre otro: fallos sobre intentos.
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 | Qué |
|---|---|
--hits | Los eventos que se cuentan (fallos): "a|b" |
--of | Los eventos sobre los que se calcula (intentos): "c|d" |
--by | Desglosa por version, country o attr:<path> |
insights funnel
Cuántas personas llegan a cada paso de un flujo, en orden, y cuánto tarda cada paso. Indica dos o más eventos.
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 | Qué |
|---|---|
--window | Tiempo permitido desde el primer paso hasta el último. Por defecto, 1d. |
Vistas guardadas
lyrelog insights views lista las vistas guardadas del proyecto.
lyrelog insights delete-view <id> borra una; pide confirmación antes, y en modo JSON necesita
--yes.
Uso
lyrelog usage muestra los eventos de este mes frente a tu plan, para cada organización a la
que perteneces, y cómo se reparten entre sus proyectos (consulta Planes y uso).
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 | Qué |
|---|---|
--org | Una organización, por id o por nombre. Por defecto, todas las tuyas. |