本文へ移動
Telemetry
フロントエンドの信頼性 SQL レシピ

ルートごとにブラウザのロングタスク率を計算する

メインスレッドのブロック イベントとその合計ブロック時間をルートおよびフロントエンド リリースごとに測定します。

中級者browser_task_eventsレビュー済み 2026-07-28テスト済み アパッチ DataFusion 45.2.0

レビュー者 Telemetry 製品チーム . SQL の互換性、イベント コントラクト、合成出力、および操作上の注意事項. 基準と所有権を確認する

質問に回答しました

どのルートとリリースがブラウザーの長いタスクに最も時間を費やしますか?

長いタスクでは、ネットワーク リクエストが高速であっても、メイン スレッドの作業によって対話が遅延する可能性があることがわかります。レートとブロック時間により、頻度と重大度の両方が可視化されます。

イベント契約

クエリが期待するフィールド

フィールド種類なぜ存在するのか
timestamp_utcTimestampタスクの完了時間。
route_templateUtf8安定したページルート。
releaseUtf8フロントエンドのビルド識別子。
duration_msFloat64観察されたメインスレッドタスクの継続時間。
interaction_relatedBooleanタスクが測定されたインタラクションと重複しているかどうか。
DataFusion SQL

クエリをコピーする

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;

この読み取り専用クエリは、空の型付きテーブルに対して計画され、実行されます。 アパッチ DataFusion 45.2.0。決定論的なサンプル出力は合成され、個別にレビューされます。フィールド タイプ、しきい値、ビジネス定義を独自のデータと照合して検証します。 テスト方法を読んでください。

クエリ結果

ルート別のメインスレッドのブロック時間

観察されるタスクが少ないにもかかわらず、エディターは 2 倍以上のブロック時間を生み出します。

route_templatereleaseobserved_taskslong_tasksblocked_time_mslong_task_rate_pct
/editorweb-1039,20064452,1807
/dashboardweb-10315,40046223,8603

合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。

Blocked main-thread time by route: Calculate Browser Long-Task Rate by Route 結果例からの合成 blocked_time_ms 値の静的チャート
決定論的な出力例のインデックス可能な SVG。記事、ランブック、または出典を明示した設計レビューのためにダウンロードしてください。

例を再現する

パブリックフィクスチャをダウンロードする

JSON バンドルには、型付きイベント コントラクトが含まれています。 illustrative 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。

SQL の仕組み

  1. 150 ミリ秒の境界は、ブラウザーのロングタスク規則に従っています。
  2. 2ブロックされた時間は、許容される最初の 50 ミリ秒を差し引くため、重大度は加算されます。
  3. 3リリースのグループ化は、前後のレビューをサポートします。

決定すべきエッジケース

  • ブラウザのサポートとサンプリング レートを文書化する必要があります。
  • バックグラウンドタブでの作業は誤解を招く可能性があります。
  • 長いタスクはブロッキングを示しますが、補完的なプロファイリングがなければ原因となる機能は特定されません。

推奨されるダッシュボード

  • バー: ルート別 blocked_time_ms
  • トレンド: リリース別 long_task_rate_pct
  • 表: インタラクション関連の長いタスク

アラートガイダンス

リリース後に持続するブロック時間の回帰を確認します。重要なワークフローに関連付けられている場合にのみページを表示します。

アラート設定を読む

レシピを活用する

関連する機器とガイド

分析を続ける

実際のイベントで実行する

テーブルを作成し、フィールドを調整して、結果を保存します

無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。

API キーを取得する