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

按路由和發布對 JavaScript 錯誤進行排名

查詢 JavaScript 故障和受影響會話最重複的前端版本和路由。

入門frontend_error_events已審查 2026-07-28測試用 阿帕奇 DataFusion 45.2.0

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

問題已回答

哪個路由和前端版本會產生最廣泛的 JavaScript 錯誤影響?

當瀏覽器錯誤保留穩定的指紋、路由範本、版本和隱私安全會話識別符號時,它就變得可操作。此查詢對重複的失敗進行排名,而不對原始堆疊追蹤進行分組。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp瀏覽器錯誤時間(UTC)。
route_templateUtf8沒有識別符號的穩定客戶端路由。
releaseUtf8前端建置或發布識別符號。
error_fingerprintUtf8標準化錯誤類別和幀簽名。
session_idUtf8隱私安全的會話識別符號。
environmentUtf8部署環境。
DataFusion SQL

複製查詢

sql
SELECT
  route_template,
  release,
  error_fingerprint,
  COUNT(*) AS errors,
  COUNT(DISTINCT session_id) AS affected_sessions
FROM frontend_error_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY route_template, release, error_fingerprint
ORDER BY affected_sessions DESC, errors DESC
LIMIT 20;

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

查詢結果

前端錯誤影響的會話

結帳渲染錯誤具有最廣泛的會話影響和最高的重複量。

route_templatereleaseerror_fingerprinterrorsaffected_sessions
/checkoutweb-103payment-form-render184121
/projects/:idweb-103editor-state-null9674
/searchweb-102result-card-image5851

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

Affected sessions by frontend error:來自 Rank JavaScript Errors by Route and Release 範例結果的合成 affected_sessions 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1路由範本和規範化指紋可防止 URL 和堆疊行詳細資訊因一次故障而碎片化。
  2. 2不同的會話會根據一個損壞的瀏覽器會話中的重複錯誤來單獨估計爆炸半徑。
  3. 3發布分組使迴歸可見,而無需假設最新版本導致每個當前錯誤。

需要決定的邊緣情況

  • 不要在瀏覽器錯誤事件中傳送原始頁面內容、表單值、存取權杖或完整 URL。
  • 源對映和指紋更改可以在各個版本之間拆分相同的缺陷。
  • 如果隨著時間的推移對計數進行比較,抽樣必須保留記錄的比率。

推薦儀表板

  • 條:affected_sessions(錯誤指紋)
  • 趨勢:按版本劃分的錯誤
  • 資料表:安全瀏覽器上下文的最新錯誤

警示指導

當新指紋影響發布後經過審查的生產會話數量時發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰