活動合約
查詢期望的欄位
| 欄位 | 型別 | 為什麼存在 |
|---|---|---|
| timestamp_utc | Timestamp | UTC 測量時間。 |
| route_template | Utf8 | 沒有使用者或查詢字串值的穩定路由範本。 |
| release | Utf8 | 前端版本識別符號。 |
| metric_name | Utf8 | 受控 LCP、INP 或 CLS 指標名稱。 |
| metric_value | Float64 | 以其記錄單位表示的度量值。 |
| passed | Boolean | 範例是否透過了產品的版本閾值。 |
| environment | Utf8 | 部署環境。 |
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;搜尋透過所有樣本。
/checkout
50%
/search
100%
| route_template | release | samples | avg_lcp_ms | avg_inp_ms | avg_cls | passing_samples_pct |
|---|---|---|---|---|---|---|
| /checkout | web-102 | 6 | 2,800 | 220 | 0.1 | 50 |
| /search | web-102 | 6 | 1,850 | 120 | 0.05 | 100 |
綜合範例輸出。在將其用於操作決策之前,針對您自己的事件架構和閾值執行查詢。
SQL 是如何工作的
- 1路由範本可防止每個原始 URL 或客戶識別符號出現一個圖表系列。
- 2發布維度將效能變化轉變為部署範圍的調查。
- 3特定指標的平均值保留在單個透過樣本摘要旁邊,以便審查者可以看到哪個重要部分發生了變化。
需要決定的邊緣情況
- 使用經過審查的特定指標閾值,並在定義更改時記錄其版本。
- 僅當樣本量可以保護比較免受噪聲影響時,才對裝置類別和地理位置進行細分。
- 當 SQL 引擎和樣本量允許時,在生產體驗報告中優先使用百分位數而不是平均值。
推薦儀表板
- 酒吧:passing_samples_pct(按路線和發布)
- 趨勢:全天 LCP、INP 和 CLS
- 資料表:包含樣本數量和版本變化的路線
讓查詢範例發揮作用
相關埋點和指南
定義源資料
此分析的事件模式
繼續分析
在真實事件中執行它
建立資料表,調整欄位並儲存結果
免費開始,傳送結構化事件,並將查詢結果用作圖表、共享儀表板小工具或警示輸入。