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

按事件名稱測量 Telemetry 音量

在更改保留或收集策略之前,按有效負載位元組、平均事件大小和拒絕率對事件型別進行排名。

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

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

問題已回答

哪些事件合約創造了最大的攝取量?

僅事件計數就可以隱藏過大的有效負載。此查詢將計數和位元組量保持在一起,使嘈雜或意外大的事件合約可見,而無需假裝有效負載位元組等於供應商賬單。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestampUTC 中的攝取嘗試時間。
event_nameUtf8受控事件名稱。
sourceUtf8有限的生產者或 SDK 源。
payload_bytesInt64傳輸壓縮之前的序列化事件大小。
acceptedBoolean攝取是否接受該事件。
environmentUtf8部署環境。
DataFusion SQL

複製查詢

sql
SELECT
  event_name,
  source,
  COUNT(*) AS events,
  SUM(payload_bytes) AS total_payload_bytes,
  AVG(payload_bytes) AS avg_payload_bytes,
  SUM(CASE WHEN accepted THEN 0 ELSE 1 END) AS rejected_events,
  100.0 * SUM(CASE WHEN accepted THEN 0 ELSE 1 END)
    / NULLIF(COUNT(*), 0) AS rejection_rate_pct
FROM telemetry_ingestion_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY event_name, source
ORDER BY total_payload_bytes DESC, event_name;

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

查詢結果

按事件合約劃分的有效負載量

儘管事件少於頁面檢視,但綜合除錯追蹤具有最大的位元組量。

event_namesourceeventstotal_payload_bytesavg_payload_bytesrejected_eventsrejection_rate_pct
debug_traceworker416,0004,000125
llm_request_completedapi36,0002,00000
page_viewedweb63,000500116.67

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

Payload volume by event contract:來自 Measure Telemetry Volume by Event Name 範例結果的合成 total_payload_bytes 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1總位元組數和平均位元組數可區分高頻事件和超大合約。
  2. 2當多個生產者可以發出相同的事件名稱時,源保持所有權可見。
  3. 3拒絕率將收集更改轉變為資料品質審查,而不是僅花費成本的活動。

需要決定的邊緣情況

  • 序列化有效負載大小不是儲存大小、掃描位元組、網路出口或發票成本。
  • 單獨測量維度基數;一個小事件仍然可以建立昂貴或無法使用的組。
  • 在更改生產保留之前排除合成和開發流量。

推薦儀表板

  • 酒吧:total_payload_bytes by event_name
  • 趨勢:按源劃分的事件計數和位元組數
  • 資料表:平均大小、拒絕率、保留所有者和架構版本

警示指導

就相對於審查基準的持續合約規模或交易量變化發出警示,而不是針對固定的全域性位元組閾值。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰