Journaux

Ronne écrit une ligne par événement sur sa sortie standard, en JSON : quand c'est arrivé, sa gravité, ce qui s'est passé et la requête à laquelle elle appartient. L'endroit où va cette sortie dépend de la façon dont Ronne tourne :

Une ligne ressemble à ceci :

{"time":"2026-10-14T14:03:22.417Z","level":"info","msg":"Released","domain":"submissions","event":"version.released","requestId":"01K7…","userId":"01J9…","count":3}

• Toujours : time (UTC), level et msg, une courte phrase qui ne change jamais.
• Quand ils s'appliquent : event, un nom stable pour chercher et alerter; domain, la partie de Ronne qui l'a écrite; requestId, la requête à laquelle elle appartient; userId, qui l'a faite (un identifiant, jamais un courriel ni un nom); err, le nom, le message et le code d'une erreur, avec sa pile au niveau error; avec le traçage actif, traceId et spanId, le span où elle a été écrite (Supervision).
• Les champs propres à l'événement : des nombres, des décomptes et de courtes raisons, comme status ou count.
• Les lignes de Better Auth (la bibliothèque de connexion) : msg vaut Better Auth, avec source et son texte dans detail.

LOG_LEVEL (debug, info, warn ou error; info par défaut) fixe la gravité minimale des lignes écrites : warn est ce que quelqu'un doit regarder, error une panne, et debug ajoute des détails dont personne n'a besoin au quotidien. Une valeur inconnue écrit un avertissement et utilise info. LOG_FORMAT vaut json, ou text pour une personne qui lit un terminal (par défaut avec pnpm dev). Réglez l'une ou l'autre dans le fichier de réglages ou l'environnement (avec Docker, dans le fichier .env à côté de compose.yaml, puis docker compose up -d), puis redémarrez Ronne.

Les événements :

Jamais dans une ligne : les mots de passe, les jetons d'accès, les cookies, AUTH_SECRET, le mot de passe d'une base, les courriels, les adresses IP des personnes, ni les noms des éléments, des portées et des espaces de travail (les noms d'un espace privé restent privés). Ronne ne les écrit pas, et son module de journalisation retire en plus ce qui pourrait s'y glisser, messages d'erreur compris : les champs nommés comme un secret, les jetons d'accès, les mots de passe dans les adresses, les courriels, les chemins des fichiers stockés et la valeur qu'une base cite dans une erreur de clé en double. Next.js affiche aussi lui-même une erreur inattendue, en texte brut à côté de la ligne de Ronne : ce texte est celui de Next.js, qui ne passe pas par le module de journalisation de Ronne. De même pour l'erreur que Better Auth (la bibliothèque de connexion) affiche quand la base elle-même échoue pendant une requête.

Signaler un problème : chaque réponse d'une page ou de l'API porte un en-tête X-Request-Id, et le message de l'API pour une erreur inattendue le cite. Donnez-le, et qui administre l'instance retrouve les lignes de cette requête par leur requestId. Derrière un proxy qui pose son propre X-Request-Id, Ronne le garde avec TRUST_PROXY=true, pour qu'un même identifiant suive la requête.