Docs

Sesiones y grabación

Qué empieza y qué termina una sesión, de quién es una sesión, qué sesiones se graban y qué muestra exactamente una grabación.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Sesión
  2. Cuándo empieza una sesión
  3. Cuándo termina una sesión
  4. De quién es una sesión
  5. Las sesiones y tu servidor
  6. Qué guarda una sesión
  7. Grabación
  8. Qué sesiones se graban
  9. Cómo viaja una grabación
  10. Qué muestra una grabación, y qué no muestra nunca
  11. Quién puede ver una grabación
  12. Cuando se llega al límite de grabaciones
  13. Ejemplo: una de las tres sesiones

Esta página es para quien quiere saber qué registra Sypnia de una visita. Las sesiones y los datos de grabación funcionan igual en el motor de código abierto y en Sypnia Cloud. La diferencia es el reproductor: la Consola del motor tiene un visor de grabaciones, y la app de Cloud tiene el reproductor completo.

Sesión

Una sesión es una visita de una persona, desde la primera página hasta la última, con todos los eventos que pasaron en medio.

Cuándo empieza una sesión

Una sesión empieza con la primera actividad cuando no hay ninguna sesión viva en ese navegador. Actividad es cualquier cosa que hace una persona:

  • una vista de página,
  • un clic,
  • una tecla, un desplazamiento con la rueda, un toque,
  • la pestaña que vuelve a estar visible.

Un error, o un evento propio enviado por tu código, también empieza una sesión si no hay ninguna viva, para que ninguno de los dos se pierda.

Cuándo termina una sesión

Una sesión termina después de 30 minutos sin actividad en todas las pestañas. La siguiente actividad empieza una nueva.

De ahí salen tres reglas:

  • Las pestañas comparten la sesión. Dos pestañas de tu app en el mismo navegador son una sola sesión.
  • El trabajo de fondo no mantiene viva una sesión. Las peticiones que la página hace con un temporizador, las mediciones de rendimiento y las subidas de la grabación no cuentan como actividad. Una pestaña que quedó abierta toda la noche no es una sesión de diez horas.
  • Otra persona es otra sesión. Si tu app identifica a una persona distinta en el mismo navegador, o avisa con identify(null) que la persona cerró su sesión, la sesión termina y la siguiente actividad empieza una nueva. Identificar a alguien en una sesión anónima no la corta: la sesión sigue siendo la misma y pasa a ser de esa persona.

No hay una duración máxima. Una sesión dura mientras la persona siga activa.

De quién es una sesión

Las sesiones son anónimas hasta que tu app dice quién es la persona, con identify(). Mira Identificar personas.

  • Una persona tiene un id que elige tu app. Para Sypnia es una cadena opaca. Un nombre y un correo se guardan solo si tu app los envía.
  • Una cuenta es opcional: el equipo, la empresa o el club al que pertenece la persona en tu app. Tiene un id y, si tu app lo envía, un nombre.

Las sesiones anónimas son de primera clase: se listan, se cuentan y se pueden reproducir como cualquier otra. Cuando Sypnia dice «3 personas», cuenta las personas identificadas, más una por cada dispositivo cuyas sesiones nunca se identificaron.

Sypnia también muestra la actividad de cada persona y de cada cuenta: cuántas sesiones, qué páginas y cuándo se le vio por última vez.

Las sesiones y tu servidor

Una sesión existe solo donde corre el SDK del navegador. Cuando la página llama a tu API, el SDK envía el id de la sesión, y la parte de esa petición que ocurre en el servidor entra a la línea de tiempo de la sesión. Un proyecto que solo envía datos del servidor o de OpenTelemetry tiene problemas, trazas y números de rendimiento, y no tiene sesiones.

Qué guarda una sesión

Inicio, fin y duraciónDel primer evento al último.
Persona y cuentaSi se identificó.
DispositivoLa clase de dispositivo, el navegador y el sistema operativo, el idioma.
Versión y entornoLa versión de tu app que la persona estaba usando.
PáginasLas rutas visitadas, en orden.
ConteosVistas de página, clics, clics de rabia, clics muertos, errores y peticiones fallidas.
DificultadesUna sesión se marca con dificultades cuando tiene al menos un error, un clic de rabia, un clic muerto o una petición fallida.
Línea de tiempoTodos los eventos de la sesión, en orden.
GrabaciónSi la sesión se grabó.

La lista de sesiones está completa dentro de los 10 minutos siguientes a los eventos.

Grabación

Una grabación es el registro de una sesión, reproducido como lo vio la persona.

Qué sesiones se graban

Grabar todas las sesiones sería costoso y casi nunca hace falta. Por defecto el SDK del navegador graba:

  1. Todas las sesiones en las que algo sale mal. El SDK guarda los últimos 30 segundos en la memoria del navegador y no sube nada. Al primer error, clic de rabia o clic muerto, sube esos segundos y sigue grabando desde ahí. Así la grabación muestra lo que llevó a la falla.
  2. Una de cada diez de las demás sesiones, desde su comienzo.
  3. Todas las sesiones de una persona o de una cuenta que elegiste grabar siempre, por ejemplo un cliente al que estás ayudando. Una regla así termina sola: a los 14 días si no dices otra cosa, y a los 90 días como máximo.

El motor decide una vez por sesión, y el SDK le pregunta la decisión cuando la sesión empieza, así que la respuesta es la misma en todas las pestañas. Puedes cambiar la proporción, agregar reglas de «grabar siempre» y apagar la grabación en cualquier ruta de tu app, todo en la configuración del proyecto y sin volver a publicar tu app. Mira Muestreo y cuotas.

Cómo viaja una grabación

Mientras graba, el SDK sube un trozo cada 10 segundos, o antes cuando un trozo crece mucho. Una sesión se graba durante 720 trozos como máximo, que son 2 horas de grabación. Después la sesión sigue sin grabarse.

Un trozo que no se pudo subir se vuelve a intentar. Si se pierde para siempre, la grabación conserva un hueco marcado y sigue después de él. El reproductor muestra el hueco y dice por qué.

Una grabación se puede ver cuando su sesión lleva 2 minutos sin actividad, o ya terminó.

Qué muestra una grabación, y qué no muestra nunca

En la páginaEn la grabación
El textoTal como se ve, salvo que lo enmascares.
Lo que una persona escribeSiempre enmascarado. Cada carácter se vuelve un asterisco. No hay ninguna opción para grabar texto escrito.
El contenido de los campos de contraseña, de tarjeta y de código de un solo usoNunca se graba, y es imposible desenmascararlo.
Todo lo que marques con data-sypnia-maskSu texto se enmascara.
Todo lo que marques con data-sypnia-blockQueda fuera. Una caja del mismo tamaño ocupa su lugar.
Marcos y videosQuedan fuera, como una caja del mismo tamaño.
Dibujos en canvasNo se graban.
ImágenesNo se copian. El reproductor las carga desde su propia dirección.
Clics, desplazamientos, movimiento del ratón, cambios de la páginaSe graban.

El enmascarado ocurre en el navegador, antes de enviar nada. Las reglas completas, incluida maskAllText para enmascarar todo el texto de todas las páginas, están en Enmascarado.

Quién puede ver una grabación

El motor de Sypnia y Sypnia Cloud, comparados
Motor de SypniaCódigo abierto, en tu propia infraestructuraSypnia CloudServicio pago, con un plan gratis
ReproductorEl visor de grabaciones de la Consola.El reproductor completo de la app, con el momento en que falló marcado en la línea de tiempo.
Quién puede verlaQuien tenga un token de API con el alcance replay.Los miembros de tu organización.
Cuántas se guardanLas que quepan en tu almacenamiento, por el tiempo que definas.Hasta las grabaciones al mes de tu plan, por el tiempo que tu plan guarda los datos.

El contenido de una grabación se entrega con enlaces de corta duración. Un token que solo tiene el alcance read puede ver que una sesión tiene grabación, pero no puede descargarla.

El agente nunca lee los píxeles de una grabación ni lo que se escribió. Lee los eventos de la sesión: qué se tocó, qué peticiones fallaron, qué error se lanzó.

Cuando se llega al límite de grabaciones Nube

Un plan incluye una cantidad de grabaciones al mes, para toda la organización. Una grabación es una sesión que tiene registro, dure lo que dure. Cuando se llega al límite, a los SDK se les dice que dejen de grabar hasta que termine el mes. Las sesiones se siguen listando con su línea de tiempo completa, y cada una que se habría grabado lo dice. Mira Planes y límites.

Ejemplo: una de las tres sesiones

Uno de los tres clientes que no pudieron pagar, tal como lo muestra la línea de tiempo de la sesión:

TiempoQué pasó
0:12Abrió el checkout
0:27Hizo clic en Pagar
0:29Hizo clic en Pagar 4 veces más (clic de rabia)
0:31Pago rechazado: sin monto
0:42Salió de la página

La sesión no estaba en la proporción de una de cada diez. Se grabó por el clic de rabia, que se reportó cuando la ráfaga terminó, a los 0:31. El SDK tenía en memoria los últimos 30 segundos, así que la grabación cubre la visita casi desde el principio. Lo que el cliente escribió en el campo de la tarjeta no está en la grabación: el campo solo tiene asteriscos.

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