Esquema de eventos
Cada evento que envían los SDK, campo por campo, con tipos, límites y un ejemplo de cada uno, y las reglas que el motor les aplica.
En esta página
- Las reglas
- El lote
- Tipos de evento
- Del SDK del navegador
- De los SDK del servidor
- Campos de todo evento
- Campos de todo evento
- Campos de todo evento del navegador
- Campos de todo evento del servidor
- session_start
- identify
- page_view
- page_leave
- click
- rage_click
- dead_click
- vital
- request
- error
- custom
- form_invalid
- replay_chunk
- replay_gap
- page_snapshot
- server_request
- server_error
- Formas compartidas
- Person
- Account
- PersonRef
- AccountRef
- Span
- MaskPolicy
- Subidas de grabación y de captura de página
- ReplayChunk
- PageSnapshot
- Límites y constantes
Esta página es el contrato de eventos en una forma que se puede leer. Es para quien quiere saber exactamente qué sale de una app, y para quien escribe su propio cliente. Es igual para el motor de código abierto y para Sypnia Cloud: los SDK son MIT e idénticos para ambos.
Se genera desde spec/events.schema.json en el repositorio de la documentación, un JSON Schema (2020-12). Si esta página y el esquema no coinciden, el esquema tiene la razón. Los SDK arman estos eventos por ti; mira Navegador, Node y Next.js. Cómo se envía, se autentica y se responde un lote está en la referencia de la API.
Las reglas
| Regla | Qué dice |
|---|---|
| Versión | v es la versión de este contrato. Es 1. Dentro de la versión 1 solo se agregan campos y tipos de evento; nunca se renombran ni se quitan. Un evento sin v se lee como versión 1. |
| Campos desconocidos | Un campo que este esquema no lista se guarda tal como llegó, junto al evento. Nunca es motivo para rechazar un evento. Un SDK más nuevo nunca rompe un motor más viejo. |
| Tipos desconocidos | Un evento cuyo type no está en este esquema se guarda con los eventos crudos, y las partes del motor que no lo conocen lo ignoran. Nunca se rechaza. |
| Textos largos | Un texto más largo que su límite se corta en el límite. Nunca es motivo para rechazar un evento. Los SDK cortan con los mismos límites antes de enviar. |
| Valores incorrectos | Un campo listado con el tipo equivocado, o con un valor fuera de su lista de valores permitidos, se quita del evento (queda en null si el campo admite null). El evento se conserva. |
| Eventos descartados | Un evento se descarta solo cuando falta, o no sirve, un campo obligatorio para su tipo (por ejemplo sin type, un ts que no es un número positivo, un evento del navegador sin sid, una métrica vital fuera de su rango creíble). Los eventos descartados se cuentan en la respuesta de la ingesta, con el motivo. El resto del lote se guarda. |
| Campos que escribe el motor | prj, rcv y bid los escribe el motor cuando llega el evento. Lo que ponga quien envía se reemplaza. env es production cuando quien envía no lo pone. |
| Privacidad | Ningún evento lleva un valor escrito por la persona, el cuerpo de una petición o de una respuesta, una cookie, un encabezado, una cadena de consulta ni el hash de una URL. url es una ruta. El contenido de la grabación viaja aparte de los eventos, ya enmascarado en el navegador. |
El lote
El cuerpo de POST /v1/ingest/events. La llave de ingesta viaja fuera del cuerpo: en el encabezado Authorization: Bearer spk_…, o en el parámetro key de la URL cuando el navegador envía con navigator.sendBeacon, que no puede poner encabezados. El cuerpo puede ir comprimido con gzip.
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
batch_id | texto | 64 caracteres | Un id que quien envía elige para este lote, un UUID. Un reintento lo reutiliza: un lote que llega dos veces se guarda una. | |
sent_at | texto | Cuándo salió el lote, según el reloj de quien envía, en ISO 8601 y UTC. El motor lo compara con su propio reloj para notar un dispositivo con la hora mal. | ||
sdk | objeto | Qué SDK armó el lote. | ||
events | lista de evento | 200 elementos | sí | Los eventos, en el orden en que ocurrieron. Máximo 200. Una lista vacía se acepta y no guarda nada. |
| Campo | Tipo | Límite | Significado |
|---|---|---|---|
sdk.name | texto | 40 caracteres | El nombre del paquete, por ejemplo @sypnia/browser. |
sdk.version | texto | 20 caracteres | La versión del paquete, por ejemplo 1.0.0. |
{
"batch_id": "0b9f6c3e-2a41-4d7e-9c1b-6f2e8a4d7c10",
"sent_at": "2026-03-12T10:31:48Z",
"sdk": {
"name": "@sypnia/browser",
"version": "1.0.0"
},
"events": [
{
"v": 1,
"type": "click",
"ts": 1773311503000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": null,
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"sel": "#pay-button",
"tag": "button",
"txt": "Pay $64.00",
"crole": "button",
"ctx": "Your order",
"href": null,
"x": 912,
"y": 640,
"rx": 0.633,
"ry": 640,
"ex": 820,
"ey": 618,
"ew": 184,
"eh": 44
}
]
}Tipos de evento
Del SDK del navegador
| Tipo | Evento | Qué es |
|---|---|---|
session_start | Inicio de sesión de uso | Empezó una sesión en este navegador. |
identify | Identificación | La app dijo quién es la persona. Es el único evento que lleva un nombre o un correo. Los demás llevan solo los ids. |
page_view | Vista de página | Se mostró una página. |
page_leave | Salida de página | La persona salió de una página, o dejó de mirarla. |
click | Clic | La persona hizo clic en algo. |
rage_click | Clic de rabia | La persona hizo clic en el mismo punto una y otra vez. |
dead_click | Clic muerto | La persona hizo clic en algo que debía responder, y no pasó nada. |
vital | Métrica vital (medición de rendimiento) | Una Web Vital de una página, con el elemento que la causa. |
request | Petición | La página llamó a una API. Nunca el cuerpo de la petición ni de la respuesta. |
error | Error | Un error en la página. |
custom | Evento propio | Algo que la app decidió reportar. |
form_invalid | Fallo de validación de formulario | El navegador bloqueó un formulario. Nunca lo que se escribió. |
replay_chunk | Marca de trozo de grabación | Se subió un trozo de la grabación. Con esta marca la línea de tiempo de una sesión sabe que tiene grabación, y dónde. |
replay_gap | Marca de hueco en la grabación | La grabación tiene un hueco aquí. El reproductor lo muestra en vez de fingir que no pasó nada. |
page_snapshot | Marca de captura de página | Se tomó una captura de esta ruta. La captura viaja aparte, a POST /v1/ingest/snapshot. |
De los SDK del servidor
| Tipo | Evento | Qué es |
|---|---|---|
server_request | Petición al servidor | Una petición que recibió tu servidor, con las llamadas que hizo. Es la raíz de la parte del servidor en una traza. |
server_error | Error del servidor | Un fallo en el servidor. |
Campos de todo evento
Campos de todo evento
Los lleva todo evento, del navegador y del servidor.
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
v | entero | siempre 1 | Versión de este contrato. Siempre 1. Se lee como 1 si falta. | |
type | texto | 40 caracteres | sí | Qué evento es. Mira la lista de tipos. |
ts | número | > 0 | sí | Cuándo ocurrió: milisegundos desde 1970-01-01 UTC, según el reloj de quien envía. |
env | texto | 40 caracteres | El entorno, como la app lo puso en init. production si falta. | |
ver | texto o null | 40 caracteres | La versión (release): la versión de la app que envió el evento, como se puso en init. Usa el commit corto de git. Null o ausente cuando la app no reporta ninguna. | |
person | PersonRef o null | A quién pertenece el evento: el id que se dio a identify(). Null o ausente en un evento anónimo. Solo los eventos identify llevan el nombre y el correo. | ||
account | AccountRef o null | La cuenta a la que pertenece la persona en la app monitoreada (un equipo, una empresa, un club): el id que se dio a identify(). Null o ausente cuando la app no envía ninguna. | ||
prj | texto | El id del proyecto (prj_…). Lo escribe el motor a partir de la llave de ingesta. Un valor enviado por la app se reemplaza. | ||
rcv | número | Cuándo recibió el motor el evento: milisegundos desde 1970-01-01 UTC, según el reloj del motor. Un valor enviado por la app se reemplaza. | ||
bid | texto | 64 caracteres | El id del lote en el que llegó el evento: el batch_id del lote, o un hash del cuerpo del lote cuando quien envía no dio ninguno. Lo escribe el motor en cada evento guardado. Así un lote que llega dos veces se cuenta una. Un valor enviado por la app se reemplaza. |
Campos de todo evento del navegador
Los lleva todo evento que envía el SDK del navegador, además de los campos de todo evento.
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
sid | texto | exactamente 32 caracteres hex | sí | Id de sesión: 32 caracteres hex aleatorios en minúscula, creados por el SDK del navegador y compartidos por todas las pestañas del mismo navegador (localStorage, clave sypnia:session). Uno nuevo tras 30 minutos sin actividad, o cuando se identifica a otra persona. |
did | texto | exactamente 32 caracteres hex | Id de dispositivo: 32 caracteres hex aleatorios que el SDK guarda en el almacenamiento del navegador (localStorage, clave sypnia:device). Distingue dispositivos entre sesiones. No identifica a nadie. | |
url | texto | 500 caracteres | La ruta de la página. Nunca el origen, la consulta ni el hash. | |
route | texto | 500 caracteres | La ruta con los ids reemplazados por :id, para que /orders/8841 y /orders/8842 sean una sola ruta. Un segmento se vuelve :id cuando es todo dígitos, un UUID, un texto hex de 16 caracteres o más, un token de 20 caracteres o más que contiene un dígito, o contiene %. | |
dev | texto | mobile, tablet, desktop | Clase de dispositivo según el ancho de la ventana: mobile bajo 768 px, tablet bajo 1.024 px, si no desktop. | |
vw | número | Ancho de la ventana en píxeles CSS. | ||
vh | número | Alto de la ventana en píxeles CSS. | ||
lang | texto o null | 16 caracteres | El idioma de la página: el atributo lang de <html>, si no el idioma del navegador. |
Campos de todo evento del servidor
Los lleva todo evento que envían los SDK del servidor, además de los campos de todo evento. Un evento del servidor no tiene dispositivo, ventana ni página.
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
service | texto | 80 caracteres | El nombre del servicio que envió el evento, como se puso en init, por ejemplo shop-api. | |
tid | texto o null | exactamente 32 caracteres hex | La traza a la que pertenece el evento. Sale del encabezado traceparent que llegó, o la crea el SDK. | |
sid | texto o null | exactamente 32 caracteres hex | La sesión del navegador que hizo la petición, del encabezado x-sypnia-session. Null cuando la petición no vino de una sesión de navegador. | |
method | texto | 10 caracteres | Método HTTP de la petición que llegó, en mayúsculas. | |
path | texto | 500 caracteres | Ruta de la petición que llegó. Nunca la consulta. | |
route | texto | 500 caracteres | La ruta con los ids reemplazados por :id, para que /orders/8841 y /orders/8842 sean una sola ruta. Un segmento se vuelve :id cuando es todo dígitos, un UUID, un texto hex de 16 caracteres o más, un token de 20 caracteres o más que contiene un dígito, o contiene %. |
session_start
Inicio de sesión de uso. Empezó una sesión en este navegador.
Se envía: Una vez por cada id de sesión que usa una página: en el primer evento de una sesión nueva, tras 30 minutos sin actividad, cuando otra pestaña empezó una sesión nueva, o cuando se identifica a otra persona. Se encola antes del evento que lo causó.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
ua | texto | 500 caracteres | El user agent del navegador. El motor lee de ahí el navegador y el sistema operativo. | |
ref | texto o null | 500 caracteres | De dónde vino la persona: origen y ruta de la página anterior (referrer). Nunca su consulta ni su hash. Null cuando no hay. | |
sw | número | Ancho de la pantalla en píxeles CSS. | ||
sh | número | Alto de la pantalla en píxeles CSS. | ||
tz | texto | 64 caracteres | La zona horaria del navegador, como nombre IANA. |
Ejemplo
{
"v": 1,
"type": "session_start",
"ts": 1773311476000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": null,
"account": null,
"url": "/cart",
"route": "/cart",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36",
"ref": "https://www.google.com/",
"sw": 1728,
"sh": 1117,
"tz": "Europe/Madrid"
}identify
Identificación. La app dijo quién es la persona. Es el único evento que lleva un nombre o un correo. Los demás llevan solo los ids.
Se envía: Cuando la app llama a identify() con una persona, y una vez más al empezar cada sesión posterior de esa persona. No se envía si la misma persona y cuenta ya se enviaron en esta sesión con el mismo nombre y correo.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
person | Person | sí | Una persona como la app la describió en identify(). El nombre y el correo son datos personales: se guardan solo cuando la app los envía. | |
account | Account o null | La cuenta a la que pertenece la persona, con su nombre si la app lo envió. |
Ejemplo
{
"v": 1,
"type": "identify",
"ts": 1773311481000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"url": "/cart",
"route": "/cart",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"person": {
"id": "u_1042",
"name": "Ada Park",
"email": "ada@example.com"
},
"account": {
"id": "acc_77",
"name": "Corner Café"
}
}page_view
Vista de página. Se mostró una página.
Se envía: Cuando carga una página y cada vez que la app navega a otra ruta. Un cambio solo de consulta o de hash no es una vista de página.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
nav | texto | load, push, replace, traverse | Cómo llegó la persona: load una carga completa, push una navegación dentro de la app, replace una redirección dentro de la app, traverse atrás o adelante. | |
from | texto o null | 500 caracteres | La ruta de la página anterior. Null en una carga completa. |
Ejemplo
{
"v": 1,
"type": "page_view",
"ts": 1773311488000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"nav": "push",
"from": "/cart"
}page_leave
Salida de página. La persona salió de una página, o dejó de mirarla.
Se envía: Cuando la app navega a otra página, la pestaña se oculta o la página se cierra. Una página que se oculta y se vuelve a mostrar puede enviar varios.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
dur | número | Milisegundos en la página desde que se mostró, o desde que la pestaña volvió a verse. | ||
scroll | número | 0–100 | Hasta dónde bajó la persona, como porcentaje del alto de la página. 100 cuando la página entera cabe en la pantalla. |
Ejemplo
{
"v": 1,
"type": "page_leave",
"ts": 1773311518000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"dur": 30000,
"scroll": 100
}click
Clic. La persona hizo clic en algo.
Se envía: En cada clic en la página. Un clic que un <label> pasa a su campo cuenta una vez.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
sel | texto | 200 caracteres | Un selector CSS del control en que se hizo clic: máximo 5 niveles, y se detiene en un data-testid o un id estable. Nunca contiene texto. | |
tag | texto | 20 caracteres | El nombre de la etiqueta del control, en minúsculas. | |
txt | texto o null | 80 caracteres | El nombre legible del control: su nombre accesible, su etiqueta o su texto visible. En un campo, la etiqueta o el placeholder, nunca el valor. Null cuando no hay, cuando el elemento está enmascarado o cuando maskAllText está activo. | |
crole | texto | button, link, tab, menuitem, option, checkbox, radio, switch, select, input, textarea, row, cell, heading, image, icon, text, other | Qué clase de cosa recibió el clic, como la nombraría una persona. Ausente cuando no se sabe. | |
ctx | texto o null | 80 caracteres | Dónde está el control: el título del diálogo o menú abierto, si no el encabezado más cercano antes de él. Null cuando no hay o cuando el texto está enmascarado. | |
href | texto o null | 500 caracteres | En un enlace, la ruta a la que apunta. Null en otros controles y en enlaces mailto:, tel: y los que no son http. | |
x | número | Posición del clic desde la izquierda de la página, en píxeles. | ||
y | número | Posición del clic desde arriba de la página, en píxeles. | ||
rx | número | 0–1 | Posición del clic desde la izquierda, como fracción del ancho de la ventana. La usan los mapas de clics. | |
ry | número | Posición del clic desde arriba de la página, en píxeles. La usan los mapas de clics. | ||
ex | número | Borde izquierdo del control, en píxeles de página. | ||
ey | número | Borde superior del control, en píxeles de página. | ||
ew | número | Ancho del control, en píxeles. | ||
eh | número | Alto del control, en píxeles. |
Ejemplo
{
"v": 1,
"type": "click",
"ts": 1773311503000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"sel": "#pay-button",
"tag": "button",
"txt": "Pay $64.00",
"crole": "button",
"ctx": "Your order",
"href": null,
"x": 912,
"y": 640,
"rx": 0.633,
"ry": 640,
"ex": 820,
"ey": 618,
"ew": 184,
"eh": 44
}rage_click
Clic de rabia. La persona hizo clic en el mismo punto una y otra vez.
Se envía: Se detecta en el navegador: 3 clics o más a menos de 30 px del primero, cada uno a lo sumo 1.000 ms después del anterior. Se envía una vez, cuando la ráfaga termina. No aplica a campos de texto, ni cuando los clics seleccionaron texto. También inicia la subida de la grabación de la sesión.
Sus campos propios, además de los comunes:
Todos los campos de click, más:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
n | entero | mín. 3 | sí | Cuántos clics tuvo la ráfaga. Los demás campos describen el último clic. |
Ejemplo
{
"v": 1,
"type": "rage_click",
"ts": 1773311506000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"sel": "#pay-button",
"tag": "button",
"txt": "Pay $64.00",
"crole": "button",
"ctx": "Your order",
"href": null,
"x": 915,
"y": 642,
"rx": 0.635,
"ry": 642,
"ex": 820,
"ey": 618,
"ew": 184,
"eh": 44,
"n": 5
}dead_click
Clic muerto. La persona hizo clic en algo que debía responder, y no pasó nada.
Se envía: Se detecta en el navegador: un clic en algo que parece clicable, tras el cual no pasó nada durante 1.000 ms: ningún cambio en la página, ninguna petición, ninguna navegación, ningún desplazamiento, ningún diálogo, descarga ni pestaña nueva. El mismo control otra vez dentro de 2.000 ms cuenta una vez. También inicia la subida de la grabación de la sesión.
Sus campos propios, además de los comunes:
Todos los campos de click, más:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
n | entero | siempre 1000 | sí | Cuánto esperó el SDK una respuesta antes de llamar muerto al clic, en milisegundos. Siempre 1.000. |
Ejemplo
{
"v": 1,
"type": "dead_click",
"ts": 1773311503000,
"sid": "5b1d9e3f7a2c4e6081b3d5f7a9c1e3b5",
"did": "9c4e2a6f8b0d1e3f5a7c9b1d3e5f7a90",
"env": "production",
"ver": "4f2a91c",
"person": null,
"account": null,
"url": "/checkout",
"route": "/checkout",
"dev": "mobile",
"vw": 390,
"vh": 844,
"lang": "en",
"sel": "#pay-button",
"tag": "button",
"txt": "Pay $64.00",
"crole": "button",
"ctx": "Your order",
"href": null,
"x": 195,
"y": 1210,
"rx": 0.5,
"ry": 1210,
"ex": 16,
"ey": 1188,
"ew": 358,
"eh": 48,
"n": 1000
}vital
Métrica vital (medición de rendimiento). Una Web Vital de una página, con el elemento que la causa.
Se envía: LCP, FCP y TTFB una vez, para la página que se cargó. INP y CLS una vez por página, cuando la persona sale de ella. Un valor que no es un número finito, es negativo o supera el máximo creíble (LCP, FCP, TTFB 120.000 ms; INP 60.000 ms; CLS 10) no se envía.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
name | texto | LCP, INP, CLS, TTFB, FCP | sí | Cuál métrica. FCP se guarda con los eventos crudos; las vistas de Rendimiento muestran LCP, INP, CLS y TTFB. |
value | número | sí | El valor: milisegundos, redondeados, para LCP, INP, TTFB y FCP. Un puntaje sin unidad, con 4 decimales, para CLS. | |
rating | texto | good, needs-improvement, poor | La calificación según los umbrales de Web Vitals: LCP 2.500 y 4.000 ms; INP 200 y 500 ms; CLS 0,1 y 0,25; TTFB 800 y 1.800 ms; FCP 1.800 y 3.000 ms. | |
sel | texto | 200 caracteres | El elemento detrás del valor, como selector CSS: el elemento más grande que se pintó (LCP), el elemento con el que la persona interactuó (INP), el elemento que más se movió (CLS). Nunca texto. Ausente en TTFB y FCP. | |
kind | texto | image, text, pointer, keyboard | En LCP, si el elemento es image o text. En INP, si la interacción fue pointer o keyboard. Ausente en los demás. |
Ejemplo
{
"v": 1,
"type": "vital",
"ts": 1773311489240,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"name": "LCP",
"value": 1240,
"rating": "good",
"sel": "#order-summary",
"kind": "text"
}request
Petición. La página llamó a una API. Nunca el cuerpo de la petición ni de la respuesta.
Se envía: Cuando una llamada fetch o XMLHttpRequest de la página a tu propio origen, o a una dirección listada en traceTargets o recordTargets, recibe respuesta o falla. No cuando la pestaña estaba oculta o la sesión inactiva al empezar la llamada, ni en una llamada que tu código abortó. Una llamada sin respuesta se registra 1.500 ms después con estado 0, salvo que la página se estuviera cerrando.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
method | texto | 10 caracteres | sí | Método HTTP, en mayúsculas. |
host | texto o null | 255 caracteres | El host al que se llamó, cuando no es el de la página. Null o ausente en llamadas al origen de la página. | |
path | texto | 500 caracteres | sí | La ruta que se llamó, con los ids reemplazados por :id. Nunca la consulta. |
status | entero | 0–599 | sí | Estado HTTP de la respuesta. 0 cuando no hubo respuesta. |
dur | número | Milisegundos desde la llamada hasta la respuesta. ts es cuando empezó la llamada. | ||
tid | texto | exactamente 32 caracteres hex | Id de traza: 32 caracteres hex en minúscula, un id de traza W3C. Nunca todo ceros. | |
code | texto | 40 caracteres | Solo con estado 400 o más: el código de error de una respuesta JSON (code, error_code, o error cuando parece un código). | |
msg | texto | 160 caracteres | Solo con estado 400 o más: el comienzo del mensaje de error de una respuesta JSON (error, si no message), con los espacios unificados y los correos reemplazados por [email]. |
Ejemplo
{
"v": 1,
"type": "request",
"ts": 1773311503100,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"method": "POST",
"host": null,
"path": "/api/checkout",
"status": 400,
"dur": 412,
"tid": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"code": "amount_required",
"msg": "The payment has no amount."
}error
Error. Un error en la página.
Se envía: Cuando un error llega a la ventana sin que nadie lo capture, una promesa se rechaza sin manejador, o la app llama a reportError(). No se envían: errores de extensiones del navegador y de scripts de otros orígenes, Script error. sin detalle, el aviso ResizeObserver loop, la misma huella otra vez dentro de 5.000 ms, y más de 20 errores en 60 segundos. También inicia la subida de la grabación de la sesión.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
name | texto | 100 caracteres | sí | El nombre del error, por ejemplo TypeError. UnhandledRejection cuando una promesa se rechazó con algo que no es un Error. |
msg | texto | 500 caracteres | sí | El mensaje del error, con los correos reemplazados por [email]. |
stack | texto o null | 4000 caracteres | La pila tal como la escribió el navegador, sin analizar, con los correos reemplazados por [email]. Null cuando el navegador no dio ninguna. El motor la traduce con los source maps de la versión. | |
digest | texto o null | 100 caracteres | Un id que el framework le dio al error, cuando existe (Next.js da un digest a los errores lanzados en el servidor). Null si no. | |
src | texto | window, promise, boundary, manual | Cómo se enteró el SDK: window un error sin capturar, promise un rechazo sin manejar, boundary un límite de errores del framework, manual una llamada a reportError(). | |
fp | texto | exactamente 16 caracteres hex | La huella: 16 caracteres hex que el SDK calcula con el nombre, el mensaje sin sus partes variables y el primer marco del código propio de la app. Los errores con la misma huella son un solo problema. |
Ejemplo
{
"v": 1,
"type": "error",
"ts": 1773311507000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"name": "ApiError",
"msg": "POST /api/checkout failed with 400 (amount_required)",
"stack": "ApiError: POST /api/checkout failed with 400 (amount_required)\n at o (https://shop.example/assets/checkout-3f9c.js:1:48211)\n at async HTMLButtonElement.<anonymous> (https://shop.example/assets/checkout-3f9c.js:1:49002)",
"digest": null,
"src": "promise",
"fp": "1522805793228d19"
}custom
Evento propio. Algo que la app decidió reportar.
Se envía: Cuando la app llama a track(name, props).
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
name | texto | 80 caracteres | sí | El nombre del evento, elegido por la app. |
props | objeto | 20 claves | Hasta 20 propiedades. Un nombre tiene máximo 40 caracteres. Un valor es un texto de máximo 200 caracteres, un número finito, un booleano o null. Todo lo demás (objetos, listas) se quita. |
Ejemplo
{
"v": 1,
"type": "custom",
"ts": 1773311495000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"name": "coupon_applied",
"props": {
"code": "SPRING10",
"discount_cents": 640,
"first_order": false
}
}form_invalid
Fallo de validación de formulario. El navegador bloqueó un formulario. Nunca lo que se escribió.
Se envía: Cuando el navegador se niega a enviar un formulario porque un campo no es válido (el evento nativo invalid). Máximo uno cada 1.000 ms.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
field | texto o null | 80 caracteres | El nombre legible del campo: su etiqueta o placeholder. Nunca su valor. Null cuando el texto está enmascarado. | |
ctx | texto o null | 80 caracteres | Dónde está el campo: el título del diálogo o el encabezado más cercano. Null cuando el texto está enmascarado. | |
reason | texto o null | valueMissing, typeMismatch, patternMismatch, tooShort, tooLong, rangeUnderflow, rangeOverflow, stepMismatch, badInput, customError | Por qué el navegador rechazó el campo: la primera clave verdadera de su ValidityState. | |
sel | texto | 200 caracteres | Un selector CSS del campo. |
Ejemplo
{
"v": 1,
"type": "form_invalid",
"ts": 1773311499000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"field": "Postal code",
"ctx": "Shipping address",
"reason": "patternMismatch",
"sel": "#postal-code"
}replay_chunk
Marca de trozo de grabación. Se subió un trozo de la grabación. Con esta marca la línea de tiempo de una sesión sabe que tiene grabación, y dónde.
Se envía: Después de que el motor aceptó un trozo de la grabación de la sesión. La grabación en sí viaja aparte, a POST /v1/ingest/replay.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
seq | entero | 0–719 | sí | El número del trozo en la sesión, desde 0. |
bytes | entero | El tamaño del trozo antes de comprimir, en caracteres de JSON. | ||
mask | entero | 1–9 | Qué reglas de enmascarado aplicó el SDK antes de enviar: 1 las de siempre (todo lo escrito se enmascara, el texto de la página como se ve, los elementos marcados se enmascaran o se dejan fuera), 2 maskAllText (además, todo el texto de la página). | |
full | booleano | True cuando el trozo trae una copia completa de la página, de modo que el reproductor puede empezar desde él. |
Ejemplo
{
"v": 1,
"type": "replay_chunk",
"ts": 1773311507400,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"seq": 0,
"bytes": 148220,
"mask": 1,
"full": true
}replay_gap
Marca de hueco en la grabación. La grabación tiene un hueco aquí. El reproductor lo muestra en vez de fingir que no pasó nada.
Se envía: Cuando un trozo de la grabación se pierde sin remedio.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
seq | entero | 0–719 | sí | El número del trozo que falta. |
reason | texto | rejected, failed, overflow, limit | sí | Por qué: rejected el motor rechazó el trozo, failed fallaron todos los reintentos, overflow había demasiado esperando en memoria y se soltó el trozo más viejo, limit el proyecto llegó a su límite de grabaciones y el motor le dijo al SDK que dejara de grabar. |
mask | entero | 1–9 | Qué reglas de enmascarado aplicó el SDK antes de enviar: 1 las de siempre (todo lo escrito se enmascara, el texto de la página como se ve, los elementos marcados se enmascaran o se dejan fuera), 2 maskAllText (además, todo el texto de la página). |
Ejemplo
{
"v": 1,
"type": "replay_gap",
"ts": 1773311530000,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"seq": 3,
"reason": "failed",
"mask": 1
}page_snapshot
Marca de captura de página. Se tomó una captura de esta ruta. La captura viaja aparte, a POST /v1/ingest/snapshot.
Se envía: Cuando una captura de página (la imagen que va detrás de un mapa de clics) se subió, o no se pudo subir.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
bytes | entero | El tamaño de la captura antes de comprimir, en caracteres de JSON. | ||
mask | entero | 1–9 | Qué reglas de enmascarado aplicó el SDK antes de enviar: 1 las de siempre (todo lo escrito se enmascara, el texto de la página como se ve, los elementos marcados se enmascaran o se dejan fuera), 2 maskAllText (además, todo el texto de la página). | |
skipped | texto | too_big, upload_failed, limit | Presente cuando la captura no se guardó: too_big más de 3.000.000 de caracteres, upload_failed la subida falló (no se reintenta), limit el proyecto llegó a un límite. |
Ejemplo
{
"v": 1,
"type": "page_snapshot",
"ts": 1773311490600,
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"did": "3e7a1c9d5b2f4a8e6c0d9b7f1a3e5c2d",
"env": "production",
"ver": "4f2a91c",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"url": "/checkout",
"route": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"lang": "en",
"bytes": 412880,
"mask": 1
}server_request
Petición al servidor. Una petición que recibió tu servidor, con las llamadas que hizo. Es la raíz de la parte del servidor en una traza.
Se envía: Una vez por cada petición que atendió el servidor, cuando la respuesta ya se envió. Una petición que sigue corriendo tras 20.000 ms se envía en ese momento como registro parcial; el registro completo lo reemplaza si la petición termina.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
tid | texto | exactamente 32 caracteres hex | sí | Id de traza: 32 caracteres hex en minúscula, un id de traza W3C. Nunca todo ceros. |
span | texto | exactamente 16 caracteres hex | Id de span: 16 caracteres hex en minúscula, un id de span W3C. | |
parent | texto o null | exactamente 16 caracteres hex | El id de span del encabezado traceparent que llegó: la llamada del navegador, o el span del servicio que llamó. Null cuando la traza empieza aquí. | |
status | entero o null | 100–599 | El estado HTTP que se envió. Null cuando no se sabe, como en un registro parcial. | |
dur | número | Milisegundos desde que llegó la petición hasta el final de la respuesta. | ||
spans | lista de Span | 200 elementos | Las llamadas que hizo la petición, en el orden en que empezaron. Se conservan máximo 200. | |
span_n | entero | Cuántos spans tuvo la petición, contando los que pasan de 200. | ||
span_err | entero | Cuántos de ellos fallaron. | ||
db_n | entero | Cuántas llamadas a la base de datos (kind db) hizo la petición. | ||
db_ms | número | Milisegundos en llamadas a la base de datos, sumados. | ||
err | texto o null | 500 caracteres | El mensaje del error que hizo fallar la petición, cuando lanzó uno. Null si no. | |
fp | texto o null | exactamente 16 caracteres hex | La huella de ese error, o del tiempo agotado en un registro parcial. Null si no. | |
cold | booleano | True en la primera petición de un proceso nuevo (un arranque en frío en serverless). | ||
partial | booleano | True solo en el registro escrito mientras la petición seguía corriendo. | ||
msg | texto | 500 caracteres | Solo en registros parciales: cuánto llevaba corriendo la petición y las tres llamadas más largas que seguían en curso. |
Ejemplo
{
"v": 1,
"type": "server_request",
"ts": 1773311503130,
"service": "shop-api",
"env": "production",
"ver": "4f2a91c",
"tid": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"span": "a1b2c3d4e5f60718",
"parent": "0f1e2d3c4b5a6978",
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"method": "POST",
"path": "/api/checkout",
"route": "/api/checkout",
"status": 400,
"dur": 398.2,
"spans": [
{
"id": "1a2b3c4d5e6f7081",
"parent": null,
"name": "SELECT carts",
"kind": "db",
"start": 6.1,
"dur": 18,
"status": "ok",
"code": null,
"attrs": {
"db.system.name": "postgresql",
"db.collection.name": "carts",
"db.operation.name": "SELECT"
}
},
{
"id": "2b3c4d5e6f708192",
"parent": null,
"name": "SELECT cart_items",
"kind": "db",
"start": 25.3,
"dur": 22.1,
"status": "ok",
"code": null,
"attrs": {
"db.system.name": "postgresql",
"db.collection.name": "cart_items",
"db.operation.name": "SELECT"
}
},
{
"id": "3c4d5e6f708192a3",
"parent": null,
"name": "POST /v1/payments",
"kind": "http",
"start": 49,
"dur": 340.2,
"status": "error",
"code": "400",
"attrs": {
"http.request.method": "POST",
"server.address": "payments.internal",
"url.path": "/v1/payments",
"http.response.status_code": 400
}
}
],
"span_n": 3,
"span_err": 1,
"db_n": 2,
"db_ms": 40.1,
"err": null,
"fp": null,
"cold": false,
"partial": false
}server_error
Error del servidor. Un fallo en el servidor.
Se envía: Cuando se lanza un error que nadie captura al atender una petición, cuando falla una llamada que hizo la petición, cuando una petición responde 500 o más sin otro fallo, cuando el código escribe en console.error durante una petición, o cuando la app llama a reportError(). Máximo 5 por petición, 3 de ellos de console.error, uno por huella.
Sus campos propios, además de los comunes:
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
name | texto | 100 caracteres | sí | El nombre del error. En una llamada fallida, la clase y su código, por ejemplo HTTP 400 o DB 23505. En una respuesta 5xx sin otro fallo, HTTP 500. |
msg | texto | 500 caracteres | sí | El mensaje. En una llamada fallida se depura antes de salir del servidor: correos, URL, UUID, valores entre comillas, tokens largos y toda serie de dígitos se reemplazan, y lo siguen la llamada y la ruta, por ejemplo duplicate key value violates unique constraint (INSERT orders) in POST /api/checkout. |
stack | texto o null | 4000 caracteres | La pila, cuando hay un Error detrás. Null si no. | |
digest | texto o null | 100 caracteres | Un id que el framework le dio al error, cuando existe. El error del navegador para el mismo fallo lleva el mismo digest. | |
src | texto | uncaught, span, status, log, manual | Cómo se enteró el SDK: uncaught un error que nadie capturó, span una llamada que falló, status una respuesta 500 o más sin otro fallo, log un console.error durante una petición, manual una llamada a reportError(). | |
span | texto o null | exactamente 16 caracteres hex | Con src span, el id del span que falló. | |
fp | texto | exactamente 16 caracteres hex | La huella: 16 caracteres hex. Los fallos con la misma huella son un solo problema. |
Ejemplo
{
"v": 1,
"type": "server_error",
"ts": 1773311503519,
"service": "shop-api",
"env": "production",
"ver": "4f2a91c",
"tid": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"person": {
"id": "u_1042"
},
"account": {
"id": "acc_77"
},
"method": "POST",
"path": "/api/checkout",
"route": "/api/checkout",
"name": "HTTP 400",
"msg": "amount is required (POST /v1/payments) in POST /api/checkout",
"stack": null,
"digest": null,
"src": "span",
"span": "3c4d5e6f708192a3",
"fp": "88a44b15205cb153"
}Formas compartidas
Person
Una persona como la app la describió en identify(). El nombre y el correo son datos personales: se guardan solo cuando la app los envía.
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
id | texto | 128 caracteres | sí | El id de la persona en la app monitoreada. Un texto opaco. |
name | texto o null | 120 caracteres | El nombre de la persona. Opcional. Dato personal. | |
email | texto o null | 254 caracteres | El correo de la persona. Opcional. Dato personal. |
Account
La cuenta a la que pertenece una persona en la app monitoreada, como la app la describió en identify().
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
id | texto | 128 caracteres | sí | El id de la cuenta en la app monitoreada. Un texto opaco. |
name | texto o null | 120 caracteres | El nombre de la cuenta. Opcional. |
PersonRef
Persona (referencia)
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
id | texto | 128 caracteres | sí | El id de la persona en la app monitoreada. Un texto opaco: Sypnia nunca lo interpreta. |
AccountRef
Cuenta (referencia)
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
id | texto | 128 caracteres | sí | El id de la cuenta en la app monitoreada. Un texto opaco. |
Span
Un paso dentro de una petición al servidor: una llamada a la base de datos, una llamada a otro servicio o un paso interno. La forma es compatible con OpenTelemetry.
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
id | texto | exactamente 16 caracteres hex | sí | Id de span: 16 caracteres hex en minúscula, un id de span W3C. |
parent | texto o null | exactamente 16 caracteres hex | El span que causó este. Null cuando lo causó la petición misma. | |
name | texto | 120 caracteres | sí | Qué es el paso: SELECT carts, POST /v1/payments. Nunca una sentencia SQL completa, nunca una cadena de consulta. |
kind | texto | db, http, internal | sí | db una llamada a la base de datos, http una llamada a otro servicio, internal cualquier otra cosa. |
start | número | sí | Milisegundos desde el inicio de la petición (ts) hasta el inicio del span, con precisión de 0,1 ms. | |
dur | número | sí | Cuánto tardó el span, en milisegundos, con precisión de 0,1 ms. En un span que sigue corriendo dentro de un registro parcial, cuánto llevaba. | |
status | texto | ok, error | error cuando la llamada no tuvo respuesta, respondió 400, respondió 500 o más, o lanzó un error. Otras respuestas, como 401, 404 o 409, son ok. | |
code | texto o null | 40 caracteres | El estado HTTP o el código de error de la base de datos, como texto. 0 cuando no hubo respuesta. Null cuando no hay. | |
attrs | objeto | 64 claves | Hasta 64 detalles, con los nombres de OpenTelemetry (http.request.method, server.address, db.system.name…). Un valor es un texto de máximo 256 caracteres, un número o un booleano. Los atributos cuyo nombre contiene authorization, cookie, password, secret o token se quitan en la ingesta. | |
run | booleano | True cuando el span seguía corriendo al escribirse el registro. Solo en registros parciales. |
MaskPolicy
Qué reglas de enmascarado aplicó el SDK antes de enviar: 1 las de siempre (todo lo escrito se enmascara, el texto de la página como se ve, los elementos marcados se enmascaran o se dejan fuera), 2 maskAllText (además, todo el texto de la página).
Subidas de grabación y de captura de página
Estos dos cuerpos no son eventos. Viajan a sus propios endpoints y se cuentan como grabaciones.
ReplayChunk
El cuerpo de POST /v1/ingest/replay: un trozo de la grabación de una sesión. No es un evento. El motor guarda events tal como llega y nunca mira dentro: el enmascarado ocurre en el navegador.
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
sid | texto | exactamente 32 caracteres hex | sí | Id de sesión: 32 caracteres hex aleatorios en minúscula, creados por el SDK del navegador y compartidos por todas las pestañas del mismo navegador (localStorage, clave sypnia:session). Uno nuevo tras 30 minutos sin actividad, o cuando se identifica a otra persona. |
seq | entero | 0–719 | sí | El número del trozo en la sesión, desde 0. Enviar el mismo número otra vez reemplaza el trozo. |
ts_start | número | Hora del primer cambio grabado en el trozo, en milisegundos desde 1970-01-01 UTC. | ||
ts_end | número | Hora del último cambio grabado en el trozo. | ||
route | texto | 500 caracteres | La ruta con los ids reemplazados por :id, para que /orders/8841 y /orders/8842 sean una sola ruta. Un segmento se vuelve :id cuando es todo dígitos, un UUID, un texto hex de 16 caracteres o más, un token de 20 caracteres o más que contiene un dígito, o contiene %. | |
url | texto | 500 caracteres | La ruta de la página cuando se abrió el trozo. | |
vw | número | Ancho de la ventana cuando se abrió el trozo. | ||
vh | número | Alto de la ventana cuando se abrió el trozo. | ||
full | booleano | True cuando el trozo trae una copia completa de la página. | ||
mask | entero | 1–9 | Qué reglas de enmascarado aplicó el SDK antes de enviar: 1 las de siempre (todo lo escrito se enmascara, el texto de la página como se ve, los elementos marcados se enmascaran o se dejan fuera), 2 maskAllText (además, todo el texto de la página). | |
events | lista de objeto | sí | Los cambios grabados, en el formato propio de la grabadora (eventos de rrweb). Opacos para el motor. |
{
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"seq": 3,
"ts_start": 1773311497000,
"ts_end": 1773311507000,
"route": "/checkout",
"url": "/checkout",
"vw": 1440,
"vh": 900,
"full": false,
"mask": 1,
"events": [
{
"type": 3,
"timestamp": 1773311503000,
"data": {
"source": 2,
"type": 2,
"id": 418,
"x": 912,
"y": 640
}
}
]
}PageSnapshot
El cuerpo de POST /v1/ingest/snapshot: una página como se veía, con el mismo enmascarado que una grabación. Los mapas de clics se dibujan sobre ella. No es un evento.
| Campo | Tipo | Límite | Obligatorio | Significado |
|---|---|---|---|---|
sid | texto | exactamente 32 caracteres hex | sí | Id de sesión: 32 caracteres hex aleatorios en minúscula, creados por el SDK del navegador y compartidos por todas las pestañas del mismo navegador (localStorage, clave sypnia:session). Uno nuevo tras 30 minutos sin actividad, o cuando se identifica a otra persona. |
route | texto | 500 caracteres | sí | La ruta con los ids reemplazados por :id, para que /orders/8841 y /orders/8842 sean una sola ruta. Un segmento se vuelve :id cuando es todo dígitos, un UUID, un texto hex de 16 caracteres o más, un token de 20 caracteres o más que contiene un dígito, o contiene %. |
url | texto | 500 caracteres | La ruta de la página. | |
dev | texto | mobile, tablet, desktop | Clase de dispositivo del navegador que la tomó. | |
vw | número | Ancho de la ventana. | ||
vh | número | Alto de la ventana. | ||
ph | número | Alto completo de la página, en píxeles. | ||
ts | número | Cuándo se tomó, en milisegundos desde 1970-01-01 UTC. | ||
mask | entero | 1–9 | Qué reglas de enmascarado aplicó el SDK antes de enviar: 1 las de siempre (todo lo escrito se enmascara, el texto de la página como se ve, los elementos marcados se enmascaran o se dejan fuera), 2 maskAllText (además, todo el texto de la página). | |
snapshot | objeto | sí | El árbol de la página, en el formato propio de la grabadora (una captura de rrweb). Opaco para el motor. |
{
"sid": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"route": "/checkout",
"url": "/checkout",
"dev": "desktop",
"vw": 1440,
"vh": 900,
"ph": 1630,
"ts": 1773311490000,
"mask": 1,
"snapshot": {
"type": 0,
"childNodes": [],
"id": 1
}
}Límites y constantes
Los números que usan los SDK y el motor. Son parte del contrato: el código implementa estos valores.
| Área | Constante | Valor |
|---|---|---|
batch | events_per_batch | 200 |
batch | browser_batch_chars | 40,800 |
batch | body_bytes_after_decompression | 2,097,152 |
batch | flush_interval_ms | 10,000 |
batch | flush_at_events | 50 |
batch | queue_max_events | 500 |
batch | gzip_above_chars | 2048 |
batch | retry_delays_ms | 1000, 4000, 15,000 |
session | idle_ms | 1,800,000 |
session | id_length_hex | 32 |
errors | per_minute | 20 |
errors | dedupe_ms | 5000 |
clicks | rage_window_ms | 1000 |
clicks | rage_radius_px | 30 |
clicks | rage_min_clicks | 3 |
clicks | dead_wait_ms | 1000 |
clicks | dead_dedupe_ms | 2000 |
forms | invalid_dedupe_ms | 1000 |
requests | unanswered_grace_ms | 1500 |
vitals | max_ms | LCP 120,000, FCP 120,000, TTFB 120,000, INP 60,000 |
vitals | max_cls | 10 |
replay | chunk_interval_ms | 10,000 |
replay | chunk_chars | 200,000 |
replay | buffer_ms | 30,000 |
replay | max_chunks_per_session | 720 |
replay | upload_bytes_after_decompression | 4,000,000 |
replay | snapshots_per_session | 5 |
replay | snapshot_chars | 3,000,000 |
server | spans_per_request | 200 |
server | span_attributes | 64 |
server | span_attribute_chars | 256 |
server | failures_per_request | 5 |
server | log_failures_per_request | 3 |
server | slow_request_ms | 20,000 |