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

按版本比較 API 可靠性

比較跨應用程式版本的流量、5xx 速率和 p95 延遲,無需將每個部署後更改都歸因於部署。

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

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

問題已回答

哪些版本會出現更嚴重的 API 錯誤或尾部延遲?

發布標籤將時間相關的事件轉變為可測試的比較。數量、故障和延遲是一體的,因此小金絲雀不會被視為全面部署。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp請求完成時間。
release_versionUtf8應用程式版本或建置識別符號。
status_codeInt64HTTP 回應狀態程式碼。
latency_msFloat64請求持續時間(以毫秒為單位)。
DataFusion SQL

複製查詢

sql
SELECT
  release_version,
  COUNT(*) AS requests,
  100.0 * SUM(CASE WHEN status_code >= 500 THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS error_rate_pct,
  approx_percentile_cont(latency_ms, 0.95) AS p95_latency_ms
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '7 days'
  AND release_version IS NOT NULL
GROUP BY release_version
HAVING COUNT(*) >= 100
ORDER BY error_rate_pct DESC, p95_latency_ms DESC;

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

查詢結果

按版本劃分的 5xx 速率

版本 2026.07.27.2 具有最高的錯誤率和 p95 延遲。

release_versionrequestserror_rate_pctp95_latency_ms
2026.07.27.222,6401.821,180
2026.07.27.118,1100.44620
2026.07.26.439,4000.31590

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

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

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1按版本分組可將重疊的推出流量分開。
  2. 2最小體積規則可以保護與微小金絲雀樣本的比較。
  3. 3將結果視為相關性:在分配原因之前先進行路線、區域、客戶和錯誤型別細分。

需要決定的邊緣情況

  • 沒有發布識別符號的請求無法支援部署分析。
  • 逐步推出需要部署開始時間和流量共享以及這些聚合。
  • 不要比較服務根本不同的路線或沒有細分的客戶群的版本。

推薦儀表板

  • 條形:error_rate_pct(按版本)
  • 分組條:p95 延遲和請求量
  • 資料表:所選版本的錯誤型別

警示指導

當最新版本在速率和最小數量上超過之前的穩定版本時發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰