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
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
v | entero | sí | Siempre 1. |
uuid | texto (UUID) | sí | Lo crea el cliente al capturar el evento; se reusa al reenviar. |
timestamp | texto (ISO 8601) | no | Cuándo pasó, según el reloj del cliente. Se muestra, nunca se usa para contar. Por defecto, la hora de llegada. |
platform | texto | no | elixir, javascript, ruby, … Un problema guarda la plataforma del evento que lo abrió, y la lista filtra por ella. |
level | texto | no | fatal, error (por defecto), warning o info. |
environment | texto | no | prod, staging, … Los filtros y los conteos son por entorno. |
release | texto | no | Versión o sha de git. |
server | texto | no | Nombre del host; el mismo que mandan los lotes de registros, así el evento enlaza a los registros de su servidor. |
exception | objeto | uno de los dos | type (obligatorio, texto), message (texto), frames (lista). |
message | texto | uno de los dos | Para eventos que no son excepciones. |
fingerprint | lista de textos | no | Reemplaza la agrupación. Ver Cómo se agrupan los eventos. |
request | objeto | no | method, url, headers (objeto). cookie, authorization, set-cookie y proxy-authorization se descartan aunque lleguen; no los mandes. |
user | objeto | no | id (texto). El identificador propio de tu aplicación, no datos personales. |
tags | objeto | no | Pares cortos de textos. |
breadcrumbs | lista | no | Lo que pasó antes: timestamp, level, category, message. |
sdk | objeto | no | name y version del cliente. |
session | texto | no | La sesión de medición de velocidad de la pestaña. Solo desde pestañas medidas. |
request_id | texto | no | La 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:
moduleyfunction(con aridad, comomount/3);fileyline;in_app:truepara el código de la aplicación,falsepara 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) ycontext(las líneas alrededor deline: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.