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

Événements

Un événement, c'est une chose qui s'est produite, avec un nom stable, un niveau, un domaine et les champs sur lesquels vous filtrez.

Dans Lyrelog, tout est événement. Un événement dit ce qui s'est passé (message), à quel point c'est grave (level), dans quelle partie de l'app (category), pour qui (user_id, session_id, install_id), avec quelques petits champs pour filtrer et faire des graphiques (attrs) et, si besoin, un bloc plus volumineux que vous ne lisez qu'en ouvrant l'événement (payload).

{
  "event_id": "6f1b2c3d-5a1e-4c1f-9e7a-0a1b2c3d4e5f",
  "ts": "2026-11-18T10:00:00.123Z",
  "level": "error",
  "category": "checkout",
  "message": "payment_declined",
  "user_id": "user-1",
  "attrs": { "code": 51, "attempt": 2, "method": "card" },
  "payload": { "response": "..." }
}

Le message est un nom stable

Écrivez message comme un nom d'événement, pas comme une phrase : payment_declined, checkout_done, http_request_failed. Des noms qui ne changent jamais peuvent être comptés, mis en graphique, placés dans un entonnoir et regroupés en erreurs. Mettez ce qui varie (identifiants, durées, codes) dans attrs.

À faireÀ éviter
payment_declined avec attrs: { code: 51 }"Payment declined with code 51 for user-1"

Le message peut faire jusqu'à 2 048 octets.

Niveaux

Du plus discret au plus bruyant : trace, debug, info (par défaut), notice, warning, error, critical. Le tableau de bord donne une couleur à chacun, dessine les erreurs sous l'axe du graphique de l'explorateur et regroupe les événements error et critical sur la page Errors.

Les SDK écartent les événements sous leur minimumLevel (debug par défaut) avant de les mettre en file d'attente.

Catégorie : le domaine de l'app

category (affiché Area dans le tableau de bord) est la partie de l'app à laquelle appartient l'événement : checkout, sync, onboarding, network. Cela fonctionne comme la catégorie d'OSLog. Le tableau de bord filtre et compte selon ce champ. Facultatif, jusqu'à 64 octets. Chaque SDK propose un logger par domaine pour vous éviter de le répéter.

Attributs et payload

attrspayload
PourLes champs sur lesquels filtrer, répartir et faire des graphiquesLe détail que vous lisez en ouvrant un événement
Exemplesidentifiants, durées, codes de statut, indicateursune réponse de serveur, une stack trace
FiltrableOui, par chemin et valeur (attr=payment.method:card)Non (stocké compressé)
Limites200 feuilles, chaînes jusqu'à 1 024 octets, tableaux de chaînes jusqu'à 64 éléments, objets imbriqués jusqu'à 4 niveauxN'importe quel JSON jusqu'à 64 Kio une fois sérialisé

Les valeurs d'attributs peuvent être des chaînes, des nombres, des booléens, null, des tableaux de chaînes et des objets imbriqués. Les noms ne peuvent pas contenir de point (imbriquez plutôt un objet) ni commencer par _.

Loggez les nombres comme des nombres (latency_ms: 412, pas "412") : Insights peut alors en tracer la moyenne, la médiane ou le p95.

Les SDK ajustent chaque événement à ces limites avant de le mettre en file d'attente : les chaînes trop longues sont tronquées sans couper un caractère en deux, et un payload trop gros est remplacé par {"lyrelog_truncated": true, "bytes": N, "preview": "..."}, avec le début du payload comme aperçu.

Contexte

Chaque événement porte aussi une resource : l'identifiant, la version et le build de l'app, l'OS et sa version, le modèle d'appareil, les paramètres régionaux, le SDK, l'environnement et la plateforme. Les SDK la remplissent pour vous. Le serveur ajoute le pays.

Identifiants et doublons

Chaque événement a un event_id, un UUID créé une seule fois, au moment où il est loggé. La livraison est « au moins une fois » : si un lot est envoyé deux fois, les événements de même event_id et ts ne sont stockés qu'une fois.