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 7dTilefall · 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.
| Flag | Filtra por |
|---|---|
--level | Niveles: error, error,critical, o warning+ para warning y los más graves. Los niveles son trace, debug, info, notice, warning, error, critical. |
--message | El nombre del evento (message), exacto |
-q, --query | Busca en el mensaje, el área y los atributos |
--category | Área (category): checkout, "a|b" o "!a" |
--attr | Un atributo, path:value, o path!:value para negarlo. Repítelo para añadir más. |
--user | El id de una persona (el user_id que envía la app) |
--session | El id de una sesión |
--install | El id de una instalación |
--version | Versión de la app: 2.4.0, o "2.4.0|2.4.1" |
--platform | Plataforma: ios, android, web, python... |
--device | Modelo de dispositivo |
--os | Versión del sistema operativo |
--country | Código de país: ES, o "ES|PT" |
--locale | Configuración regional: es_ES |
--verified | Cómo se demostró el remitente: server, app_attest, key_attestation, none. "!none" deja solo los eventos verificados. |
--env | Entorno. 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
| Flag | Qué |
|---|---|
--since | Una ventana que termina ahora: 15m, 1h, 6h, 24h, 7d, 30d, o cualquier número de s, m, h, d o w. Por defecto, 24h. |
--from | El inicio |
--to | El final. Por defecto, ahora. |
--oldest-first | Los 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-firstTilefall · 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
| Flag | Qué |
|---|---|
-n, --limit | Cuántos eventos como máximo. Por defecto, 100. Se piden páginas de hasta 1.000 según haga falta. |
--cursor | Continú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 -fTilefall · production · following, Ctrl-C to stop
10:41:52 ▌info app_launch app cold_start_ms=612 launch_reason=iconlyrelog 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.
| Flag | Qué |
|---|---|
--ts | La 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 7dTilefall · 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 7dTilefall · 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 8lyrelog events values attr.board.size| Flag | Qué |
|---|---|
--search | Solo 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 --numericAttribute Events
hints_used 360
seconds 360| Flag | Qué |
|---|---|
--of | Solo en estos eventos (messages): "a|b" |
--numeric | Solo los atributos con números, los que insights trend --metric value puede graficar |
También acepta los filtros y flags de tiempo de events.