Saltar al contenido
Telemetry
Explorar documentación
GuíasActualizado el 28 de julio de 2026Revisado por los equipos editorial y de producto de Telemetry2 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

La confiabilidad del frontend es más que una puntuación de rendimiento única para todo el sitio. Una investigación útil necesita la métrica individual, su unidad, una ruta estable, la versión inicial y suficientes muestras para distinguir una regresión de una variación ordinaria. Los eventos de navegador estructurados hacen explícitos esos límites y permiten que el mismo SQL admita la revisión de versiones, los paneles y la respuesta a 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 del producto

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

Responsabilidad y referencias técnicas

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

Consultar los criterios editoriales