É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
attrs | payload | |
|---|---|---|
| Pour | Les champs sur lesquels filtrer, répartir et faire des graphiques | Le détail que vous lisez en ouvrant un événement |
| Exemples | identifiants, durées, codes de statut, indicateurs | une réponse de serveur, une stack trace |
| Filtrable | Oui, par chemin et valeur (attr=payment.method:card) | Non (stocké compressé) |
| Limites | 200 feuilles, chaînes jusqu'à 1 024 octets, tableaux de chaînes jusqu'à 64 éléments, objets imbriqués jusqu'à 4 niveaux | N'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.