跳至主要內容
Telemetry
資料品質 SQL查詢範例

測量事件攝取新鮮度

查詢停止傳送資料或比發生時間晚得多的事件源。

入門telemetry_events已審查 2026-07-27測試用 阿帕奇 DataFusion 45.2.0

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

問題已回答

哪些生產事件源現在已過時或已延遲?

健康的儀表板可能會變得過時而不顯示錯誤。比較事件時間、接收時間和當前時鐘,將靜默源與延遲傳送區分開。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp當事件發生在生產者中時。
received_atTimestamp當攝取服務接受事件時。
sourceUtf8穩定的生產者或工作流程名稱。
environmentUtf8部署環境。
DataFusion SQL

複製查詢

sql
SELECT
  source,
  MAX(timestamp_utc) AS latest_event_at,
  MAX(received_at) AS latest_received_at,
  date_part('second', now() - MAX(received_at)) / 60.0
    AS minutes_since_receive,
  AVG(date_part('second', received_at - timestamp_utc)) / 60.0
    AS average_delivery_delay_minutes
FROM telemetry_events
WHERE received_at >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY source
ORDER BY minutes_since_receive DESC;

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

查詢結果

自最新收到事件以來的分鐘數

儘管正常的交付延遲很小,但計費同步已過時。

sourcelatest_event_atlatest_received_atminutes_since_receiveaverage_delivery_delay_minutes
billing_sync2026-07-27 12:112026-07-27 12:12481.4
api_gateway2026-07-27 12:592026-07-27 12:5910.1
queue_workers2026-07-27 12:582026-07-27 12:5910.8

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

Minutes since the newest received event:來自 Measure Event Ingestion Freshness 範例結果的合成 minutes_since_receive 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1MAX(received_at) 測量每個源是否仍在傳送資料。
  2. 2received_at 和 timestamp_utc 之間的平均差異測量傳輸延遲與源靜默分開。
  3. 3生產過濾器可防止開發流量使已停止的生產源看起來正常。

需要決定的邊緣情況

  • 每天僅發出一次的源需要與 API 源不同的新鮮度閾值。
  • 生產者時鐘偏差會使交付延遲為負值;監視並糾正時鐘同步。
  • 24 小時回溯無法返回靜默時間超過視窗時間的源。保留預期來源登錄檔以進行缺勤監控。

推薦儀表板

  • 條形圖:minutes_since_receive(按來源)
  • 趨勢:按來源劃分的平均交付延遲
  • 資料表:當前視窗中缺少的預期來源

警示指導

當 minutes_since_receive 超出源計劃加上記錄的寬限期時發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

定義源資料

此分析的事件模式

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰