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

É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 7d
Tilefall · 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.

OptionFiltre par
--levelNiveaux : error, error,critical, ou warning+ pour warning et plus grave. Les niveaux sont trace, debug, info, notice, warning, error, critical.
--messageLe nom de l'événement (message), à l'identique
-q, --queryCherche dans le message, le domaine et les attributs
--categoryZone (category) : checkout, "a|b" ou "!a"
--attrUn attribut, path:value, ou path!:value pour exclure. Répétez-la pour en mettre plusieurs.
--userL'identifiant d'une personne (le user_id qu'envoie l'app)
--sessionL'identifiant d'une session
--installL'identifiant d'une installation
--versionVersion de l'app : 2.4.0, ou "2.4.0|2.4.1"
--platformPlateforme : ios, android, web, python...
--deviceModèle d'appareil
--osVersion de l'OS
--countryCode pays : ES, ou "ES|PT"
--localeParamètres régionaux : es_ES
--verifiedComment l'expéditeur a été prouvé : server, app_attest, key_attestation, none. "!none" ne garde que les événements vérifiés.
--envEnvironnement. 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

OptionRôle
--sinceUne 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.
--fromLe début
--toLa fin. Par défaut, maintenant.
--oldest-firstLes 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-first
Tilefall · 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

OptionRôle
-n, --limitLe 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.
--cursorReprendre 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 -f
Tilefall · production · following, Ctrl-C to stop

10:41:52 ▌info     app_launch  app  cold_start_ms=612 launch_reason=icon

lyrelog 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.

OptionRôle
--tsL'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 7d
Tilefall · 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 7d
Tilefall · 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        8
lyrelog events values attr.board.size
OptionRôle
--searchUniquement 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 --numeric
Attribute   Events
hints_used     360
seconds        360
OptionRôle
--ofUniquement dans ces événements (messages) : "a|b"
--numericUniquement 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.