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

Eventos

lyrelog events busca con los filtros del explorador, sigue los eventos nuevos en directo y muestra un evento completo.

lyrelog events es el explorador en una terminal. Lista los eventos de un proyecto, los más recientes primero, de las últimas 24 horas salvo que indiques otra cosa. También responde a lyrelog logs y lyrelog log.

lyrelog events --level warning+ --since 7d
Tilefall · production · last 7 days

10:30:07 ▌error    cloud_save_failed    sync  reason=schema_mismatch record=progress status=422
10:27:43 ▌error    cloud_save_failed    sync  reason=schema_mismatch record=progress status=422
10:24:48 ▌error    cloud_save_failed    sync  reason=schema_mismatch record=progress status=422
10:22:05 ▌error    cloud_save_failed    sync  reason=schema_mismatch record=progress status=422
10:17:06 ▌error    chat_socket_gave_up  chat  attempts=4 match_id=0d9acb1f-503f-4818-a5a1-19336d1f0d8a

Showing 5 events. For more: --cursor MTc5NTE2NjIyNjExMTo3...

La primera línea indica el proyecto, el entorno y la ventana de tiempo. Cada evento ocupa una línea: su hora, su nivel, su nombre (message), su área (category) y sus atributos. Los eventos de otros días muestran también la fecha.

Filtros

Los filtros son los del explorador y aceptan lo mismo que su URL: "a|b" para cualquiera de varios valores, "!a" para cualquier cosa menos ese. Ponlos entre comillas, porque | y ! significan algo para el shell.

FlagFiltra por
--levelNiveles: error, error,critical, o warning+ para warning y los más graves. Los niveles son trace, debug, info, notice, warning, error, critical.
--messageEl nombre del evento (message), exacto
-q, --queryBusca en el mensaje, el área y los atributos
--categoryÁrea (category): checkout, "a|b" o "!a"
--attrUn atributo, path:value, o path!:value para negarlo. Repítelo para añadir más.
--userEl id de una persona (el user_id que envía la app)
--sessionEl id de una sesión
--installEl id de una instalación
--versionVersión de la app: 2.4.0, o "2.4.0|2.4.1"
--platformPlataforma: ios, android, web, python...
--deviceModelo de dispositivo
--osVersión del sistema operativo
--countryCódigo de país: ES, o "ES|PT"
--localeConfiguración regional: es_ES
--verifiedCómo se demostró el remitente: server, app_attest, key_attestation, none. "!none" deja solo los eventos verificados.
--envEntorno. El predeterminado del proyecto, como en el panel; all busca en todos.
lyrelog events --attr board.size:9 --attr result!:win
lyrelog events --level error --version "2.4.0|2.4.1" --platform '!web'
lyrelog events --user pl-fe0958c6 --since 7d --limit 500
lyrelog events --verified '!none'
lyrelog events --env all -q "card declined"

El entorno por defecto es el del proyecto, así que los eventos enviados en development no aparecen salvo que pases --env development o --env all (consulta Entornos).

Tiempo

FlagQué
--sinceUna ventana que termina ahora: 15m, 1h, 6h, 24h, 7d, 30d, o cualquier número de s, m, h, d o w. Por defecto, 24h.
--fromEl inicio
--toEl final. Por defecto, ahora.
--oldest-firstLos más antiguos primero, desde el inicio de la ventana

--from y --to aceptan:

  • RFC 3339: 2026-11-19T10:00:00Z
  • una fecha y una hora en la zona horaria de tu ordenador: 2026-11-19 10:00
  • una fecha: 2026-11-19, que significa la medianoche con la que empieza, en tu zona horaria
  • milisegundos Unix (1763550000000) o segundos
  • hace cuánto: 2h, 3d

--since no se puede combinar con --from ni con --to. Con solo --from, la ventana termina ahora; con solo --to, empieza 24 horas antes.

lyrelog events --from 3d --to 2d
lyrelog events --from 2026-11-15 --to 2026-11-16 --oldest-first
Tilefall · production · Nov 15 00:00 to Nov 16 00:00

Nov 15 00:00:00 ▌info     leaderboard_submit_confirmed  leaderboards  board=tilefall.daily.pure latency_ms=420
Nov 15 00:00:11 ▌info     game_started                  game          board.seed=4052403362615 board.size=7 m…
Nov 15 00:00:17 ▌info     match_round_won               multiplayer   match_id=b60cc0cc-b294-46a3-9186-35c71a…

Cuántos, y el resto

FlagQué
-n, --limitCuántos eventos como máximo. Por defecto, 100. Se piden páginas de hasta 1.000 según haga falta.
--cursorContinúa donde se detuvo una lista anterior

Cuando hay más eventos que --limit, la última línea da el --cursor que tienes que pasar para los siguientes. Vuelve a ejecutar el mismo comando añadiendo ese flag y con los mismos filtros. En modo JSON, el cursor va a stderr como {"more":true,"next":"--cursor ..."} (consulta El contrato del JSON).

Seguir los eventos nuevos

-f (--follow) imprime los últimos eventos de la última hora (hasta --limit, los más antiguos primero) y después cada uno nuevo a medida que llega, hasta que pulses Ctrl-C. Cada 4 segundos, como el modo en directo del panel, pregunta qué ha recibido Lyrelog desde la última vez. Los eventos nuevos se imprimen en el orden en que llegaron, así que un lote que un teléfono envía tarde, después de estar sin conexión, aparece cuando llega, con sus propias horas (más antiguas), siempre que estén dentro de los últimos 2 días.

lyrelog events -f
Tilefall · production · following, Ctrl-C to stop

10:41:52 ▌info     app_launch  app  cold_start_ms=612 launch_reason=icon

lyrelog events -f --level error sigue solo los errores.

Los filtros funcionan como siempre. --since, --from y --to no, porque con -f solo se muestra lo que llega a partir de ahora. En modo JSON escribe un objeto JSON por línea (NDJSON); cada uno tiene received_at, cuándo lo recibió Lyrelog (ms Unix), junto a su propio ts. Si no puede conectar con el servidor durante un rato, lo dice en stderr y sigue intentándolo. Se detiene si la sesión termina o el proyecto ya no existe.

events get

Un evento completo: quién, dónde, la app, el dispositivo, sus atributos y su payload.

lyrelog events get adea33e4-26eb-422e-b904-96649c0e7830
▌ cloud_save_failed  error
  sync

  Time         2026-11-20 10:30:07.485 CET  8m ago
  Event        adea33e4-26eb-422e-b904-96649c0e7830
  Player       pl-fe0958c6
  Session      51e19a18-ca3e-4428-a10b-baeadc7eaaf8
  Install      76f5a7d0-81b0-4c36-8908-eefd6c936abf
  App          com.example.tilefall 1.6.3 (202609301304)
  Device       iPhone18,2 iOS 27.2.0
  Locale       fr_FR
  Country      FR
  Environment  production
  Platform     ios

Attributes
  {
    "reason": "schema_mismatch",
    "record": "progress",
    "status": 422
  }

Payload
  {
    "description": "The server refused the save",
    "detail": "field 'mode' is not allowed in format 3; expected format 4"
  }

La herramienta busca el evento por su id entre todo lo que guarda el proyecto (toda su retención). Pasa --ts con la hora del evento en milisegundos Unix (el campo ts del JSON) para ir directamente a él y ahorrarte esa búsqueda.

FlagQué
--tsLa hora del evento en milisegundos Unix (se salta la búsqueda)

events summary

Los totales (eventos, personas, sesiones, errores) y los valores más frecuentes de cada campo, como los muestra el panel lateral del explorador. Acepta los mismos filtros y flags de tiempo que events.

lyrelog events summary --since 7d
Tilefall · production · last 7 days

  52,886 events  300 players  3,202 sessions  1,127 errors

  category     game 11.6k  leaderboards 10k  app 7,110  daily 5,362  campaign 5,126  account 3,304
  level        info 36.7k  debug 13.7k  error 1,110  warning 1,074  notice 292  critical 17
  version      2.0 30.4k  1.6.3 22.5k
  ...

events values

Los valores más frecuentes de un campo, o de un atributo (attr.<path>), dentro de los filtros: lo que ofrece el menú de filtros del explorador. Entre los campos están level, category, message, version, device, country, environment, platform y verified.

lyrelog events values message --level error --since 7d
Tilefall · production · last 7 days

Message                    Events  Players
cloud_save_failed             823      124
daily_upload_failed           178      124
match_update_denied            43       38
leaderboard_submit_failed      29       17
chat_socket_gave_up            28       28
purchase_failed                 9        8
lyrelog events values attr.board.size
FlagQué
--searchSolo los valores que contienen esto

También acepta los filtros y flags de tiempo de events.

events attributes

Las rutas de atributos que llevan los eventos, las más comunes primero. También lyrelog events attrs.

lyrelog events attributes --of game_won --numeric
Attribute   Events
hints_used     360
seconds        360
FlagQué
--ofSolo en estos eventos (messages): "a|b"
--numericSolo los atributos con números, los que insights trend --metric value puede graficar

También acepta los filtros y flags de tiempo de events.