Contrato de evento
Campos que espera la consulta
| Campo | Tipo | Por que existe |
|---|---|---|
| timestamp_utc | Timestamp | Hora de error del navegador en UTC. |
| route_template | Utf8 | Ruta estable del lado del cliente sin identificadores. |
| release | Utf8 | Identificador de versión o compilación de frontend. |
| error_fingerprint | Utf8 | Clase de error normalizada y firma de trama. |
| session_id | Utf8 | Identificador de sesión seguro para la privacidad. |
| environment | Utf8 | Entorno de implementación. |
Copiar la consulta
SELECT
route_template,
release,
error_fingerprint,
COUNT(*) AS errors,
COUNT(DISTINCT session_id) AS affected_sessions
FROM frontend_error_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
AND environment = 'production'
GROUP BY route_template, release, error_fingerprint
ORDER BY affected_sessions DESC, errors DESC
LIMIT 20;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
Sesiones afectadas por error de frontend
El error de procesamiento de pago tiene el mayor impacto en la sesión y el mayor volumen de repeticiones.
| route_template | release | error_fingerprint | errors | affected_sessions |
|---|---|---|---|---|
| /checkout | web-103 | payment-form-render | 184 | 121 |
| /projects/:id | web-103 | editor-state-null | 96 | 74 |
| /search | web-102 | result-card-image | 58 | 51 |
Salida de ejemplo sintético. Ejecute la consulta con su propio esquema de eventos y umbrales antes de utilizarla para decisiones operativas.
Reproducir el ejemplo
Descargar el accesorio público
El paquete JSON incluye el contrato de evento escrito, illustrative 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
- 1Las plantillas de ruta y las huellas digitales normalizadas evitan que las URL y los detalles de las líneas de pila fragmenten una falla.
- 2Sesiones distintas estiman el radio de explosión por separado de los errores repetidos en una sesión de navegador interrumpida.
- 3La agrupación de versiones hace visible una regresión sin asumir que la compilación más reciente causó todos los errores actuales.
Casos extremos para decidir
- No envíe contenidos de páginas sin procesar, valores de formularios, tokens de acceso ni URL completas en eventos de error del navegador.
- Los cambios en el mapa fuente y las huellas dactilares pueden dividir el mismo defecto en todas las versiones.
- El muestreo debe preservar una tasa documentada si los recuentos se comparan a lo largo del tiempo.
Panel recomendado
- Barras: affected_sessions por error de huella digital
- Tendencia: errores por versión
- Tabla: errores más recientes con contexto de navegador seguro
Guía de alerta
Alerta cuando una nueva huella digital afecta un número revisado de sesiones de producción después de un lanzamiento.
Leer configuración de alertaPon la receta a trabajar
Instrumentación y guías relacionadas.
Continuar el análisis
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.
Receta abiertaMedir la latencia de navegación SPA por ruta
Compare el tiempo de navegación típico y final del lado del cliente por ruta de destino y versión de interfaz.
Receta abiertaCalcular la tasa de tareas largas del navegador por ruta
Mida los eventos de bloqueo del hilo principal y su tiempo total de bloqueo por ruta y lanzamiento de interfaz.
Receta abiertaEjecú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.