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 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 ▄ █ █ ▄ ▄▄ ▄| Option | Rôle |
|---|---|
--warnings | Compter 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 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| Option | Rôle |
|---|---|
--errors | Uniquement les sessions avec des erreurs |
--with-event | Uniquement les sessions qui contiennent cet événement (message) |
--min-duration | Uniquement les sessions d'au moins cette durée : 30s, 5m |
--sort | recent (par défaut), longest, errors ou events |
--page | La 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 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| Option | Rôle |
|---|---|
--search | Les identifiants qui commencent par ce texte |
--sort | last_seen (par défaut), events, errors, sessions ou first_seen |
--page | La 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 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| Option | Rôle |
|---|---|
-n, --limit | Le nombre d'événements récents à afficher. Par défaut 20. |
--since, --from, --to | La fenêtre des sessions et des événements. Par défaut 7d. |
--env, --platform | Comme dans events |
--export <file> | Écrire tous ses événements en lignes JSON dans ce fichier, - pour stdout |
--delete | Supprimer tous ses événements (propriétaires uniquement ; irréversible) |
-y, --yes | Avec --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 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 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 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| Option | Rôle |
|---|---|
--by | Répartir par version, country ou attr:<path> |
--metric | events (par défaut), users (les personnes), ou value (un attribut numérique) |
--value-path | Avec --metric value : l'attribut qui contient le nombre |
--stat | Avec --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 ▁▅██▅▇▅▁| Option | Rôle |
|---|---|
--hits | Les événements comptés (échecs) : "a|b" |
--of | Les événements de référence (tentatives) : "c|d" |
--by | Ré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 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| Option | Rôle |
|---|---|
--window | Le 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 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%| Option | Rôle |
|---|---|
--org | Une organisation, par identifiant ou par nom. Par défaut : toutes les vôtres. |