Saltar al contenido principal

El evento

El cuerpo de POST /api/events: un error, o un mensaje, tal como lo manda un SDK. Ver Protocolo de envío.

{
"v": 1,
"uuid": "6f9c2a1e-8b3d-4c5e-9f0a-1b2c3d4e5f60",
"timestamp": "2026-11-01T10:41:02.123Z",
"platform": "elixir",
"level": "error",
"environment": "prod",
"release": "v57",
"server": "shop@ip-10-0-1-12",
"exception": {
"type": "Ecto.NoResultsError",
"message": "expected at least one result but got none",
"frames": [
{
"module": "Shop.Orders",
"function": "get_by_token!/1",
"file": "lib/shop/orders.ex",
"line": 88,
"in_app": true,
"context": {"pre": ["…"], "line": "…", "post": ["…"]}
}
]
},
"message": null,
"fingerprint": null,
"request": {"method": "GET", "url": "https://…", "headers": {"user-agent": "…"}},
"user": {"id": "4812"},
"tags": {"node": "shop@ip-10-0-1-12"},
"breadcrumbs": [
{"timestamp": "…", "level": "info", "category": "phoenix", "message": "GET /s/k3J"}
],
"sdk": {"name": "collector", "version": "0.5.4"}
}

Los campos​

CampoTipoObligatorioNotas
venterosíSiempre 1.
uuidtexto (UUID)síLo crea el cliente al capturar el evento; se reusa al reenviar.
timestamptexto (ISO 8601)noCuándo pasó, según el reloj del cliente. Se muestra, nunca se usa para contar. Por defecto, la hora de llegada.
platformtextonoelixir, javascript, ruby, … Un problema guarda la plataforma del evento que lo abrió, y la lista filtra por ella.
leveltextonofatal, error (por defecto), warning o info.
environmenttextonoprod, staging, … Los filtros y los conteos son por entorno.
releasetextonoVersión o sha de git.
servertextonoNombre del host; el mismo que mandan los lotes de registros, así el evento enlaza a los registros de su servidor.
exceptionobjetouno de los dostype (obligatorio, texto), message (texto), frames (lista).
messagetextouno de los dosPara eventos que no son excepciones.
fingerprintlista de textosnoReemplaza la agrupación. Ver Cómo se agrupan los eventos.
requestobjetonomethod, url, headers (objeto). cookie, authorization, set-cookie y proxy-authorization se descartan aunque lleguen; no los mandes.
userobjetonoid (texto). El identificador propio de tu aplicación, no datos personales.
tagsobjetonoPares cortos de textos.
breadcrumbslistanoLo que pasó antes: timestamp, level, category, message.
sdkobjetononame y version del cliente.
sessiontextonoLa sesión de medición de velocidad de la pestaña. Solo desde pestañas medidas.
request_idtextonoLa solicitud que se estaba atendiendo: el mismo valor que llevan sus registros, así el evento enlaza a ellos. Hasta 200 caracteres.

Los marcos​

Los marcos van del más interno al más externo: el que lanzó el error va primero. Cada uno tiene:

  • module y function (con aridad, como mount/3);
  • file y line;
  • in_app: true para el código de la aplicación, false para dependencias y la biblioteca estándar. Marcarlo bien importa más que cualquier otra cosa que haga un cliente, porque decide la agrupación;
  • opcionalmente column (entero, para código minificado donde todo está en la línea 1) y context (las líneas alrededor de line: pre, line, post).

Otras claves se ignoran.

Límites​

Se descartan los marcos más allá de los 250 más internos; los mensajes se cortan en 8 KB; todo texto tiene que ser UTF-8 válido; el cuerpo entero tiene que pesar menos de 1 MB descomprimido.