跳至主要內容
Telemetry
前端可靠性 SQL查詢範例

按路線測量 SPA 導覽延遲

按目的地路線和前端版本比較典型和尾部客戶端導覽時間。

中級frontend_navigation_events已審查 2026-07-28測試用 阿帕奇 DataFusion 45.2.0

審閱者 Telemetry產品團隊 . SQL 相容性、事件契約、合成輸出和操作注意事項. 審查標準和所有權

問題已回答

哪些目的地路線的客戶端導覽速度最慢?

僅伺服器延遲就錯過了單頁面應用程式中的路由、資料載入、水合作用和渲染工作。導覽完成事件保留使用者可見的持續時間。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp導覽完成時間。
destination_routeUtf8穩定的目的地路由範本。
releaseUtf8前端版本識別符號。
duration_msFloat64從導覽開始到就緒狀態的時間。
statusUtf8成功、失敗或放棄。
DataFusion SQL

複製查詢

sql
SELECT
  destination_route,
  release,
  COUNT(*) AS navigations,
  approx_percentile_cont(duration_ms, 0.50) AS p50_ms,
  approx_percentile_cont(duration_ms, 0.95) AS p95_ms,
  100.0 * SUM(CASE WHEN status <> 'success' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS unsuccessful_pct
FROM frontend_navigation_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
GROUP BY destination_route, release
HAVING COUNT(*) >= 50
ORDER BY p95_ms DESC;

此只讀查詢是針對空型別資料表計劃和執行的 阿帕奇 DataFusion 45.2.0。確定性樣本輸出是綜合的並單獨審查;根據您自己的資料驗證欄位型別、閾值和業務定義。 閱讀測試方法。

查詢結果

p95 客戶端導覽延遲

報告導覽的尾部更寬,不成功的份額也更高。

destination_routereleasenavigationsp50_msp95_msunsuccessful_pct
/reports/:idweb-1036407803,2103.13
/projects/:idweb-1031,8204101,4801.21

綜合範例輸出。在將其用於操作決策之前,針對您自己的事件架構和閾值執行查詢。

p95 client navigation latency:來自 Measure SPA Navigation Latency by Route 範例結果的合成 p95_ms 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

JSON 包包含型別化事件契約, illustrative 輸入行、確切的 SQL、預期輸出、審閱註釋和引擎版本。 CSV 包含顯示的結果。

SQL 是如何工作的

  1. 1完成邊界應該表示特定於路由的就緒狀態,而不僅僅是 URL 更改。
  2. 2p50 和 p95 將一般緩慢的路線與間歇性長尾區分開來。
  3. 3失敗和放棄的導覽與延遲並存,因此快速故障無法使效能看起來健康。

需要決定的邊緣情況

  • 預取會更改持續時間中包含的工作。
  • 後台選項卡會扭曲瀏覽器計時,應進行分類。
  • 使用路由範本而不是識別符號或查詢字串。

推薦儀表板

  • 分組條:按路線劃分的 p50_ms 和 p95_ms
  • 趨勢:p95_ms(按版本)
  • 資料表:最慢的安全導覽範例

警示指導

當大流量路線超過其審查的完整儲存桶的 p95 目標時發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

建立資料表,調整欄位並儲存結果

免費開始,傳送結構化事件,並將查詢結果用作圖表、共享儀表板小工具或警示輸入。

獲取 API 金鑰