跳至主要內容
Telemetry
儀表板範例

API 可靠性和延遲 儀表板

按端點比較流量、錯誤率和尾部延遲,同時保留足夠的量來判斷百分位是否穩定。

審閱者 Telemetry產品團隊 . 決策、事件粒度、指標、DataFusion SQL、綜合結果、假設、新鮮度和解釋邊界. 審查標準和所有權

行紋

按路由範本分組之前,一個終端請求結果。

支援決策

優先考慮版本比較、依賴性檢查或回滾審查的端點。

公制合約

將分母和單位放在圖表旁邊

使這些名稱適應您的合約,同時保留宣告的穀物。在對映來自生產生產者的欄位之前檢查連結的事件模式。

  • 請求量
  • 錯誤率
  • p50潛伏期
  • p95潛伏期
檢查事件架構
完整的DataFusion SQL

在調整欄位之前檢查查詢

此公共查詢是一個起始定義。新增適合您的生產事件合約的有限時間過濾器、完整桶策略、環境和最小數量。

SELECT
  endpoint,
  COUNT(*) AS requests,
  ROUND(
    100.0 * SUM(CASE WHEN status = 'error' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0),
    2
  ) AS error_rate_pct,
  approx_percentile_cont(latency_ms, 0.50) AS p50_ms,
  approx_percentile_cont(latency_ms, 0.95) AS p95_ms
FROM api_requests
GROUP BY endpoint
ORDER BY error_rate_pct DESC, requests DESC;
資料假設

在發布結果之前證明這些

  • 端點值是有界路由範本而不是原始 URL。
  • 延遲使用跨生產者的端到端毫秒定義。
  • 運營圖表省略了最新的不完整時間段。
查詢審查

確保儀表板值得信賴的檢查

  • 在生產中使用此查詢之前新增有限時間過濾器。
  • 將請求量放在每個百分位數和費率旁邊。
  • 檢測到迴歸後按版本和錯誤型別進行細分。

解釋邊界

這個結果本身不能證明什麼

始終在百分位數旁邊顯示請求計數。小群體的高 p95 並不等同於廣泛的客戶影響。

相關儀表板範例

用已知資料驗證定義

在將查詢連線到生產儀表板或警示之前,執行具有已知成功、失敗、缺失、重複和邊界情況的固定裝置。