Acceso anticipadoSolo por invitación, y los SDK aún no están publicados.Pedir una invitación
Ir al contenido
Docs

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

attrspayload
ParaCampos por los que filtrar, desglosar y graficarDetalle que lees al abrir un evento
Ejemplosids, duraciones, códigos de estado, flagsuna respuesta del servidor, un stack trace
FiltrableSí, por ruta y valor (attr=payment.method:card)No (se guarda comprimido)
Límites200 hojas, strings de hasta 1.024 bytes, arrays de strings de hasta 64 elementos, objetos anidados hasta 4 nivelesCualquier 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.