Eventos
Un evento es una cosa que pasó, con un nombre estable, un nivel, un área y los campos por los que filtras.
En Lyrelog todo es un evento. Un evento dice qué pasó (message), con qué gravedad (level), en
qué parte de la app (category), a quién (user_id, session_id, install_id), con algunos
campos pequeños para filtrar y hacer gráficos (attrs) y, si hace falta, un bloque más grande
que solo lees al abrirlo (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": "..." }
}El mensaje es un nombre estable
Escribe message como nombre de evento, no como una frase: payment_declined, checkout_done,
http_request_failed. Los nombres que nunca cambian se pueden contar, graficar, meter en un
embudo y agrupar en errores. Lo que varía (ids, duraciones, códigos) va en attrs.
| Así sí | Así no |
|---|---|
payment_declined con attrs: { code: 51 } | "Payment declined with code 51 for user-1" |
El mensaje puede ocupar hasta 2.048 bytes.
Niveles
Del más discreto al más grave: trace, debug, info (el predeterminado), notice, warning,
error, critical. El panel da un color a cada uno, dibuja los errores por debajo del eje del
gráfico del explorador y agrupa los eventos error y critical en la página
Errors.
Los SDK descartan los eventos por debajo de su minimumLevel (por defecto debug) antes de
ponerlos en cola.
Categoría: el área de la app
category (que en el panel aparece como Area) es la parte de la app a la que pertenece el
evento: checkout, sync, onboarding, network. Funciona como la categoría de OSLog. El panel
filtra y cuenta por ella. Es opcional, de hasta 64 bytes. Todos los SDK tienen un logger por área
para que no tengas que repetirla.
Atributos y payload
attrs | payload | |
|---|---|---|
| Para | Campos por los que filtrar, desglosar y graficar | Detalle que lees al abrir un evento |
| Ejemplos | ids, duraciones, códigos de estado, flags | una respuesta del servidor, un stack trace |
| Filtrable | Sí, por ruta y valor (attr=payment.method:card) | No (se guarda comprimido) |
| Límites | 200 hojas, strings de hasta 1.024 bytes, arrays de strings de hasta 64 elementos, objetos anidados hasta 4 niveles | Cualquier JSON de hasta 64 KiB una vez serializado |
Los valores de los atributos pueden ser strings, números, booleanos, null, arrays de strings y
objetos anidados. Los nombres no pueden contener puntos (anida un objeto en su lugar) ni empezar
por _.
Registra los números como números (latency_ms: 412, no "412"): así
Insights puede graficar su media, su mediana o su p95.
Los SDK ajustan cada evento a estos límites antes de ponerlo en cola: los strings largos se
cortan sin partir ningún carácter y un payload demasiado grande se sustituye por
{"lyrelog_truncated": true, "bytes": N, "preview": "..."}, con el comienzo del payload como
vista previa.
Contexto
Cada evento lleva además un resource: el id de la app, su versión y build, el sistema operativo
y su versión, el modelo de dispositivo, la configuración regional, el SDK, el
entorno y la plataforma. Los SDK lo rellenan
por ti. El servidor añade el país.
Ids y duplicados
Cada evento tiene un event_id, un UUID que se crea una sola vez, al registrarlo. La entrega es
al menos una vez: si un lote se envía dos veces, los eventos con el mismo event_id y el mismo
ts se guardan una sola vez.