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

Erros, sessões e pessoas

As páginas Errors, Sessions, People, Releases, Insights e Usage do painel, como comandos.

Estes comandos mostram o que as páginas do painel mostram. Com exceção de usage, cada um funciona com um só projeto e aceita os filtros e as flags de tempo de lyrelog events: --level, --attr, --version, --platform, --env, --since, --from, --to e o resto. A janela padrão é a dos últimos 7 dias, a menos que você diga outra coisa.

Os exemplos usam um projeto cujas pessoas se chamam players (jogadores). A ferramenta usa a palavra de cada projeto (veja Configurações do projeto).

Erros

lyrelog errors (ou lyrelog issues) é a página Errors: os eventos error e critical agrupados por área e nome de evento, os piores primeiro. Cada linha mostra quantas vezes aconteceu, a variação em relação à janela anterior, quantas pessoas atingiu, quando foi visto pela última vez, as versões em que aconteceu e a tendência.

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      ▄  █  █ ▄  ▄▄  ▄
FlagO quê
--warningsContar também os warnings
lyrelog errors --since 24h --warnings
lyrelog errors --version 2.4.1 --json | jq '.[0]'

Em JSON, cada problema traz um sample_event, um sample_user e um sample_session, prontos para lyrelog events get, lyrelog person e lyrelog events --session.

Sessões

lyrelog sessions é a página Sessions: quem, quanto tempo, quantos eventos e erros, o dispositivo e a versão, e o primeiro e o último evento (com o primeiro erro, se houver).

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
FlagO quê
--errorsSó as sessões com erros
--with-eventSó as sessões que contêm este evento (message)
--min-durationSó as sessões com pelo menos esta duração: 30s, 5m
--sortrecent (padrão), longest, errors ou events
--pageA página, 50 sessões por página, contando a partir de 0

Para ler em ordem os eventos de uma sessão, passe o id dela (o campo sid no JSON) para lyrelog events --session <id> --oldest-first.

Pessoas

lyrelog people é a página People: quem usou o app na janela, com os seus eventos, sessões, erros e o dispositivo e a versão mais recentes. Também atende por lyrelog users e 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
FlagO quê
--searchIds que começam com isto
--sortlast_seen (padrão), events, errors, sessions ou first_seen
--pageA página, 50 pessoas por página, contando a partir de 0

Pessoa

lyrelog person <user-id> (ou user, player) é a página de uma pessoa: quantos eventos ela tem, as suas sessões recentes e os seus eventos mais recentes. O id é o user_id que o app envia, e a correspondência é exata.

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
FlagO quê
-n, --limitQuantos eventos recentes mostrar. Padrão 20.
--since, --from, --toA janela para sessões e eventos. Padrão 7d.
--env, --platformComo em events
--export <file>Gravar todos os eventos da pessoa como linhas JSON neste arquivo, - para o stdout
--deleteApagar todos os eventos da pessoa (só proprietários; não pode ser desfeito)
-y, --yesCom --delete: não pedir confirmação

Solicitações de privacidade

Estas são as ferramentas A person's data do painel (veja Solicitações de privacidade):

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 pede que você digite o id da pessoa para confirmar. No modo JSON ninguém pode responder, então é preciso --yes.

Versões

lyrelog releases (ou lyrelog versions) é a página Releases: para cada versão do app, as pessoas, as sessões, a parcela de sessões sem erros, os erros e os eventos critical, e quando ela foi vista pela primeira e pela ú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 é a página Insights: com que frequência algo acontece (trend), com que frequência falha (rate) e até onde as pessoas chegam num fluxo (funnel).

insights trend

Com que frequência um ou mais eventos acontecem ao longo do tempo, com detalhamento 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
FlagO quê
--byDetalhar por version, country ou attr:<path>
--metricevents (padrão), users (pessoas) ou value (um atributo numérico)
--value-pathCom --metric value: o atributo que contém o número
--statCom --metric value: avg, p50, p90, p95, p99 ou max

lyrelog events attributes --numeric lista os atributos que contêm números.

insights rate

A proporção de um conjunto de eventos sobre outro: falhas sobre tentativas.

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  ▁▅██▅▇▅▁
FlagO quê
--hitsOs eventos contados (falhas): "a|b"
--ofOs eventos sobre os quais se calcula (tentativas): "c|d"
--byDetalhar por version, country ou attr:<path>

insights funnel

Quantas pessoas chegam a cada etapa de um fluxo, em ordem, e quanto tempo cada etapa leva. Passe dois ou mais 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
FlagO quê
--windowTempo permitido da primeira à última etapa. Padrão 1d.

Visualizações salvas

lyrelog insights views lista as visualizações salvas do projeto. lyrelog insights delete-view <id> apaga uma; ele pede confirmação antes, e exige --yes no modo JSON.

Uso

lyrelog usage mostra os eventos deste mês em relação ao seu plano, para cada organização de que você faz parte, e como eles se dividem entre os projetos dela (veja Planos e 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%
FlagO quê
--orgUma organização, pelo id ou pelo nome. Padrão: todas as suas.