Saltar al contenido
Telemetry
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 . Compatibilidad con SQL, contrato de eventos, resultados sintéticos y advertencias operativas. Revisar los estándares y la propiedad

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.

Contrato de 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

Descargar el accesorio público

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 extremos para decidir

  • 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

Pon la receta a trabajar

Instrumentación y guías relacionadas.

Definir los datos de origen

Esquemas de eventos para este análisis.

Continuar el análisis

Ejecútelo en eventos reales.

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