Acesso antecipadoSó por convite, e os SDKs ainda não foram publicados.Pedir um convite
Ir para o conteúdo
Docs

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 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...

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.

FlagFiltra por
--levelNíveis: error, error,critical, ou warning+ para warning e piores. Os níveis são trace, debug, info, notice, warning, error, critical.
--messageO nome do evento (message), exato
-q, --queryBusca na mensagem, na área e nos atributos
--categoryÁrea (category): checkout, "a|b" ou "!a"
--attrUm atributo, path:value, ou path!:value para negar. Repita para usar mais.
--userO id de uma pessoa (o user_id que o app envia)
--sessionO id de uma sessão
--installO id de uma instalação
--versionVersão do app: 2.4.0, ou "2.4.0|2.4.1"
--platformPlataforma: ios, android, web, python...
--deviceModelo do dispositivo
--osVersão do sistema operacional
--countryCódigo do país: ES, ou "ES|PT"
--localeLocalidade: es_ES
--verifiedComo o remetente foi comprovado: server, app_attest, key_attestation, none. "!none" mantém só os eventos verificados.
--envAmbiente. 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

FlagO quê
--sinceUma janela que termina agora: 15m, 1h, 6h, 24h, 7d, 30d, ou qualquer número de s, m, h, d ou w. Padrão 24h.
--fromO início
--toO fim. Padrão: agora.
--oldest-firstOs 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-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…

Quantos, e o resto

FlagO quê
-n, --limitQuantos eventos no máximo. Padrão 100. Páginas de até 1.000 são buscadas conforme necessário.
--cursorContinuar 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 -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 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.

FlagO quê
--tsA 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 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

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 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
FlagO quê
--searchSó 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 --numeric
Attribute   Events
hints_used     360
seconds        360
FlagO quê
--ofSó nestes eventos (messages): "a|b"
--numericSó 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.