Muestreo y cuotas
Qué sesiones se graban y cómo cambiarlo, qué envían y qué retienen los SDK, la señal de «baja el ritmo», y qué pasa exactamente cuando un proyecto llega a un límite.
Esta página es para quien decide cuánto graba Sypnia y cuánto cuesta. Los SDK se comportan igual con el motor de código abierto y con Sypnia Cloud. Cambia de dónde salen los límites: un plan en Sypnia Cloud, una cuota que pones tú (o ninguna) en tu propio motor.
Al final sabrás: qué sesiones tienen grabación, cómo grabar más o menos, y qué hace el SDK de tu app cuando se llega a un límite. Nunca se descarta nada en silencio.
Qué se muestrea y qué no
| Señal | ¿Se muestrea? | Regla |
|---|---|---|
| Errores | No | Se envía cada error, dentro de las reglas de ruido: el mismo error cuenta una vez cada 5 segundos, y máximo 20 errores por minuto por página. |
| Vistas de página, clics, clics de rabia y muertos, fallos de formulario, eventos propios | No | Se envía cada uno. |
| Rendimiento (LCP, INP, CLS, TTFB) | No | Cada página reporta sus valores. |
| Llamadas a la API desde el navegador | No | Cada llamada a tu origen y a traceTargets y recordTargets. |
| Peticiones al servidor (Node, Next.js) | No | Se traza cada petición, salvo archivos estáticos, OPTIONS y tus ignoreRoutes. El muestreo de peticiones exitosas está Planeado. |
| Spans de OpenTelemetry | Lo decides tú | Sypnia guarda lo que envía tu SDK o tu Collector. |
| Grabaciones | Sí | Mira abajo. |
| Capturas de página, para mapas de clics | Sí | La mitad de las sesiones, máximo una por ruta y cinco por sesión. |
Qué sesiones tienen grabación
El motor decide una vez por sesión, y el SDK pide la decisión cuando la sesión empieza. Hay tres caminos hacia una grabación:
- Algo sale mal. Toda sesión guarda sus últimos 30 a 60 segundos en la memoria del navegador y no sube nada. Al primer error, clic de rabia o clic muerto, el SDK sube esos segundos y graba desde ahí. Esto no necesita ningún ajuste.
- La sesión está en la parte muestreada. Una parte de todas las sesiones se graba desde su inicio. Por defecto es el 10 %.
- Una regla de «grabar siempre» nombra a la persona o a la cuenta de la sesión.
La decisión es estable: la misma sesión recibe siempre la misma respuesta, en todas las pestañas. Si el SDK no logra preguntarle al motor, se comporta como en el punto 1.
Una grabación termina tras 720 trozos, que son dos horas de grabación. La sesión sigue sin ella.
Cambiar la parte que se graba
La parte es un ajuste del proyecto, replay.sample_rate, de 0 a 1. No es una opción en código, así que la cambias sin publicar tu app, y llega a cada navegador con su siguiente sesión.
Sypnia Cloud
Cámbiala en los ajustes del proyecto en la app, o con la API y un token de API con el permiso admin:
curl -X PATCH "https://api.sypnia.com/v1/projects/shop" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"settings": {"replay": {"sample_rate": 0.25}}}'Alojamiento propio
Con la API y un token de API con el permiso admin, o con el token raíz:
curl -X PATCH "https://sypnia.example.com/v1/projects/shop" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"settings": {"replay": {"sample_rate": 0.25}}}'200 y el proyecto, con "sample_rate": 0.25 bajo settings.replay.| Ajuste | Tipo | Por defecto | Significado |
|---|---|---|---|
replay.sample_rate | número, de 0 a 1 | 0.1 | La parte de las sesiones que se graba desde su inicio. 0 graba solo las sesiones donde algo sale mal. 1 graba todas. |
replay.always_record | lista | [] | Personas y cuentas cuyas sesiones se graban siempre. Mira abajo. |
replay.blocked_routes | lista de rutas | [] | Rutas donde no se graba nada. Mira Privacidad y enmascarado. |
replay.mask_all_text | booleano | false | Enmascara todo el texto en todas las grabaciones. |
snapshots.sample_rate | número, de 0 a 1 | 0.5 | La parte de las sesiones que toma capturas de página para los mapas de clics. |
Para apagar la grabación del todo en una app, diga lo que diga el proyecto, pasa replay: false a init: la grabadora nunca se carga.
Grabar siempre a una persona o a una cuenta
curl -X PATCH "https://api.sypnia.com/v1/projects/shop" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"settings": {"replay": {"always_record": [
{"person": "u_1042", "note": "Reported the checkout bug", "until": "2026-03-26T00:00:00Z"}
]}}}'Cada regla nombra a una person o a una account por el id que tu app le pasa a identify(), y puede llevar una note y una fecha until tras la cual deja de aplicar. La regla aplica desde la siguiente sesión de esa persona. Dentro de una sesión que ya está corriendo, aplica desde el momento en que se identifica a la persona, si el SDK no había preguntado antes. En un motor con alojamiento propio usa tu propia URL base.
La señal de «baja el ritmo»
Cada respuesta de la ingesta dice cuántos eventos se guardaron y cuántos no, y por qué. Cuando el proyecto llegó a un límite, la respuesta trae además slow_down:
{
"accepted": 1,
"dropped": 1,
"dropped_reasons": { "limit_reached": 1 },
"slow_down": {
"reason": "events_limit",
"send": "failures",
"replay": false,
"until": "2026-04-01T00:00:00Z"
}
}Los SDK la obedecen de inmediato y la recuerdan hasta until, en todas las pestañas:
| En la señal | Qué hace el SDK |
|---|---|
send: "failures" | Envía solo fallos: errores, llamadas a la API que fallaron, y en el servidor las peticiones que fallaron con sus spans. También sigue enviando lo que une un fallo con una visita y una persona: inicios de sesión de uso, vistas de página e identify. Deja de enviar valores de rendimiento, peticiones exitosas, clics, fallos de formulario y eventos propios. |
replay: false | Deja de grabar y de subir. Una sesión que se habría grabado recibe una marca que lo dice (replay_gap, motivo limit), así que su línea de tiempo te lo cuenta. |
until | Cuándo volver a lo normal. El SDK vuelve a preguntar al empezar la siguiente sesión después de esa hora. |
El mismo objeto viene con los ajustes por sesión que el SDK lee al empezar cada sesión, así que un navegador que abre tu app después de que se llegó al límite nunca empieza a enviar lo que se rechazaría.
Una ráfaga es otra cosa. Si una dirección envía demasiado rápido con una llave, la ingesta responde 429 con Retry-After. El SDK espera ese tiempo, máximo 60 segundos, y envía el mismo lote una vez más.
Qué pasa al llegar a un límite
| Motor de SypniaCódigo abierto, en tu propia infraestructura | Sypnia CloudServicio pago, con un plan gratis | |
|---|---|---|
| De dónde salen los límites | De ninguna parte, salvo que pongas una cuota a un proyecto en la configuración del motor. | De tu plan: eventos al mes y grabaciones al mes. |
| Al 80 % | Se registra una alerta, y se envía a tu webhook si pusiste uno. | Los dueños de la organización reciben una alerta por correo y en la app. |
| Al 100 % de los eventos | La ingesta envía slow_down. Los fallos se siguen guardando. | La ingesta envía slow_down hasta que termina el mes. Los fallos se siguen guardando, así que un problema nuevo sigue apareciendo y sigue alertando. |
| Al 100 % de las grabaciones | La ingesta les dice a los SDK que dejen de grabar. | La ingesta les dice a los SDK que dejen de grabar hasta que termina el mes. Las sesiones se siguen listando con su línea de tiempo completa. |
| Qué puedes leer | Contadores de uso por la API y el CLI. | Contadores de uso en la app y por la API, con cuántos eventos no se guardaron. |
Lo que cuenta como evento en Sypnia Cloud es poco: un error, una traza o un valor de rendimiento. Las vistas de página, los clics, los fallos de formulario y los eventos propios son gratis. Las reglas exactas y los números de cada plan están en Planes y límites; las cuotas de un motor con alojamiento propio están en su configuración.
Enviar menos a propósito
Antes de un límite es el mejor momento para elegir qué importa:
| Para reducir | Haz |
|---|---|
| Trazas del servidor | Agrega las rutas ruidosas a ignoreRoutes en el SDK de Node: chequeos de salud, endpoints de sondeo. |
| Peticiones del navegador | Agrega las llamadas de sondeo a ignoreRequests. |
| Errores que nunca vas a arreglar | Agrégalos a ignoreErrors, o marca el problema como ignorado. |
| Valores de rendimiento | capture: { vitals: false } en el SDK del navegador. |
| Grabaciones | Baja replay.sample_rate. Las sesiones con problemas se siguen grabando. |
| Todo lo de una parte de la app | ignoreRoutes. |
Revisar qué aplica a una sesión
Pon debug: true. Al empezar una sesión el SDK imprime la decisión que recibió, por ejemplo replay: buffer (sample_rate 0.1), y cualquier slow_down vigente.
Sigue con
- Qué incluye cada plan y cómo se cuenta cada límite.
- Qué muestra una grabación, y qué nunca muestra.
-
Ingesta en la referencia de la API
Las respuestas de la ingesta, campo por campo.