Saltar al contenido
Telemetry
Fiabilidad frontal receta SQL

Calcular 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.

Intermediobrowser_task_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é rutas y versiones pasan más tiempo en tareas largas del navegador?

Las tareas largas muestran dónde el trabajo del hilo principal puede retrasar la interacción incluso cuando las solicitudes de red son rápidas. La frecuencia y el tiempo bloqueado hacen visibles tanto la frecuencia como la gravedad.

Contrato de evento

Campos que espera la consulta

CampoTipoPor que existe
timestamp_utcTimestampTiempo de finalización de la tarea.
route_templateUtf8Ruta de página estable.
releaseUtf8Identificador de compilación de interfaz.
duration_msFloat64Duración observada de la tarea del hilo principal.
interaction_relatedBooleanSi la tarea se superpuso a una interacción medida.
DataFusionSQL

Copiar la consulta

sql
SELECT
  route_template,
  release,
  COUNT(*) AS observed_tasks,
  SUM(CASE WHEN duration_ms > 50 THEN 1 ELSE 0 END) AS long_tasks,
  SUM(CASE WHEN duration_ms > 50 THEN duration_ms - 50 ELSE 0 END)
    AS blocked_time_ms,
  100.0 * SUM(CASE WHEN duration_ms > 50 THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS long_task_rate_pct
FROM browser_task_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
GROUP BY route_template, release
ORDER BY blocked_time_ms DESC;

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

Tiempo de bloqueo del hilo principal por ruta

El editor crea más del doble del tiempo bloqueado a pesar de menos tareas observadas.

route_templatereleaseobserved_taskslong_tasksblocked_time_mslong_task_rate_pct
/editorweb-103920064452.1807
/dashboardweb-10315.40046223.8603

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

Blocked main-thread time by route: gráfico estático de valores sintéticos de blocked_time_ms del resultado del ejemplo Calculate Browser Long-Task Rate by Route
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, 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

  1. 1El límite de 50 ms sigue la convención de tareas largas del navegador.
  2. 2El tiempo bloqueado resta los primeros 50 ms permitidos, por lo que la gravedad es aditiva.
  3. 3La agrupación de versiones admite la revisión antes y después.

Casos extremos para decidir

  • Se deben documentar la compatibilidad del navegador y las tasas de muestreo.
  • El trabajo con pestañas en segundo plano puede resultar engañoso.
  • Las tareas largas indican bloqueo pero no identifican la función responsable sin un perfil complementario.

Panel recomendado

  • Bares: blocked_time_ms por ruta
  • Tendencia: long_task_rate_pct por lanzamiento
  • Tabla: tareas largas relacionadas con la interacción

Guía de alerta

Revisar regresiones sostenidas de tiempo bloqueado después de un lanzamiento; página sólo cuando está vinculado a un flujo de trabajo crítico.

Leer configuración de alerta

Pon la receta a trabajar

Instrumentación y guías relacionadas.

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