Docs

Rendimiento

Cómo mide Sypnia la velocidad de las páginas y de la API para personas reales, cómo se calculan y se muestran los percentiles, y cómo nombra el elemento que hay detrás de una página lenta.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Velocidad de las páginas
  2. El elemento detrás del número
  3. Velocidad y fallas de la API
  4. Cómo se calculan y se muestran los percentiles
  5. Cuándo una página «se volvió más lenta»
  6. Sugerencias semanales
  7. Ejemplo: la página de búsqueda
  8. Referencia

Esta página es para quien quiere saber qué páginas y qué llamadas a la API son lentas para personas reales, y cuánto confiar en cada número. Las mediciones y los números son parte del motor de código abierto. Sypnia Cloud agrega las páginas de rendimiento de la app; en el motor lees los mismos números por la API, la CLI y MCP.

Todos los números salen de visitas reales a tu app, no de una prueba corrida en una sola máquina.

Velocidad de las páginas

Por cada página que abre una persona, el SDK del navegador reporta cuatro mediciones.

MediciónQué te diceBuenoMalo
LCP, largest contentful paintCuánto pasó hasta que se vio el contenido principal.hasta 2.500 msmás de 4.000 ms
INP, interaction to next paintCuánto tardó la página en reaccionar a un clic, un toque o una tecla.hasta 200 msmás de 500 ms
CLS, cumulative layout shiftCuánto saltó la página mientras la persona la miraba. Es un puntaje, no un tiempo.hasta 0,1más de 0,25
TTFB, time to first byteCuánto tardó tu servidor en empezar a responder.hasta 800 msmás de 1.800 ms

Entre «bueno» y «malo» un valor se califica como «por mejorar». Son los umbrales públicos de Web Vitals.

Reglas de medición:

  • El LCP y el TTFB pertenecen a la página en la que el navegador cargó el documento. Las páginas siguientes, a las que se llega navegando dentro de la app, no tienen.
  • El INP y el CLS se miden en cada página, incluidas las páginas a las que se llega navegando dentro de la app. El INP de una página es su interacción más lenta. El CLS de una página es la suma de sus saltos.
  • Los valores que no pueden ser reales se descartan: un LCP o un TTFB de más de 120 segundos, un INP de más de 60 segundos, un CLS de más de 10.

El elemento detrás del número

Un LCP lento solo sirve si sabes qué fue lo lento. Cada medición nombra su elemento:

MediciónElementoAdemás
LCPEl elemento que era el contenido principal.Si es una imagen o un texto.
INPEl elemento con el que la persona interactuó.Si fue con el puntero o con el teclado.
CLSEl elemento que más se movió.
TTFBNinguno. Trata del servidor.

El elemento se nombra con un selector armado con su id de prueba, su id o un camino corto de etiquetas. El selector nunca contiene el texto de la página. Para cada página, Sypnia lista los elementos que con más frecuencia están detrás de cada medición, con sus propios números.

Velocidad y fallas de la API

Por cada llamada que la página hace a tu API, y por cada petición que atiende tu servidor, Sypnia guarda números para cada método y ruta:

NúmeroSignificado
LlamadasCuántas.
Duración p50 y p95Como la vio el navegador, con la red incluida.
p95 del servidorComo la midió el servidor, cuando un SDK de servidor u OpenTelemetry reporta la petición.
Errores del servidor y sin respuestaLas llamadas que respondieron 500 o más, o que no recibieron ninguna respuesta.
RechazadasLas respuestas de 400 a 499. Por lo general es tu app diciendo que no a propósito. Un 400 también puede abrir un problema; mira Problemas.
Tasa de fallasLas llamadas que fallaron, divididas por las llamadas. Una llamada falló cuando no recibió respuesta, respondió 400, o respondió 500 o más. Las demás respuestas de 401 a 499 son llamadas rechazadas, no fallas.
Llamadas que hay detrásEl promedio de llamadas que cada petición hace a una base de datos o a otro servicio, y el tiempo promedio que pasa en ellas.

Las rutas se listan de la más lenta a la más rápida, por p95. Una ruta se lista como fallando cuando más del 2 % de sus llamadas respondieron 500 o más, o nada, con al menos 50 llamadas en el periodo. Esa es también la regla de la alerta «API fallando», que mira la última hora.

Cómo se calculan y se muestran los percentiles

Los promedios esconden las visitas lentas, así que Sypnia muestra percentiles.

  • El p75 es el número principal de las páginas: tres de cada cuatro visitas fueron así de rápidas o más. La calificación de una página (bueno, por mejorar, malo) es la calificación de su p75.
  • El p50 y el p95 se muestran para las llamadas a la API: la llamada típica, y la cola lenta.

Los percentiles se calculan a partir de histogramas con celdas fijas, así que cualquier rango de horas o de días se puede sumar y seguir dando un percentil. Los límites de las celdas son:

ParaLímites de las celdas
Duraciones, en ms50, 100, 200, 300, 500, 750, 1.000, 1.500, 2.000, 3.000, 5.000, 8.000, 12.000, 20.000
CLS0,01, 0,025, 0,05, 0,1, 0,15, 0,25, 0,4, 0,6, 1

Esto tiene tres consecuencias, y Sypnia muestra cada una en vez de esconderla:

  1. Un percentil es exacto hasta su celda, no hasta el milisegundo. Dentro de una celda el valor se estima en proporción a las muestras. Un p75 de 3.100 ms quiere decir «entre 3.000 y 5.000 ms, cerca del extremo bajo».
  2. Por encima del último límite, el valor real no se conoce. Un percentil que cae más allá de 20.000 ms, o más allá de un CLS de 1, se muestra como «más de 20 s», y los datos llevan una marca que lo dice.
  3. Un percentil viene con su número de muestras. Un p75 de 12 visitas y uno de 12.000 no valen lo mismo, así que la cantidad siempre está junto al número. Las listas de las páginas más lentas, y de las páginas que se volvieron más lentas, dejan fuera las páginas con menos de 50 vistas en el periodo.

Los números se pueden leer para una sola clase de dispositivo: móvil, tableta o escritorio. Están completos dentro de 10 minutos.

Cuándo una página «se volvió más lenta»

Sypnia dice que una página se volvió más lenta cuando se cumplen las dos cosas:

  • su LCP p75 de las últimas 24 horas está un 30 % o más por encima de su p75 de los 7 días anteriores, y
  • la página tuvo al menos 50 vistas en cada uno de los dos periodos.

Cuando eso pasa Sypnia crea una alerta, una vez, y el resumen diario lo reporta. Los dos números se pueden cambiar en las reglas de alerta del proyecto. Mira Alertas y el resumen diario.

Sugerencias semanales

Una vez a la semana, el lunes a las 07:00 UTC, el agente lee los números de la semana que terminó, los elementos que hay detrás y los datos de clics, y propone mejoras al rendimiento y a la forma en que se usa la app, cada una con su evidencia: la página, el número, el elemento. Algunas sugerencias salen de reglas fijas, como un INP de más de 500 ms en el p75 o más de 3 clics de rabia por cada 100 vistas, y no necesitan ningún modelo. Las otras las escribe un modelo. Mira Cómo funciona el análisis.

El motor de Sypnia y Sypnia Cloud, comparados
Motor de SypniaCódigo abierto, en tu propia infraestructuraSypnia CloudServicio pago, con un plan gratis
Mediciones, percentiles, elementosSí. Léelos por la API, la CLI o MCP.Sí, con las páginas de rendimiento de la app.
Sugerencias semanalesLas de reglas fijas, siempre. Las que escribe un modelo, con tu propia llave de modelo.Incluidas.
Cuando una página se vuelve más lentaSe registra una alerta y se envía a tus webhooks.Una alerta por correo y en la app, y una línea en el resumen diario.

Ejemplo: la página de búsqueda

El resumen diario de la tienda dice: «La página de búsqueda se volvió más lenta: 3,1 segundos en cargar, antes eran 1,9.»

Detrás de esa frase:

7 días anterioresAyer
Ruta/search/search
LCP p751.900 ms (bueno)3.100 ms (por mejorar)
Vistas1.804262

3.100 está un 63 % por encima de 1.900, y los dos periodos tienen más de 50 vistas, así que la página «se volvió más lenta». El elemento detrás del LCP es la primera imagen de producto, una imagen, en la mayoría de las visitas de ayer. Eso apunta a la foto, no al servidor: el TTFB no cambió.

Referencia

Los campos y los filtros están en la referencia de la API. Qué mide el SDK del navegador y cómo apagarlo está en Navegador.

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