Eventos
lyrelog events busca com os filtros do explorer, acompanha os eventos novos ao vivo e mostra um evento por inteiro.
lyrelog events é o explorer num terminal. Ele lista os eventos de um
projeto, os mais novos primeiro, das últimas 24 horas, a menos que você diga outra coisa. Ele
também atende por lyrelog logs e 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...A primeira linha diz o projeto, o ambiente e a janela de tempo. Cada evento ocupa uma linha: a hora, o nível, o nome (message), a área (category) e os atributos. Eventos de outros dias também mostram a data.
Filtros
Os filtros são os do explorer, e aceitam o mesmo que o endereço dele: "a|b" para qualquer um
de vários valores, "!a" para tudo menos aquele. Coloque-os entre aspas, porque | e !
significam algo para o shell.
| Flag | Filtra por |
|---|---|
--level | Níveis: error, error,critical, ou warning+ para warning e piores. Os níveis são trace, debug, info, notice, warning, error, critical. |
--message | O nome do evento (message), exato |
-q, --query | Busca na mensagem, na área e nos atributos |
--category | Área (category): checkout, "a|b" ou "!a" |
--attr | Um atributo, path:value, ou path!:value para negar. Repita para usar mais. |
--user | O id de uma pessoa (o user_id que o app envia) |
--session | O id de uma sessão |
--install | O id de uma instalação |
--version | Versão do app: 2.4.0, ou "2.4.0|2.4.1" |
--platform | Plataforma: ios, android, web, python... |
--device | Modelo do dispositivo |
--os | Versão do sistema operacional |
--country | Código do país: ES, ou "ES|PT" |
--locale | Localidade: es_ES |
--verified | Como o remetente foi comprovado: server, app_attest, key_attestation, none. "!none" mantém só os eventos verificados. |
--env | Ambiente. O padrão é o ambiente padrão do projeto, como no painel; all busca em 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"O ambiente padrão é o do projeto, então os eventos enviados em development não aparecem, a
menos que você passe --env development ou --env all (veja
Ambientes).
Tempo
| Flag | O quê |
|---|---|
--since | Uma janela que termina agora: 15m, 1h, 6h, 24h, 7d, 30d, ou qualquer número de s, m, h, d ou w. Padrão 24h. |
--from | O início |
--to | O fim. Padrão: agora. |
--oldest-first | Os mais antigos primeiro, a partir do início da janela |
--from e --to aceitam:
- RFC 3339:
2026-11-19T10:00:00Z - uma data e hora no fuso horário do seu computador:
2026-11-19 10:00 - uma data:
2026-11-19, que significa a meia-noite do início desse dia, no seu fuso horário - milissegundos Unix (
1763550000000) ou segundos - quanto tempo atrás:
2h,3d
--since não pode ser usado com --from nem com --to. Só com --from, a janela termina
agora; só com --to, ela começa 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…Quantos, e o resto
| Flag | O quê |
|---|---|
-n, --limit | Quantos eventos no máximo. Padrão 100. Páginas de até 1.000 são buscadas conforme necessário. |
--cursor | Continuar de onde uma lista anterior parou |
Quando há mais eventos do que --limit, a última linha traz o --cursor a passar para os
próximos. Rode o mesmo comando de novo com essa flag, mantendo os mesmos filtros. No modo JSON, o
cursor vai para o stderr como {"more":true,"next":"--cursor ..."} (veja
O contrato do JSON).
Acompanhar os eventos novos
-f (--follow) mostra os eventos mais recentes da última hora (até --limit, os mais antigos
primeiro) e depois cada evento novo conforme ele chega, até você apertar Ctrl-C. A cada 4
segundos, como o modo ao vivo do painel, ele pergunta o que o Lyrelog recebeu desde a última vez.
Os eventos novos aparecem na ordem em que chegaram, então um lote que um celular envia atrasado,
depois de ficar offline, aparece quando chega, com os seus próprios horários (mais antigos),
desde que estejam dentro dos últimos 2 dias.
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 acompanha só os erros.
Os filtros funcionam como sempre. --since, --from e --to não, porque ele mostra o que chega
daqui em diante. No modo JSON, ele escreve um objeto JSON por linha (NDJSON); cada um tem
received_at, quando o Lyrelog o recebeu (Unix ms), ao lado do seu próprio ts. Se o servidor
ficar inacessível por um tempo, ele avisa no stderr e continua tentando. Ele para se a sessão
terminar ou se o projeto deixar de existir.
events get
Um evento por inteiro: quem, onde, o app, o dispositivo, os atributos e o 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"
}A ferramenta encontra o evento pelo id entre tudo o que o projeto guarda (toda a sua retenção).
Passe --ts com a hora do evento em milissegundos Unix (o campo ts do JSON) para ir direto a
ele, sem essa busca.
| Flag | O quê |
|---|---|
--ts | A hora do evento em milissegundos Unix (pula a busca) |
events summary
Os totais (eventos, pessoas, sessões, erros) e os valores mais frequentes de cada campo, como o
painel lateral do explorer os mostra. Aceita os mesmos filtros e flags de tempo 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
Os valores mais frequentes de um campo, ou de um atributo (attr.<path>), dentro dos filtros: o
que o menu de filtros do explorer oferece. Os campos incluem level, category, message,
version, device, country, environment, platform e 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 | O quê |
|---|---|
--search | Só os valores que contêm isto |
Também aceita os filtros e as flags de tempo de events.
events attributes
Os caminhos de atributo que os eventos trazem, os mais comuns primeiro. Também
lyrelog events attrs.
lyrelog events attributes --of game_won --numericAttribute Events
hints_used 360
seconds 360| Flag | O quê |
|---|---|
--of | Só nestes eventos (messages): "a|b" |
--numeric | Só os atributos com números, os que insights trend --metric value consegue mostrar num gráfico |
Também aceita os filtros e as flags de tempo de events.