Docs

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.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Las reglas
  2. El lote
  3. Tipos de evento
  4. Del SDK del navegador
  5. De los SDK del servidor
  6. Campos de todo evento
  7. Campos de todo evento
  8. Campos de todo evento del navegador
  9. Campos de todo evento del servidor
  10. session_start
  11. identify
  12. page_view
  13. page_leave
  14. click
  15. rage_click
  16. dead_click
  17. vital
  18. request
  19. error
  20. custom
  21. form_invalid
  22. replay_chunk
  23. replay_gap
  24. page_snapshot
  25. server_request
  26. server_error
  27. Formas compartidas
  28. Person
  29. Account
  30. PersonRef
  31. AccountRef
  32. Span
  33. MaskPolicy
  34. Subidas de grabación y de captura de página
  35. ReplayChunk
  36. PageSnapshot
  37. 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

ReglaQué dice
Versiónv 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 desconocidosUn 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 desconocidosUn 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 largosUn 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 incorrectosUn 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 descartadosUn 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 motorprj, 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.
PrivacidadNingú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.

CampoTipoLímiteObligatorioSignificado
batch_idtexto64 caracteresUn 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_attextoCuá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.
sdkobjetoQué SDK armó el lote.
eventslista de evento200 elementossíLos eventos, en el orden en que ocurrieron. Máximo 200. Una lista vacía se acepta y no guarda nada.
CampoTipoLímiteSignificado
sdk.nametexto40 caracteresEl nombre del paquete, por ejemplo @sypnia/browser.
sdk.versiontexto20 caracteresLa versión del paquete, por ejemplo 1.0.0.
JSON
{
  "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

TipoEventoQué es
session_startInicio de sesión de usoEmpezó una sesión en este navegador.
identifyIdentificaciónLa 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_viewVista de páginaSe mostró una página.
page_leaveSalida de páginaLa persona salió de una página, o dejó de mirarla.
clickClicLa persona hizo clic en algo.
rage_clickClic de rabiaLa persona hizo clic en el mismo punto una y otra vez.
dead_clickClic muertoLa persona hizo clic en algo que debía responder, y no pasó nada.
vitalMétrica vital (medición de rendimiento)Una Web Vital de una página, con el elemento que la causa.
requestPeticiónLa página llamó a una API. Nunca el cuerpo de la petición ni de la respuesta.
errorErrorUn error en la página.
customEvento propioAlgo que la app decidió reportar.
form_invalidFallo de validación de formularioEl navegador bloqueó un formulario. Nunca lo que se escribió.
replay_chunkMarca de trozo de grabaciónSe 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_gapMarca de hueco en la grabaciónLa grabación tiene un hueco aquí. El reproductor lo muestra en vez de fingir que no pasó nada.
page_snapshotMarca de captura de páginaSe tomó una captura de esta ruta. La captura viaja aparte, a POST /v1/ingest/snapshot.

De los SDK del servidor

TipoEventoQué es
server_requestPetición al servidorUna petición que recibió tu servidor, con las llamadas que hizo. Es la raíz de la parte del servidor en una traza.
server_errorError del servidorUn fallo en el servidor.

Campos de todo evento

Campos de todo evento

Los lleva todo evento, del navegador y del servidor.

CampoTipoLímiteObligatorioSignificado
venterosiempre 1Versión de este contrato. Siempre 1. Se lee como 1 si falta.
typetexto40 caracteressíQué evento es. Mira la lista de tipos.
tsnúmero> 0síCuándo ocurrió: milisegundos desde 1970-01-01 UTC, según el reloj de quien envía.
envtexto40 caracteresEl entorno, como la app lo puso en init. production si falta.
vertexto o null40 caracteresLa 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.
personPersonRef o nullA 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.
accountAccountRef o nullLa 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.
prjtextoEl id del proyecto (prj_…). Lo escribe el motor a partir de la llave de ingesta. Un valor enviado por la app se reemplaza.
rcvnúmeroCuá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.
bidtexto64 caracteresEl 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.

CampoTipoLímiteObligatorioSignificado
sidtextoexactamente 32 caracteres hexsí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.
didtextoexactamente 32 caracteres hexId 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.
urltexto500 caracteresLa ruta de la página. Nunca el origen, la consulta ni el hash.
routetexto500 caracteresLa 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 %.
devtextomobile, tablet, desktopClase de dispositivo según el ancho de la ventana: mobile bajo 768 px, tablet bajo 1.024 px, si no desktop.
vwnúmeroAncho de la ventana en píxeles CSS.
vhnúmeroAlto de la ventana en píxeles CSS.
langtexto o null16 caracteresEl 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.

CampoTipoLímiteObligatorioSignificado
servicetexto80 caracteresEl nombre del servicio que envió el evento, como se puso en init, por ejemplo shop-api.
tidtexto o nullexactamente 32 caracteres hexLa traza a la que pertenece el evento. Sale del encabezado traceparent que llegó, o la crea el SDK.
sidtexto o nullexactamente 32 caracteres hexLa 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.
methodtexto10 caracteresMétodo HTTP de la petición que llegó, en mayúsculas.
pathtexto500 caracteresRuta de la petición que llegó. Nunca la consulta.
routetexto500 caracteresLa 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:

CampoTipoLímiteObligatorioSignificado
uatexto500 caracteresEl user agent del navegador. El motor lee de ahí el navegador y el sistema operativo.
reftexto o null500 caracteresDe dónde vino la persona: origen y ruta de la página anterior (referrer). Nunca su consulta ni su hash. Null cuando no hay.
swnúmeroAncho de la pantalla en píxeles CSS.
shnúmeroAlto de la pantalla en píxeles CSS.
tztexto64 caracteresLa zona horaria del navegador, como nombre IANA.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
personPersonsí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.
accountAccount o nullLa cuenta a la que pertenece la persona, con su nombre si la app lo envió.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
navtextoload, push, replace, traverseCó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.
fromtexto o null500 caracteresLa ruta de la página anterior. Null en una carga completa.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
durnúmeroMilisegundos en la página desde que se mostró, o desde que la pestaña volvió a verse.
scrollnúmero0–100Hasta dónde bajó la persona, como porcentaje del alto de la página. 100 cuando la página entera cabe en la pantalla.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
seltexto200 caracteresUn 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.
tagtexto20 caracteresEl nombre de la etiqueta del control, en minúsculas.
txttexto o null80 caracteresEl 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.
croletextobutton, link, tab, menuitem, option, checkbox, radio, switch, select, input, textarea, row, cell, heading, image, icon, text, otherQué clase de cosa recibió el clic, como la nombraría una persona. Ausente cuando no se sabe.
ctxtexto o null80 caracteresDó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.
hreftexto o null500 caracteresEn un enlace, la ruta a la que apunta. Null en otros controles y en enlaces mailto:, tel: y los que no son http.
xnúmeroPosición del clic desde la izquierda de la página, en píxeles.
ynúmeroPosición del clic desde arriba de la página, en píxeles.
rxnúmero0–1Posición del clic desde la izquierda, como fracción del ancho de la ventana. La usan los mapas de clics.
rynúmeroPosición del clic desde arriba de la página, en píxeles. La usan los mapas de clics.
exnúmeroBorde izquierdo del control, en píxeles de página.
eynúmeroBorde superior del control, en píxeles de página.
ewnúmeroAncho del control, en píxeles.
ehnúmeroAlto del control, en píxeles.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
nenteromín. 3síCuántos clics tuvo la ráfaga. Los demás campos describen el último clic.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
nenterosiempre 1000síCuánto esperó el SDK una respuesta antes de llamar muerto al clic, en milisegundos. Siempre 1.000.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
nametextoLCP, INP, CLS, TTFB, FCPsíCuál métrica. FCP se guarda con los eventos crudos; las vistas de Rendimiento muestran LCP, INP, CLS y TTFB.
valuenúmerosíEl valor: milisegundos, redondeados, para LCP, INP, TTFB y FCP. Un puntaje sin unidad, con 4 decimales, para CLS.
ratingtextogood, needs-improvement, poorLa 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.
seltexto200 caracteresEl 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.
kindtextoimage, text, pointer, keyboardEn LCP, si el elemento es image o text. En INP, si la interacción fue pointer o keyboard. Ausente en los demás.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
methodtexto10 caracteressíMétodo HTTP, en mayúsculas.
hosttexto o null255 caracteresEl host al que se llamó, cuando no es el de la página. Null o ausente en llamadas al origen de la página.
pathtexto500 caracteressíLa ruta que se llamó, con los ids reemplazados por :id. Nunca la consulta.
statusentero0–599síEstado HTTP de la respuesta. 0 cuando no hubo respuesta.
durnúmeroMilisegundos desde la llamada hasta la respuesta. ts es cuando empezó la llamada.
tidtextoexactamente 32 caracteres hexId de traza: 32 caracteres hex en minúscula, un id de traza W3C. Nunca todo ceros.
codetexto40 caracteresSolo 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).
msgtexto160 caracteresSolo 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

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
nametexto100 caracteressíEl nombre del error, por ejemplo TypeError. UnhandledRejection cuando una promesa se rechazó con algo que no es un Error.
msgtexto500 caracteressíEl mensaje del error, con los correos reemplazados por [email].
stacktexto o null4000 caracteresLa 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.
digesttexto o null100 caracteresUn 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.
srctextowindow, promise, boundary, manualCó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().
fptextoexactamente 16 caracteres hexLa 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

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
nametexto80 caracteressíEl nombre del evento, elegido por la app.
propsobjeto20 clavesHasta 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

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
fieldtexto o null80 caracteresEl nombre legible del campo: su etiqueta o placeholder. Nunca su valor. Null cuando el texto está enmascarado.
ctxtexto o null80 caracteresDónde está el campo: el título del diálogo o el encabezado más cercano. Null cuando el texto está enmascarado.
reasontexto o nullvalueMissing, typeMismatch, patternMismatch, tooShort, tooLong, rangeUnderflow, rangeOverflow, stepMismatch, badInput, customErrorPor qué el navegador rechazó el campo: la primera clave verdadera de su ValidityState.
seltexto200 caracteresUn selector CSS del campo.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
seqentero0–719síEl número del trozo en la sesión, desde 0.
bytesenteroEl tamaño del trozo antes de comprimir, en caracteres de JSON.
maskentero1–9Qué 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).
fullbooleanoTrue cuando el trozo trae una copia completa de la página, de modo que el reproductor puede empezar desde él.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
seqentero0–719síEl número del trozo que falta.
reasontextorejected, failed, overflow, limitsí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.
maskentero1–9Qué 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

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
bytesenteroEl tamaño de la captura antes de comprimir, en caracteres de JSON.
maskentero1–9Qué 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).
skippedtextotoo_big, upload_failed, limitPresente 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

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
tidtextoexactamente 32 caracteres hexsíId de traza: 32 caracteres hex en minúscula, un id de traza W3C. Nunca todo ceros.
spantextoexactamente 16 caracteres hexId de span: 16 caracteres hex en minúscula, un id de span W3C.
parenttexto o nullexactamente 16 caracteres hexEl 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í.
statusentero o null100–599El estado HTTP que se envió. Null cuando no se sabe, como en un registro parcial.
durnúmeroMilisegundos desde que llegó la petición hasta el final de la respuesta.
spanslista de Span200 elementosLas llamadas que hizo la petición, en el orden en que empezaron. Se conservan máximo 200.
span_nenteroCuántos spans tuvo la petición, contando los que pasan de 200.
span_errenteroCuántos de ellos fallaron.
db_nenteroCuántas llamadas a la base de datos (kind db) hizo la petición.
db_msnúmeroMilisegundos en llamadas a la base de datos, sumados.
errtexto o null500 caracteresEl mensaje del error que hizo fallar la petición, cuando lanzó uno. Null si no.
fptexto o nullexactamente 16 caracteres hexLa huella de ese error, o del tiempo agotado en un registro parcial. Null si no.
coldbooleanoTrue en la primera petición de un proceso nuevo (un arranque en frío en serverless).
partialbooleanoTrue solo en el registro escrito mientras la petición seguía corriendo.
msgtexto500 caracteresSolo en registros parciales: cuánto llevaba corriendo la petición y las tres llamadas más largas que seguían en curso.

Ejemplo

JSON
{
  "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:

CampoTipoLímiteObligatorioSignificado
nametexto100 caracteressí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.
msgtexto500 caracteressí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.
stacktexto o null4000 caracteresLa pila, cuando hay un Error detrás. Null si no.
digesttexto o null100 caracteresUn id que el framework le dio al error, cuando existe. El error del navegador para el mismo fallo lleva el mismo digest.
srctextouncaught, span, status, log, manualCó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().
spantexto o nullexactamente 16 caracteres hexCon src span, el id del span que falló.
fptextoexactamente 16 caracteres hexLa huella: 16 caracteres hex. Los fallos con la misma huella son un solo problema.

Ejemplo

JSON
{
  "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.

CampoTipoLímiteObligatorioSignificado
idtexto128 caracteressíEl id de la persona en la app monitoreada. Un texto opaco.
nametexto o null120 caracteresEl nombre de la persona. Opcional. Dato personal.
emailtexto o null254 caracteresEl 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().

CampoTipoLímiteObligatorioSignificado
idtexto128 caracteressíEl id de la cuenta en la app monitoreada. Un texto opaco.
nametexto o null120 caracteresEl nombre de la cuenta. Opcional.

PersonRef

Persona (referencia)

CampoTipoLímiteObligatorioSignificado
idtexto128 caracteressíEl id de la persona en la app monitoreada. Un texto opaco: Sypnia nunca lo interpreta.

AccountRef

Cuenta (referencia)

CampoTipoLímiteObligatorioSignificado
idtexto128 caracteressí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.

CampoTipoLímiteObligatorioSignificado
idtextoexactamente 16 caracteres hexsíId de span: 16 caracteres hex en minúscula, un id de span W3C.
parenttexto o nullexactamente 16 caracteres hexEl span que causó este. Null cuando lo causó la petición misma.
nametexto120 caracteressíQué es el paso: SELECT carts, POST /v1/payments. Nunca una sentencia SQL completa, nunca una cadena de consulta.
kindtextodb, http, internalsídb una llamada a la base de datos, http una llamada a otro servicio, internal cualquier otra cosa.
startnúmerosíMilisegundos desde el inicio de la petición (ts) hasta el inicio del span, con precisión de 0,1 ms.
durnúmerosí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.
statustextook, errorerror 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.
codetexto o null40 caracteresEl estado HTTP o el código de error de la base de datos, como texto. 0 cuando no hubo respuesta. Null cuando no hay.
attrsobjeto64 clavesHasta 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.
runbooleanoTrue 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.

CampoTipoLímiteObligatorioSignificado
sidtextoexactamente 32 caracteres hexsí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.
seqentero0–719síEl número del trozo en la sesión, desde 0. Enviar el mismo número otra vez reemplaza el trozo.
ts_startnúmeroHora del primer cambio grabado en el trozo, en milisegundos desde 1970-01-01 UTC.
ts_endnúmeroHora del último cambio grabado en el trozo.
routetexto500 caracteresLa 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 %.
urltexto500 caracteresLa ruta de la página cuando se abrió el trozo.
vwnúmeroAncho de la ventana cuando se abrió el trozo.
vhnúmeroAlto de la ventana cuando se abrió el trozo.
fullbooleanoTrue cuando el trozo trae una copia completa de la página.
maskentero1–9Qué 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).
eventslista de objetosíLos cambios grabados, en el formato propio de la grabadora (eventos de rrweb). Opacos para el motor.
JSON
{
  "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.

CampoTipoLímiteObligatorioSignificado
sidtextoexactamente 32 caracteres hexsí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.
routetexto500 caracteressí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 %.
urltexto500 caracteresLa ruta de la página.
devtextomobile, tablet, desktopClase de dispositivo del navegador que la tomó.
vwnúmeroAncho de la ventana.
vhnúmeroAlto de la ventana.
phnúmeroAlto completo de la página, en píxeles.
tsnúmeroCuándo se tomó, en milisegundos desde 1970-01-01 UTC.
maskentero1–9Qué 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).
snapshotobjetosíEl árbol de la página, en el formato propio de la grabadora (una captura de rrweb). Opaco para el motor.
JSON
{
  "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.

ÁreaConstanteValor
batchevents_per_batch200
batchbrowser_batch_chars40,800
batchbody_bytes_after_decompression2,097,152
batchflush_interval_ms10,000
batchflush_at_events50
batchqueue_max_events500
batchgzip_above_chars2048
batchretry_delays_ms1000, 4000, 15,000
sessionidle_ms1,800,000
sessionid_length_hex32
errorsper_minute20
errorsdedupe_ms5000
clicksrage_window_ms1000
clicksrage_radius_px30
clicksrage_min_clicks3
clicksdead_wait_ms1000
clicksdead_dedupe_ms2000
formsinvalid_dedupe_ms1000
requestsunanswered_grace_ms1500
vitalsmax_msLCP 120,000, FCP 120,000, TTFB 120,000, INP 60,000
vitalsmax_cls10
replaychunk_interval_ms10,000
replaychunk_chars200,000
replaybuffer_ms30,000
replaymax_chunks_per_session720
replayupload_bytes_after_decompression4,000,000
replaysnapshots_per_session5
replaysnapshot_chars3,000,000
serverspans_per_request200
serverspan_attributes64
serverspan_attribute_chars256
serverfailures_per_request5
serverlog_failures_per_request3
serverslow_request_ms20,000

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar