Saltar al contenido
Telemetry
Explorar documentación

GuíasActualizado el 28 de julio de 20262 min de lectura

Usa esta documentación con tu agente de programación

Abra un paquete de mensajes enfocados para Claude Code, Codex, Cursor u otro agente de codificación, luego adáptelo al flujo de trabajo que se describe aquí.

En esta página
  1. Diseñar un evento de navegador acotado
  2. Comparar rutas y lanzamientos
  3. Construya una barandilla de liberación

Monitoreo de confiabilidad frontend con SQL

Si una versión del frontend ralentiza una página, una puntuación global no indica qué ruta cambió. Registre cada métrica del navegador con su unidad, ruta y versión. Compare suficientes muestras para distinguir una regresión de la variación normal y reutilice la consulta en un panel o una investigación de incidentes.

Diseñar un evento de navegador acotado

Emita un evento por medición admitida con metric_name, metric_value, metric_unit, route_template, release, threshold_version, passed y environment. Utilice una ruta como /projects/:id, nunca la URL sin formato. Agregue una clase de dispositivo limitada solo cuando cambie una decisión real y el segmento recibirá suficientes muestras.

No recopile cadenas de consulta, contenidos DOM, valores de formulario, cookies, datos de autorización o identificadores de usuario sin restricciones. Mantenga la versión umbral porque las definiciones y los objetivos del producto pueden cambiar independientemente de la publicación del código.

Comparar rutas y lanzamientos

El Receta de Core Web Vitals SQL gira las mediciones de LCP, INP y CLS en una fila por ruta y liberación. Mantiene el recuento de muestras y el porcentaje de muestras aprobadas junto a los promedios métricos, incluye filas de entrada deterministas y se puede ejecutar en el navegador SQL parque infantil.

Utilice el resultado en este orden:

  1. Confirme que el volumen de muestra y la ventana de observación sean comparables.
  2. Encuentre la ruta y suelte con la tasa de muestreo más débil.
  3. Inspeccione el elemento vital individual que se movió en lugar de tratar el resumen como la causa.
  4. Compare la versión con su predecesora y verifique la recuperación en períodos de tiempo completos.

Los informes de producción a menudo se benefician tanto de los percentiles como de los promedios. Conserve la misma ruta, versión, métrica y contrato unitario al agregarlos.

Construya una barandilla de liberación

Un panel debe mostrar el recuento de muestras, LCP, INP, CLS y la versión del umbral. Una barandilla de liberación debería requerir un volumen mínimo revisado y una regresión sostenida. No debería bloquear una implementación debido a un dispositivo o segmento de ruta disperso.

El caso de uso de rendimiento frontend proporciona una lista de verificación de revisión y avisos de instrumentación. Utilice guía de proxy de telemetría del navegador para mantener la clave Telemetry API en el lado del servidor y aplicar un contrato de navegador incluido en la lista de permitidos. Empareje la experiencia del navegador con Fiabilidad API SQL cuando una página lenta pueda originarse en una ruta o dependencia de backend.

Función relacionada

Ejecute DataFusion SQL de solo lectura sobre tablas de eventos estructurados y reutilice el resultado.

Autores de la página y referencias

El equipo editorial de Telemetry es responsable de esta explicación; el equipo de producto revisa el comportamiento, los ejemplos y las limitaciones.

Cómo revisamos nuestra documentación