Docs

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.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Qué se muestrea y qué no
  2. Qué sesiones tienen grabación
  3. Cambiar la parte que se graba
  4. Grabar siempre a una persona o a una cuenta
  5. La señal de «baja el ritmo»
  6. Qué pasa al llegar a un límite
  7. Enviar menos a propósito
  8. Revisar qué aplica a una sesión
  9. Sigue con

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
ErroresNoSe 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 propiosNoSe envía cada uno.
Rendimiento (LCP, INP, CLS, TTFB)NoCada página reporta sus valores.
Llamadas a la API desde el navegadorNoCada llamada a tu origen y a traceTargets y recordTargets.
Peticiones al servidor (Node, Next.js)NoSe traza cada petición, salvo archivos estáticos, OPTIONS y tus ignoreRoutes. El muestreo de peticiones exitosas está Planeado.
Spans de OpenTelemetryLo decides túSypnia guarda lo que envía tu SDK o tu Collector.
GrabacionesSíMira abajo.
Capturas de página, para mapas de clicsSí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:

  1. 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.
  2. La sesión está en la parte muestreada. Una parte de todas las sesiones se graba desde su inicio. Por defecto es el 10 %.
  3. 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:

Terminal
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}}}'
Deberías ver
200 y el proyecto, con "sample_rate": 0.25 bajo settings.replay.
AjusteTipoPor defectoSignificado
replay.sample_ratenúmero, de 0 a 10.1La parte de las sesiones que se graba desde su inicio. 0 graba solo las sesiones donde algo sale mal. 1 graba todas.
replay.always_recordlista[]Personas y cuentas cuyas sesiones se graban siempre. Mira abajo.
replay.blocked_routeslista de rutas[]Rutas donde no se graba nada. Mira Privacidad y enmascarado.
replay.mask_all_textbooleanofalseEnmascara todo el texto en todas las grabaciones.
snapshots.sample_ratenúmero, de 0 a 10.5La 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

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

JSON
{
  "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ñalQué 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: falseDeja 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.
untilCuá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

El motor de Sypnia y Sypnia Cloud, comparados
Motor de SypniaCódigo abierto, en tu propia infraestructuraSypnia CloudServicio pago, con un plan gratis
De dónde salen los límitesDe 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 eventosLa 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 grabacionesLa 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 leerContadores 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 reducirHaz
Trazas del servidorAgrega las rutas ruidosas a ignoreRoutes en el SDK de Node: chequeos de salud, endpoints de sondeo.
Peticiones del navegadorAgrega las llamadas de sondeo a ignoreRequests.
Errores que nunca vas a arreglarAgrégalos a ignoreErrors, o marca el problema como ignorado.
Valores de rendimientocapture: { vitals: false } en el SDK del navegador.
GrabacionesBaja replay.sample_rate. Las sesiones con problemas se siguen grabando.
Todo lo de una parte de la appignoreRoutes.

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

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