Acesso antecipadoSó por convite, e os SDKs ainda não foram publicados.Pedir um convite
Ir para o conteúdo
Docs

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çaNã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

attrspayload
Para quêCampos para filtrar, detalhar e montar gráficosDetalhes que você lê ao abrir um evento
Exemplosids, durações, códigos de status, flagsuma resposta de servidor, um stack trace
FiltrávelSim, por caminho e valor (attr=payment.method:card)Não (guardado comprimido)
Limites200 folhas, strings de até 1.024 bytes, arrays de strings de até 64 itens, objetos aninhados em até 4 níveisQualquer 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.