Eventos
Um evento é uma coisa que aconteceu, com um nome estável, um nível, uma área e os campos pelos quais você filtra.
Tudo no Lyrelog é um evento. Um evento diz o que aconteceu (message), qual a gravidade
(level), em que parte do app (category), com quem (user_id, session_id, install_id),
com alguns campos pequenos para filtrar e montar gráficos (attrs) e, quando preciso, um bloco
maior que você só lê ao abri-lo (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": "..." }
}A mensagem é um nome estável
Escreva message como um nome de evento, não como uma frase: payment_declined,
checkout_done, http_request_failed. Nomes que nunca mudam podem ser contados, virar
gráfico, entrar num funil e ser agrupados em erros. Coloque o que varia (ids, durações, códigos)
em attrs.
| Faça | Não faça |
|---|---|
payment_declined com attrs: { code: 51 } | "Payment declined with code 51 for user-1" |
A mensagem pode ter até 2.048 bytes.
Níveis
Do mais discreto ao mais grave: trace, debug, info (o padrão), notice, warning,
error, critical. O painel dá uma cor a cada um, desenha os erros abaixo do eixo do gráfico do
explorer e agrupa os eventos error e critical na página Errors.
Os SDKs descartam os eventos abaixo do seu minimumLevel (padrão debug) antes de colocá-los
na fila.
Categoria: a área do app
category (exibida como Area no painel) é a parte do app a que o evento pertence:
checkout, sync, onboarding, network. Funciona como a categoria do OSLog. O painel filtra
e conta por ela. É opcional, até 64 bytes. Todo SDK tem um logger por área para você não ter que
repeti-la.
Atributos e payload
attrs | payload | |
|---|---|---|
| Para quê | Campos para filtrar, detalhar e montar gráficos | Detalhes que você lê ao abrir um evento |
| Exemplos | ids, durações, códigos de status, flags | uma resposta de servidor, um stack trace |
| Filtrável | Sim, por caminho e valor (attr=payment.method:card) | Não (guardado comprimido) |
| Limites | 200 folhas, strings de até 1.024 bytes, arrays de strings de até 64 itens, objetos aninhados em até 4 níveis | Qualquer JSON de até 64 KiB depois de serializado |
Os valores dos atributos podem ser strings, números, booleanos, null, arrays de strings e
objetos aninhados. Os nomes não podem conter pontos (aninhe um objeto em vez disso) e não podem
começar com _.
Registre números como números (latency_ms: 412, não "412"): assim o
Insights consegue mostrar a média, a mediana ou o p95 deles.
Os SDKs ajustam cada evento a esses limites antes de colocá-lo na fila: strings longas são
cortadas sem partir um caractere ao meio e um payload grande demais é substituído por
{"lyrelog_truncated": true, "bytes": N, "preview": "..."}, com o início do payload como
prévia.
Contexto
Cada evento também traz um resource: o id, a versão e a build do app, o sistema operacional e a
sua versão, o modelo do dispositivo, a localidade, o SDK, o ambiente
e a plataforma. Os SDKs preenchem isso para você. O servidor acrescenta o
país.
Ids e duplicatas
Todo evento tem um event_id, um UUID gerado uma única vez quando ele é registrado. A entrega é
"pelo menos uma vez": se um lote for enviado duas vezes, os eventos com o mesmo event_id e
ts são guardados uma só vez.