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

根據 SLO 衡量 API 可用性

計算每日可用性並顯示服務是否達到其明確的目標。

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

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

問題已回答

每項服務是否達到其每日可用性目標?

SLO 將可靠性率轉變為決策邊界。將良好事件、總體事件和目標放在一起使得合規審查可稽核。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp請求完成時間。
serviceUtf8穩定的服務名稱。
slo_eligibleBoolean請求是否屬於 SLO 分母。
slo_goodBoolean請求是否滿足 SLO。
DataFusion SQL

複製查詢

sql
SELECT
  date_trunc('day', timestamp_utc) AS day,
  service,
  SUM(CASE WHEN slo_eligible THEN 1 ELSE 0 END) AS eligible_requests,
  SUM(CASE WHEN slo_eligible AND slo_good THEN 1 ELSE 0 END)
    AS good_requests,
  100.0 * SUM(CASE WHEN slo_eligible AND slo_good THEN 1 ELSE 0 END)
    / NULLIF(SUM(CASE WHEN slo_eligible THEN 1 ELSE 0 END), 0)
    AS availability_pct,
  99.9 AS objective_pct
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '30 days'
GROUP BY date_trunc('day', timestamp_utc), service
HAVING SUM(CASE WHEN slo_eligible THEN 1 ELSE 0 END) > 0
ORDER BY day, service;

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

查詢結果

每日服務可用性

7 月 26 日,查詢 API 未達到 99.9% 的目標。

dayserviceeligible_requestsgood_requestsavailability_pctobjective_pct
2026-07-25query_api182,400182,27499.9399.9
2026-07-26query_api176,820176,50199.8299.9
2026-07-27ingestion_api248,100247,97699.9599.9

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

Daily service availability:來自 Measure API Availability Against an SLO 範例結果的合成 availability_pct 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1明確的資格可以保護分母免受健康檢查或不受支援的流量的影響。
  2. 2當目標需要正確性和延遲時,slo_good 可以對兩者進行編碼。
  3. 3目標在觀察值旁邊返回,因此圖表和評論保留了決策邊界。

需要決定的邊緣情況

  • 使用完整的時間段進行尋呼和合規性報告。
  • 記錄排除的流量,以便 SLO 無法透過靜默的分母更改來改進。
  • 每日檢視有助於回顧;快速的錯誤預算警示通常需要更短的視窗。

推薦儀表板

  • 趨勢:availability_pct 與目標線
  • 統計:所選時間段內的合規天數
  • 資料表:錯過服務日的不良事件

警示指導

使用多視窗錯誤預算消耗警示進行尋呼,並使用每日檢視進行合規性審查。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰