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 errorsTilefall · 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 ▄ █ █ ▄ ▄▄ ▄| Flag | O quê |
|---|---|
--warnings | Contar 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 longestTilefall · 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| Flag | O quê |
|---|---|
--errors | Só as sessões com erros |
--with-event | Só as sessões que contêm este evento (message) |
--min-duration | Só as sessões com pelo menos esta duração: 30s, 5m |
--sort | recent (padrão), longest, errors ou events |
--page | A 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 errorsTilefall · 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| Flag | O quê |
|---|---|
--search | Ids que começam com isto |
--sort | last_seen (padrão), events, errors, sessions ou first_seen |
--page | A 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 4Player 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| Flag | O quê |
|---|---|
-n, --limit | Quantos eventos recentes mostrar. Padrão 20. |
--since, --from, --to | A janela para sessões e eventos. Padrão 7d. |
--env, --platform | Como em events |
--export <file> | Gravar todos os eventos da pessoa como linhas JSON neste arquivo, - para o stdout |
--delete | Apagar todos os eventos da pessoa (só proprietários; não pode ser desfeito) |
-y, --yes | Com --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 releasesTilefall · 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 agoInsights
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 versionTilefall · 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| Flag | O quê |
|---|---|
--by | Detalhar por version, country ou attr:<path> |
--metric | events (padrão), users (pessoas) ou value (um atributo numérico) |
--value-path | Com --metric value: o atributo que contém o número |
--stat | Com --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 ▁▅██▅▇▅▁| Flag | O quê |
|---|---|
--hits | Os eventos contados (falhas): "a|b" |
--of | Os eventos sobre os quais se calcula (tentativas): "c|d" |
--by | Detalhar 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 1hTilefall · 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| Flag | O quê |
|---|---|
--window | Tempo 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 usageAlex 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%| Flag | O quê |
|---|---|
--org | Uma organização, pelo id ou pelo nome. Padrão: todas as suas. |