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

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ón                           | Qué te dice                                                                        | Bueno          | Malo            |
| ---------------------------------- | ---------------------------------------------------------------------------------- | -------------- | --------------- |
| **LCP**, largest contentful paint  | Cuánto pasó hasta que se vio el contenido principal.                               | hasta 2.500 ms | más de 4.000 ms |
| **INP**, interaction to next paint | Cuánto tardó la página en reaccionar a un clic, un toque o una tecla.              | hasta 200 ms   | más de 500 ms   |
| **CLS**, cumulative layout shift   | Cuánto saltó la página mientras la persona la miraba. Es un puntaje, no un tiempo. | hasta 0,1      | más de 0,25     |
| **TTFB**, time to first byte       | Cuánto tardó tu servidor en empezar a responder.                                   | hasta 800 ms   | má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ón | Elemento                                      | Además                                  |
| -------- | --------------------------------------------- | --------------------------------------- |
| LCP      | El elemento que era el contenido principal.   | Si es una imagen o un texto.            |
| INP      | El elemento con el que la persona interactuó. | Si fue con el puntero o con el teclado. |
| CLS      | El elemento que más se movió.                 |                                         |
| TTFB     | Ninguno. 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úmero                               | Significado                                                                                                                                                                                                               |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Llamadas                             | Cuántas.                                                                                                                                                                                                                  |
| Duración p50 y p95                   | Como la vio el navegador, con la red incluida.                                                                                                                                                                            |
| p95 del servidor                     | Como la midió el servidor, cuando un SDK de servidor u OpenTelemetry reporta la petición.                                                                                                                                 |
| Errores del servidor y sin respuesta | Las llamadas que respondieron `500` o más, o que no recibieron ninguna respuesta.                                                                                                                                         |
| Rechazadas                           | Las 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](https://docs.sypnia.com/es/concepts/problems).                          |
| Tasa de fallas                       | Las 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ás              | El 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:

| Para              | Límites de las celdas                                                                 |
| ----------------- | ------------------------------------------------------------------------------------- |
| Duraciones, en ms | 50, 100, 200, 300, 500, 750, 1.000, 1.500, 2.000, 3.000, 5.000, 8.000, 12.000, 20.000 |
| CLS               | 0,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](https://docs.sypnia.com/es/concepts/alerts-and-daily-summary).

## 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](https://docs.sypnia.com/es/agent/how-the-analysis-works).

|                                       | Motor de Sypnia (código abierto, en tu propia infraestructura)                          | Sypnia Cloud (servicio pago, con un plan gratis)                     |
| ------------------------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| Mediciones, percentiles, elementos    | Sí. Léelos por la API, la CLI o MCP.                                                    | Sí, con las páginas de rendimiento de la app.                        |
| Sugerencias semanales                 | Las de reglas fijas, siempre. Las que escribe un modelo, con tu propia llave de modelo. | Incluidas.                                                           |
| Cuando una página se vuelve más lenta | Se 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 anteriores | Ayer                   |
| ------- | ----------------- | ---------------------- |
| Ruta    | `/search`         | `/search`              |
| LCP p75 | 1.900 ms (bueno)  | 3.100 ms (por mejorar) |
| Vistas  | 1.804             | 262                    |

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](https://docs.sypnia.com/es/api/performance). Qué mide el SDK del navegador y cómo apagarlo está en [Navegador](https://docs.sypnia.com/es/sdks/browser).
