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

比較功能推出錯誤率

比較一個版本的功能標記部署和控制組之間的請求錯誤和平均延遲。

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

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

問題已回答

功能標誌的推出是否不如其對照群體可靠?

推出決策需要在同一發布邊界上進行類似的控制。此查詢將每個功能標記佇列的請求、錯誤、錯誤率和延遲儲存在一起,因此可以看到小但重要的可靠性迴歸。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp請求完成時間(UTC)。
feature_flagUtf8受控功能標誌名稱。
cohortUtf8推出或控制分配。
releaseUtf8應用程式發布識別符號。
statusUtf8終端成功或失敗狀態。
latency_msInt64端到端請求延遲(以毫秒為單位)。
environmentUtf8部署環境。
DataFusion SQL

複製查詢

sql
SELECT
  feature_flag,
  cohort,
  release,
  COUNT(*) AS requests,
  SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) AS errors,
  100.0 * SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS error_rate_pct,
  AVG(latency_ms) AS avg_latency_ms
FROM feature_rollout_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY feature_flag, cohort, release
ORDER BY error_rate_pct DESC, cohort;

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

查詢結果

按群組劃分的推出錯誤率

綜合推出佇列的失敗率為 20%,而對照組則沒有。

feature_flagcohortreleaserequestserrorserror_rate_pctavg_latency_ms
new-checkoutrolloutapi-885120300
new-checkoutcontrolapi-88500200

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

Rollout error rate by cohort:來自 Compare Feature Rollout Error Rate 範例結果的合成 error_rate_pct 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1功能標誌、佇列和版本使比較可以在推出邊界上重現。
  2. 2錯誤率旁邊的請求量暴露出的比較太小,無法做出自信的決策。
  3. 3延遲仍保持相同的結果,因為部署可以在不增加錯誤的情況下回歸體驗。

需要決定的邊緣情況

  • 分配必須足夠穩定,以便同一帳戶不會在比較視窗內切換群組。
  • 比較同等流量和客戶組合,或透過審查的有界維度對結果進行細分。
  • 使用置信區間和更長的視窗來得出不可逆轉的產品結論。

推薦儀表板

  • 酒吧:error_rate_pct(按群組)
  • 趨勢:請求、錯誤和延遲(按部署百分比)
  • 資料表:按版本和最低樣本狀態劃分的功能標誌

警示指導

僅在部署達到審查的最小量並超過其批准的錯誤或延遲護欄後才暫停或回滾。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

定義源資料

此分析的事件模式

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰