跳至主要內容
Telemetry
瀏覽說明文件
指南更新於 2026年7月28日由 Telemetry 編輯團隊和產品團隊審查閱讀約需 2 分鐘

讓程式設計代理使用這篇文件

開啟 Claude Code、Codex、Cursor 或其他編碼代理的集中提示包,然後將其適應此處介紹的工作流程。

本頁內容
  1. 設計有界瀏覽器事件
  2. 比較路線和版本
  3. 搭建釋放護欄

使用 SQL 進行前端可靠性監控

前端可靠性不僅僅是單個站點範圍的效能得分。一項有用的調查需要單獨的指標、其單位、穩定的路線、前端版本以及足夠的樣本來區分迴歸和普通變化。結構化瀏覽器事件使這些邊界變得明確,並讓相同的 SQL 支援發布審查、儀表板和事件回應。

設計有界瀏覽器事件

使用 metric_namemetric_valuemetric_unitroute_templatereleasethreshold_versionpassedenvironment 的每個支援的測量發出一個事件。使用 /projects/:id 等路由,切勿使用原始 URL。僅當有界裝置類改變實際決策並且該段將收到足夠的樣本時才新增有界裝置類。

請勿收集查詢字串、DOM 內容、表單值、cookie、授權資料或不受限制的使用者識別符號。保留閾值版本,因為定義和產品目標可以獨立於程式碼發布而更改。

比較路線和版本

核心 Web Vitals SQL 配方 將 LCP、INP 和 CLS 測量資料集中到每條路線和發布的一行中。它在指標平均值旁邊保留樣本計數和透過樣本百分比,包括確定性輸入行,並且可以在 瀏覽器 SQL 遊樂場 中執行。

按以下順序使用結果:

  1. 確認樣品體積和觀察視窗具有可比性。
  2. 找到透過取樣率最弱的路線併發布。
  3. 檢查發生移動的個人生命體,而不是將摘要視為原因。
  4. 將當前版本與之前的版本進行比較,並驗證完整時間段內的恢復情況。

生產報告通常受益於百分位數和平均值。新增時保留相同的路線、版本、指標和單位合約。

搭建釋放護欄

儀表板應顯示樣本計數、LCP、INP、CLS 和閾值版本。釋放護欄應要求審查最小量和持續迴歸。它不應該因為一個稀疏的裝置或路由段而阻止部署。

前端效能用例 提供儀器提示和檢查清單。使用 瀏覽器遙測代理指南 將 Telemetry API 金鑰保留在伺服器端並強制執行列入白名單的瀏覽器合約。當緩慢的頁面可能源自後端路由或依賴項時,將瀏覽器體驗與 API 可靠性 SQL 配對。

相關產品功能

對結構化事件資料表執行只讀 DataFusion SQL 並重用結果。

內容責任與技術參考

Telemetry 編輯團隊負責維護本文;產品團隊審查功能行為、範例和適用範圍。

檢視編輯規範