跳至主要內容
Telemetry
資料庫可靠性 SQL查詢範例

按區域測量資料庫副本的陳舊程度

按區域比較應用程式觀察到的副本重播延遲、陳舊讀取和故障轉移結果。

高階database_replica_read_events已審查 2026-07-28測試用 阿帕奇 DataFusion 45.2.0

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

問題已回答

哪些副本區域正在提供過時或失敗的讀取?

基礎設施複製滯後並不總是等於應用程式可見的陳舊性。讀取事件可以保留選定的副本角色、重播延遲和一致性結果。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp副本讀取完成時間。
regionUtf8應用區域。
replica_roleUtf8主目標、副本目標或故障轉移目標。
replay_lag_msFloat64觀察到或報告的重播延遲。
consistency_outcomeUtf8新鮮的、陳舊的、失敗的或未知的。
operation_nameUtf8受控的應用程式讀取操作。
DataFusion SQL

複製查詢

sql
SELECT
  region,
  replica_role,
  operation_name,
  COUNT(*) AS reads,
  approx_percentile_cont(replay_lag_ms, 0.95) AS p95_replay_lag_ms,
  SUM(CASE WHEN consistency_outcome = 'stale' THEN 1 ELSE 0 END)
    AS stale_reads,
  SUM(CASE WHEN consistency_outcome = 'failed' THEN 1 ELSE 0 END)
    AS failed_reads
FROM database_replica_read_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
GROUP BY region, replica_role, operation_name
ORDER BY stale_reads DESC, p95_replay_lag_ms DESC;

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

查詢結果

副本區域的陳舊讀取

ap-southeast 訂閱讀取具有最高的觀察到的陳舊性和重播滯後尾部。

regionreplica_roleoperation_namereadsp95_replay_lag_msstale_readsfailed_reads
ap-southeastreplicasubscription-status18,4004,82021418
eu-westreplicaproject-list42,100740312

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

Stale reads by replica region:來自 Measure Database Replica Staleness by Region 範例結果的合成 stale_reads 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1副本角色和區域標識讀取路徑。
  2. 2應用程式一致性結果將使用者可見的陳舊性與報告的延遲分開記錄。
  3. 3操作名稱顯示哪些工作流程需要更強的寫後讀行為。

需要決定的邊緣情況

  • 一致性結果需要進行可防禦的應用程式檢查。
  • 重播延遲單位因資料庫和收集器而異。
  • 資料庫本機複製和故障轉移工具仍然是伺服器診斷的來源。

推薦儀表板

  • 酒吧:stale_reads(按地區)
  • 趨勢:p95_replay_lag_ms(按角色)
  • 資料表:按操作讀取失敗

警示指導

當關鍵操作提供的過時或失敗的讀取超出其審查的一致性目標時發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰