Acceso anticipadoSolo por invitación, y los SDK aún no están publicados.Pedir una invitación
Ir al contenido
Docs

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 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      ▄  █  █ ▄  ▄▄  ▄
FlagQué
--warningsCuenta 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 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
FlagQué
--errorsSolo las sesiones con errores
--with-eventSolo las sesiones que contienen este evento (message)
--min-durationSolo las sesiones que duran al menos esto: 30s, 5m
--sortrecent (por defecto), longest, errors o events
--pageLa 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 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
FlagQué
--searchLos ids que empiezan por esto
--sortlast_seen (por defecto), events, errors, sessions o first_seen
--pageLa 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 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
FlagQué
-n, --limitCuántos eventos recientes mostrar. Por defecto, 20.
--since, --from, --toLa ventana de las sesiones y los eventos. Por defecto, 7d.
--env, --platformComo en events
--export <file>Escribe todos sus eventos como líneas JSON en este archivo, - para stdout
--deleteBorra todos sus eventos (solo propietarios; no se puede deshacer)
-y, --yesCon --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 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 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 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
FlagQué
--byDesglosa por version, country o attr:<path>
--metricevents (por defecto), users (personas) o value (un atributo numérico)
--value-pathCon --metric value: el atributo que contiene el número
--statCon --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  ▁▅██▅▇▅▁
FlagQué
--hitsLos eventos que se cuentan (fallos): "a|b"
--ofLos eventos sobre los que se calcula (intentos): "c|d"
--byDesglosa 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 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
FlagQué
--windowTiempo 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 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%
FlagQué
--orgUna organización, por id o por nombre. Por defecto, todas las tuyas.