Logs

O Ronne escreve uma linha por evento na saída padrão, em JSON: quando aconteceu, a gravidade, o que aconteceu e a requisição a que pertence. Para onde essa saída vai depende de como o Ronne roda:

Uma linha é assim:

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

• Sempre: time (UTC), level e msg, uma frase curta que nunca muda.
• Quando se aplicam: event, um nome estável para buscar e criar alertas; domain, a parte do Ronne que a escreveu; requestId, a requisição a que pertence; userId, quem a fez (um id, nunca um e-mail ou um nome); err, o nome, a mensagem e o código de um erro, com a pilha em error; com o rastreamento ligado, traceId e spanId, o span em que foi escrita (Monitoramento).
• Os campos do próprio evento: números, contagens e motivos curtos, como status ou count.
• As linhas do próprio Better Auth (a biblioteca de login): msg é Better Auth, com source e o texto dele em detail.

LOG_LEVEL (debug, info, warn ou error; info por padrão) define a gravidade mínima das linhas escritas: warn é o que alguém deve olhar, error uma falha, e debug acrescenta detalhes que ninguém precisa no dia a dia. Um valor desconhecido escreve um aviso e usa info. LOG_FORMAT é json, ou text para uma pessoa lendo um terminal (o padrão com pnpm dev). Defina-os no arquivo de configurações ou no ambiente (com Docker, no arquivo .env ao lado do compose.yaml, depois docker compose up -d), e reinicie o Ronne.

Os eventos:

Nunca numa linha: senhas, tokens de acesso, cookies, AUTH_SECRET, a senha de um banco, e-mails, endereços IP de pessoas, nem os nomes de itens, escopos e espaços de trabalho (os nomes de um espaço de trabalho privado continuam privados). O Ronne não os escreve, e o logger ainda tira o que poderia escapar, mensagens de erro incluídas: campos com nome de segredo, tokens de acesso, senhas em endereços, e-mails, os caminhos dos arquivos guardados e o valor que um banco cita num erro de chave duplicada. O Next.js também imprime um erro inesperado por conta própria, em texto simples ao lado da linha do Ronne: esse texto é do próprio Next.js, fora do logger do Ronne. O mesmo vale para o erro que o Better Auth (a biblioteca de login) imprime quando o próprio banco falha no meio de uma requisição.

Para relatar um problema: toda resposta de página e da API traz um cabeçalho X-Request-Id, e a mensagem da API para um erro inesperado o menciona. Informe-o, e quem administra a instância encontra as linhas dessa requisição pelo requestId. Atrás de um proxy que define o próprio X-Request-Id, o Ronne o mantém com TRUST_PROXY=true, para que um só ID acompanhe a requisição.