Accès anticipéSur invitation, et les SDK ne sont pas encore publiés.Demander une invitation
Aller au contenu
Docs

Erreurs, sessions et personnes

Les pages Errors, Sessions, People, Releases, Insights et Usage du tableau de bord, sous forme de commandes.

Ces commandes reprennent ce qu'affichent les pages du tableau de bord. Sauf usage, chacune travaille sur un projet et accepte les filtres et options de période de lyrelog events : --level, --attr, --version, --platform, --env, --since, --from, --to et les autres. Leur fenêtre est celle des 7 derniers jours, sauf indication contraire.

Les exemples utilisent un projet dont les personnes s'appellent des joueurs (players). L'outil emploie le mot choisi par chaque projet (voir Project settings).

Erreurs

lyrelog errors (ou lyrelog issues) correspond à la page Errors : les événements error et critical regroupés par domaine et nom d'événement, les pires d'abord. Chaque ligne indique combien de fois c'est arrivé, l'évolution par rapport à la fenêtre précédente, combien de personnes ont été touchées, quand c'est arrivé pour la dernière fois, les versions concernées et la tendance.

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      ▄  █  █ ▄  ▄▄  ▄
OptionRôle
--warningsCompter aussi les warnings
lyrelog errors --since 24h --warnings
lyrelog errors --version 2.4.1 --json | jq '.[0]'

En JSON, chaque problème porte un sample_event, un sample_user et un sample_session, prêts pour lyrelog events get, lyrelog person et lyrelog events --session.

Sessions

lyrelog sessions correspond à la page Sessions : qui, combien de temps, combien d'événements et d'erreurs, l'appareil et la version, et le premier et le dernier événement (avec la première erreur, s'il y en a une).

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
OptionRôle
--errorsUniquement les sessions avec des erreurs
--with-eventUniquement les sessions qui contiennent cet événement (message)
--min-durationUniquement les sessions d'au moins cette durée : 30s, 5m
--sortrecent (par défaut), longest, errors ou events
--pageLa page, 50 sessions par page, en comptant à partir de 0

Pour lire dans l'ordre les événements d'une session, passez son identifiant (le champ sid en JSON) à lyrelog events --session <id> --oldest-first.

Personnes

lyrelog people correspond à la page People : qui a utilisé l'app pendant la fenêtre, avec ses événements, sessions, erreurs, et son dernier appareil et sa dernière version. La commande répond aussi aux noms lyrelog users et 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
OptionRôle
--searchLes identifiants qui commencent par ce texte
--sortlast_seen (par défaut), events, errors, sessions ou first_seen
--pageLa page, 50 personnes par page, en comptant à partir de 0

Personne

lyrelog person <user-id> (ou user, player) correspond à la page d'une personne : son nombre d'événements, ses sessions récentes et ses derniers événements. L'identifiant est le user_id qu'envoie l'app, comparé à l'identique.

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
OptionRôle
-n, --limitLe nombre d'événements récents à afficher. Par défaut 20.
--since, --from, --toLa fenêtre des sessions et des événements. Par défaut 7d.
--env, --platformComme dans events
--export <file>Écrire tous ses événements en lignes JSON dans ce fichier, - pour stdout
--deleteSupprimer tous ses événements (propriétaires uniquement ; irréversible)
-y, --yesAvec --delete : ne pas demander de confirmation

Demandes liées à la vie privée

Ce sont les outils A person's data du tableau de bord (voir Demandes liées à la vie privée) :

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 vous demande de taper l'identifiant de la personne pour confirmer. En mode JSON, personne ne peut répondre : il faut donc --yes.

Versions

lyrelog releases (ou lyrelog versions) correspond à la page Releases : pour chaque version de l'app, les personnes, les sessions, la part de sessions sans erreur, les erreurs et les événements critical, et quand elle a été vue pour la première et la dernière fois.

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 correspond à la page Insights : à quelle fréquence quelque chose se produit (trend), à quelle fréquence cela échoue (rate), et jusqu'où les personnes vont dans un parcours (funnel).

insights trend

À quelle fréquence un ou plusieurs événements se produisent dans le temps, avec une répartition en option.

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
OptionRôle
--byRépartir par version, country ou attr:<path>
--metricevents (par défaut), users (les personnes), ou value (un attribut numérique)
--value-pathAvec --metric value : l'attribut qui contient le nombre
--statAvec --metric value : avg, p50, p90, p95, p99 ou max

lyrelog events attributes --numeric liste les attributs qui contiennent des nombres.

insights rate

La part d'un ensemble d'événements par rapport à un autre : les échecs sur les tentatives.

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  ▁▅██▅▇▅▁
OptionRôle
--hitsLes événements comptés (échecs) : "a|b"
--ofLes événements de référence (tentatives) : "c|d"
--byRépartir par version, country ou attr:<path>

insights funnel

Combien de personnes atteignent chaque étape d'un parcours, dans l'ordre, et combien de temps prend chaque étape. Donnez deux événements ou plus.

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
OptionRôle
--windowLe temps accordé entre la première et la dernière étape. Par défaut 1d.

Vues enregistrées

lyrelog insights views liste les vues enregistrées du projet. lyrelog insights delete-view <id> en supprime une ; la commande demande d'abord confirmation, et exige --yes en mode JSON.

Utilisation

lyrelog usage affiche les événements de ce mois par rapport à votre offre, pour chaque organisation dont vous faites partie, et leur répartition entre ses projets (voir Offres et utilisation).

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%
OptionRôle
--orgUne organisation, par identifiant ou par nom. Par défaut : toutes les vôtres.