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

按路線和版本比較核心網路生命力

按穩定路線和釋放比較 LCP、INP 和 CLS 樣品,同時保持透過樣品的百分比可見。

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

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

問題已回答

哪個路線和版本的前端效能最弱?

當前端平均保留路線並釋放邊界時,它們就變得可行。此查詢將鍵入的 Web-vital 樣本按路線和版本轉換為一行,然後按透過產品審查閾值的樣本比例對結果進行排序。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestampUTC 測量時間。
route_templateUtf8沒有使用者或查詢字串值的穩定路由範本。
releaseUtf8前端版本識別符號。
metric_nameUtf8受控 LCP、INP 或 CLS 指標名稱。
metric_valueFloat64以其記錄單位表示的度量值。
passedBoolean範例是否透過了產品的版本閾值。
environmentUtf8部署環境。
DataFusion SQL

複製查詢

sql
SELECT
  route_template,
  release,
  COUNT(*) AS samples,
  AVG(CASE WHEN metric_name = 'LCP' THEN metric_value ELSE NULL END) AS avg_lcp_ms,
  AVG(CASE WHEN metric_name = 'INP' THEN metric_value ELSE NULL END) AS avg_inp_ms,
  AVG(CASE WHEN metric_name = 'CLS' THEN metric_value ELSE NULL END) AS avg_cls,
  100.0 * SUM(CASE WHEN passed THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS passing_samples_pct
FROM frontend_vital_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
  AND environment = 'production'
GROUP BY route_template, release
ORDER BY passing_samples_pct ASC, route_template, release;

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

查詢結果

透過路由傳遞前端樣本

一半的合成 LCP、INP 和 CLS 樣品透過 Checkout;搜尋透過所有樣本。

route_templatereleasesamplesavg_lcp_msavg_inp_msavg_clspassing_samples_pct
/checkoutweb-10262,8002200.150
/searchweb-10261,8501200.05100

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

Passing frontend samples by route:來自 Compare Core Web Vitals by Route and Release 範例結果的合成 passing_samples_pct 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1路由範本可防止每個原始 URL 或客戶識別符號出現一個圖表系列。
  2. 2發布維度將效能變化轉變為部署範圍的調查。
  3. 3特定指標的平均值保留在單個透過樣本摘要旁邊,以便審查者可以看到哪個重要部分發生了變化。

需要決定的邊緣情況

  • 使用經過審查的特定指標閾值,並在定義更改時記錄其版本。
  • 僅當樣本量可以保護比較免受噪聲影響時,才對裝置類別和地理位置進行細分。
  • 當 SQL 引擎和樣本量允許時,在生產體驗報告中優先使用百分位數而不是平均值。

推薦儀表板

  • 酒吧:passing_samples_pct(按路線和發布)
  • 趨勢:全天 LCP、INP 和 CLS
  • 資料表:包含樣本數量和版本變化的路線

警示指導

僅當樣本量足夠並且路線仍低於其審查的完整儲存桶效能目標時才發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

定義源資料

此分析的事件模式

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰