Saltar al contenido
Fiabilidad frontal receta SQL

Compare Core Web Vitals por ruta y lanzamiento

Compare muestras LCP, INP y CLS por ruta estable y liberación manteniendo visible el porcentaje de muestras aprobadas.

Intermediofrontend_vital_eventsRevisado 2026-07-28Probado con Apache DataFusion 45.2.0

Revisado por el equipo de producto Telemetry en . Revisamos la sintaxis SQL, los campos necesarios, los resultados de ejemplo y las limitaciones de la consulta. Quién revisa esta página

Pregunta respondida

¿Qué ruta y versión tiene el rendimiento frontend más débil?

Los promedios de frontend se vuelven procesables cuando preservan la ruta y liberan los límites. Esta consulta gira las muestras web vitales escritas en una fila por ruta y versión, luego ordena el resultado por la proporción de muestras que superaron los umbrales revisados ​​del producto.

Esquema del evento

Campos que espera la consulta

CampoTipoPor que existe
timestamp_utcTimestampHora de medición en UTC.
route_templateUtf8Plantilla de ruta estable sin valores de usuario o cadena de consulta.
releaseUtf8Identificador de versión de interfaz.
metric_nameUtf8Nombre de la métrica LCP, INP o CLS controlada.
metric_valueFloat64Valor de la métrica en su unidad documentada.
passedBooleanSi la muestra superó el umbral de versión del producto.
environmentUtf8Entorno de implementación.
DataFusionSQL

Copiar la consulta

sql
SELECT
  route_template,
  release,
  COUNT(*) AS samples,
  AVG(CASE WHEN metric_name = 'LCP' THEN metric_value ELSE NULL END) AS avg_lcp_ms,
  AVG(CASE WHEN metric_name = 'INP' THEN metric_value ELSE NULL END) AS avg_inp_ms,
  AVG(CASE WHEN metric_name = 'CLS' THEN metric_value ELSE NULL END) AS avg_cls,
  100.0 * SUM(CASE WHEN passed THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS passing_samples_pct
FROM frontend_vital_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
  AND environment = 'production'
GROUP BY route_template, release
ORDER BY passing_samples_pct ASC, route_template, release;

Esta consulta de solo lectura se planifica y ejecuta en una tabla escrita vacía con Apache DataFusion 45.2.0. El resultado de la muestra determinista es sintético y se revisa por separado; valide tipos de campos, umbrales y definiciones comerciales con sus propios datos. Lea la metodología de prueba.

Resultado de la consulta

Pasar muestras de frontend por ruta

Checkout aprueba la mitad de sus muestras sintéticas de LCP, INP y CLS; la búsqueda pasa todas las muestras.

route_templatereleasesamplesavg_lcp_msavg_inp_msavg_clspassing_samples_pct
/checkoutweb-102628002200,150
/searchweb-102618501200,05100

Salida de ejemplo sintético. Ejecute la consulta con su propio esquema de eventos y umbrales antes de utilizarla para decisiones operativas.

Passing frontend samples by route: gráfico estático de valores sintéticos de passing_samples_pct del resultado del ejemplo Compare Core Web Vitals by route and release
SVG indexable de la salida del ejemplo determinista. Descárguelo para ver un artículo, un runbook o una revisión de diseño con atribución.

Reproducir el ejemplo

Descarga los datos de ejemplo

El paquete JSON incluye el contrato de evento escrito, reproducible filas de entrada, SQL exacto, resultado esperado, notas de revisión y versión del motor. El CSV contiene el resultado mostrado.

Cómo funciona el SQL

  1. 1Las plantillas de ruta evitan una serie de gráficos por URL sin formato o identificador de cliente.
  2. 2La dimensión de lanzamiento convierte un cambio de rendimiento en una investigación con alcance de implementación.
  3. 3Los promedios específicos de métricas permanecen junto a un único resumen de muestra aprobada para que los revisores puedan ver qué vital se movió.

Casos límite que debes comprobar

  • Utilice umbrales específicos de métricas revisados y registre su versión cuando cambien las definiciones.
  • Segmente la clase y la geografía del dispositivo solo cuando el volumen de la muestra proteja la comparación del ruido.
  • Prefiera percentiles a promedios para informes de experiencia de producción cuando el motor SQL y el volumen de muestra lo permitan.

Panel recomendado

  • Barras: passing_samples_pct por ruta y lanzamiento.
  • Tendencias: LCP, INP y CLS por día completo
  • Tabla: rutas con recuento de muestras y cambio de versión

Guía de alerta

Alerta solo cuando el volumen de muestra es suficiente y una ruta permanece por debajo de su objetivo de rendimiento revisado para depósitos completos.

Leer configuración de alerta

Configura los eventos que necesita esta consulta

Instrumentación y guías relacionadas.

Definir los datos de origen

Esquemas de eventos para este análisis.

Continuar el análisis

Ejecútalo con tus eventos

Crea una tabla, adapta los campos y guarda el resultado.

Comience gratis, envíe eventos estructurados y utilice el resultado de la consulta como un gráfico, un widget de panel compartido o una entrada de alerta.

Obtén una clave API