# 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: el motor de Sypnia (código abierto, en tu propia infraestructura) y Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/concepts/sessions-and-replay/

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](https://docs.sypnia.com/es/sdks/identifying-people).

- 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ón | Del primer evento al último.                                                                                                  |
| Persona y cuenta       | Si se identificó.                                                                                                             |
| Dispositivo            | La clase de dispositivo, el navegador y el sistema operativo, el idioma.                                                      |
| Versión y entorno      | La versión de tu app que la persona estaba usando.                                                                            |
| Páginas                | Las rutas visitadas, en orden.                                                                                                |
| Conteos                | Vistas de página, clics, clics de rabia, clics muertos, errores y peticiones fallidas.                                        |
| Dificultades           | Una 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 tiempo        | Todos los eventos de la sesión, en orden.                                                                                     |
| Grabación              | Si 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.

> **En palabras simples**
>
> Una grabación no es un video ni una cámara sobre la persona. El SDK del navegador anota cómo estaba construida la página y cada cambio que tuvo, y el reproductor reconstruye la página a partir de esas notas.

### 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](https://docs.sypnia.com/es/sdks/sampling-and-quotas).

### 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ágina                                                                    | En la grabación                                                                                                 |
| ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| El texto                                                                        | Tal como se ve, salvo que lo enmascares.                                                                        |
| Lo que una persona escribe                                                      | **Siempre 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 uso | Nunca se graba, y es imposible desenmascararlo.                                                                 |
| Todo lo que marques con `data-sypnia-mask`                                      | Su texto se enmascara.                                                                                          |
| Todo lo que marques con `data-sypnia-block`                                     | Queda fuera. Una caja del mismo tamaño ocupa su lugar.                                                          |
| Marcos y videos                                                                 | Quedan fuera, como una caja del mismo tamaño.                                                                   |
| Dibujos en canvas                                                               | No se graban.                                                                                                   |
| Imágenes                                                                        | No se copian. El reproductor las carga desde su propia dirección.                                               |
| Clics, desplazamientos, movimiento del ratón, cambios de la página              | Se 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](https://docs.sypnia.com/es/privacy/masking).

### Quién puede ver una grabación

|                    | Motor de Sypnia (código abierto, en tu propia infraestructura)  | Sypnia Cloud (servicio pago, con un plan gratis)                                              |
| ------------------ | --------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Reproductor        | El 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 verla  | Quien tenga un token de API con el alcance replay.              | Los miembros de tu organización.                                                              |
| Cuántas se guardan | Las 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](https://docs.sypnia.com/es/cloud/plans-and-limits).

## 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:

| Tiempo | Qué pasó                                       |
| ------ | ---------------------------------------------- |
| 0:12   | Abrió el checkout                              |
| 0:27   | Hizo clic en Pagar                             |
| 0:29   | Hizo clic en Pagar 4 veces más (clic de rabia) |
| 0:31   | Pago rechazado: sin monto                      |
| 0:42   | Salió 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.
