Événements
lyrelog events cherche avec les filtres de l'explorateur, suit les nouveaux événements en direct et affiche un événement en entier.
lyrelog events, c'est l'explorateur dans un terminal. La commande liste
les événements d'un projet, les plus récents d'abord, sur les 24 dernières heures sauf indication
contraire. Elle répond aussi aux noms lyrelog logs et lyrelog log.
lyrelog events --level warning+ --since 7dTilefall · 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...La première ligne indique le projet, l'environnement et la fenêtre de temps. Chaque événement tient sur une ligne : son heure, son niveau, son nom (message), son domaine (category) et ses attributs. Les événements d'autres jours affichent aussi la date.
Filtres
Les filtres sont ceux de l'explorateur, et ils acceptent la même syntaxe que son URL :
"a|b" pour l'une de plusieurs valeurs, "!a" pour tout sauf celle-là. Mettez-les entre
guillemets, car | et ! ont un sens pour le shell.
| Option | Filtre par |
|---|---|
--level | Niveaux : error, error,critical, ou warning+ pour warning et plus grave. Les niveaux sont trace, debug, info, notice, warning, error, critical. |
--message | Le nom de l'événement (message), à l'identique |
-q, --query | Cherche dans le message, le domaine et les attributs |
--category | Zone (category) : checkout, "a|b" ou "!a" |
--attr | Un attribut, path:value, ou path!:value pour exclure. Répétez-la pour en mettre plusieurs. |
--user | L'identifiant d'une personne (le user_id qu'envoie l'app) |
--session | L'identifiant d'une session |
--install | L'identifiant d'une installation |
--version | Version de l'app : 2.4.0, ou "2.4.0|2.4.1" |
--platform | Plateforme : ios, android, web, python... |
--device | Modèle d'appareil |
--os | Version de l'OS |
--country | Code pays : ES, ou "ES|PT" |
--locale | Paramètres régionaux : es_ES |
--verified | Comment l'expéditeur a été prouvé : server, app_attest, key_attestation, none. "!none" ne garde que les événements vérifiés. |
--env | Environnement. Par défaut, celui du projet, comme dans le tableau de bord ; all cherche dans tous. |
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"L'environnement par défaut est celui du projet : les événements envoyés en development
n'apparaissent donc pas, sauf si vous passez --env development ou --env all (voir
Environnements).
Période
| Option | Rôle |
|---|---|
--since | Une fenêtre qui se termine maintenant : 15m, 1h, 6h, 24h, 7d, 30d, ou n'importe quel nombre de s, m, h, d ou w. Par défaut 24h. |
--from | Le début |
--to | La fin. Par défaut, maintenant. |
--oldest-first | Les plus anciens d'abord, à partir du début de la fenêtre |
--from et --to acceptent :
- RFC 3339 :
2026-11-19T10:00:00Z - une date et une heure dans le fuseau horaire de votre ordinateur :
2026-11-19 10:00 - une date :
2026-11-19, c'est-à-dire minuit au début de ce jour, dans votre fuseau horaire - des millisecondes Unix (
1763550000000) ou des secondes - une durée écoulée :
2h,3d
--since ne se combine pas avec --from ni --to. Avec seulement --from, la fenêtre se
termine maintenant ; avec seulement --to, elle commence 24 heures avant.
lyrelog events --from 3d --to 2d
lyrelog events --from 2026-11-15 --to 2026-11-16 --oldest-firstTilefall · 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…Combien, et la suite
| Option | Rôle |
|---|---|
-n, --limit | Le nombre maximal d'événements. Par défaut 100. Des pages d'au plus 1 000 sont récupérées au fur et à mesure des besoins. |
--cursor | Reprendre là où une liste précédente s'est arrêtée |
Quand il y a plus d'événements que --limit, la dernière ligne donne le --cursor à passer pour
les suivants. Relancez la même commande en ajoutant cette option, avec les mêmes filtres. En mode
JSON, le curseur part sur stderr sous la forme {"more":true,"next":"--cursor ..."} (voir
Le contrat JSON).
Suivre les nouveaux événements
-f (--follow) affiche les derniers événements de la dernière heure (jusqu'à --limit, les
plus anciens d'abord), puis chaque nouvel événement à son arrivée, jusqu'à ce que vous appuyiez
sur Ctrl-C. Toutes les 4 secondes, comme le mode direct du tableau de bord, la commande demande
ce que Lyrelog a reçu depuis la dernière fois. Les nouveaux événements s'affichent dans l'ordre
d'arrivée : un lot qu'un téléphone envoie en retard, après avoir été hors ligne, apparaît à son
arrivée, avec ses propres heures (plus anciennes), tant qu'elles datent des 2 derniers jours.
lyrelog events -fTilefall · production · following, Ctrl-C to stop
10:41:52 ▌info app_launch app cold_start_ms=612 launch_reason=iconlyrelog events -f --level error ne suit que les erreurs.
Les filtres s'appliquent comme d'habitude, mais pas --since, --from ni --to, puisque la commande
montre ce qui arrive à partir de maintenant. En mode JSON, elle écrit un objet JSON par ligne
(NDJSON) ; chacun a un received_at, le moment où Lyrelog l'a reçu (ms Unix), à côté de son
propre ts. Si le serveur reste injoignable un moment, elle le signale sur stderr et continue
d'essayer. Elle s'arrête si la session se termine ou si le projet n'existe plus.
events get
Un événement en entier : qui, où, l'app, l'appareil, ses attributs et son 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"
}L'outil retrouve l'événement par son identifiant parmi tout ce que garde le projet (toute sa durée
de conservation). Passez --ts avec l'heure de l'événement en millisecondes Unix (le champ ts
du JSON) pour y aller directement, sans cette recherche.
| Option | Rôle |
|---|---|
--ts | L'heure de l'événement en millisecondes Unix (évite la recherche) |
events summary
Les totaux (événements, personnes, sessions, erreurs) et les valeurs les plus fréquentes de chaque
champ, comme les montre le panneau latéral de l'explorateur. La commande accepte les mêmes filtres
et options de période qu'events.
lyrelog events summary --since 7dTilefall · 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
Les valeurs les plus fréquentes d'un champ, ou d'un attribut (attr.<path>), dans le cadre des
filtres : ce que propose le menu de filtres de l'explorateur. Les champs comprennent level,
category, message, version, device, country, environment, platform et verified.
lyrelog events values message --level error --since 7dTilefall · 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 8lyrelog events values attr.board.size| Option | Rôle |
|---|---|
--search | Uniquement les valeurs qui contiennent ce texte |
Elle accepte aussi les filtres et les options de période d'events.
events attributes
Les chemins d'attributs que portent les événements, les plus courants d'abord. Aussi
lyrelog events attrs.
lyrelog events attributes --of game_won --numericAttribute Events
hints_used 360
seconds 360| Option | Rôle |
|---|---|
--of | Uniquement dans ces événements (messages) : "a|b" |
--numeric | Uniquement les attributs numériques, ceux que insights trend --metric value peut tracer |
Elle accepte aussi les filtres et les options de période d'events.