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

比較依賴性 p95 延遲

查詢對請求造成最大尾部延遲的資料庫、API、快取和佇列。

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

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

問題已回答

哪些下游依賴項的尾部延遲和故障率最差?

當依賴計時附加到已完成的工作單元時,慢速路線更容易修復。尾部潛伏期揭示了平均隱藏的間歇性下游壓力。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp依賴呼叫完成時間。
dependency_nameUtf8穩定的邏輯依賴名稱。
operationUtf8規範化操作或路線。
statusUtf8成功、失敗或超時。
latency_msFloat64依賴持續時間(以毫秒為單位)。
DataFusion SQL

複製查詢

sql
SELECT
  dependency_name,
  operation,
  COUNT(*) AS calls,
  approx_percentile_cont(latency_ms, 0.50) AS p50_ms,
  approx_percentile_cont(latency_ms, 0.95) AS p95_ms,
  100.0 * SUM(CASE WHEN status <> 'success' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS failure_rate_pct
FROM dependency_calls
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
GROUP BY dependency_name, operation
HAVING COUNT(*) >= 50
ORDER BY p95_ms DESC
LIMIT 20;

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

查詢結果

依賴 p95 延遲

儘管中位數可以接受,但發票歷史記錄仍存在嚴重的長尾現象。

dependency_nameoperationcallsp50_msp95_msfailure_rate_pct
billing_databaseinvoice_history1,840841,8200.49
search_providerdocument_search6,2201327601.21
redissession_lookup44,1003120.02

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

Dependency p95 latency:來自 Compare Dependency p95 Latency 範例結果的合成 p95_ms 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1按邏輯依賴性和操作進行分組可以使結果具有可操作性。
  2. 2p50 和 p95 之間的差距將持續緩慢的服務與間歇性的尾部行為區分開來。
  3. 3失敗率會阻止快速失敗的依賴關係顯得健康。

需要決定的邊緣情況

  • 避免在操作名稱中使用原始 SQL 文字、完整 URL 或客戶識別符號。
  • 並行依賴呼叫不會線性增加請求持續時間。
  • 如果追蹤已包含此計時,則僅記錄連線結果所需的業務上下文。

推薦儀表板

  • 分組條:按依賴性劃分的 p50_ms 和 p95_ms
  • 趨勢:p95 延遲和故障率
  • 資料表:具有路由、發布和追蹤 ID 的慢速依賴項呼叫

警示指導

當關鍵依賴性超出其 p95 目標並影響最小數量的呼叫時發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰