跳至主要內容
Telemetry
對於資料和平臺團隊來說,在儀表板和警示依賴事件契約之前驗證事件契約

Telemetry 使用 SQL 進行資料品質監控

監視事件新鮮度、必填欄位、型別、重複項、架構版本和數量,以便在損壞的埋點成為誤導性業務或可靠性指標之前發現它。

審閱者 Telemetry產品團隊 . 事件契約、推薦分析和隱私邊界. 審查標準和所有權

為什麼這有效
  • 使用已知的固定裝置測試事件粒度和所需欄位,而不是將成功的攝取視為正確性。
  • 分別追蹤新鮮度、遲到、重複識別符號、模式版本採用和意外的數量變化。
  • 將所有者和合約版本附加到重要的事件資料表,以便故障有明確的修復路徑。
用例證據路徑

Telemetry Data Quality Monitoring with SQL:從實施到決策

完整的 telemetry data quality monitoring with sql 測量迴圈連線一個擁有的工作流程、一個有界事件契約、一個受控裝置和一個有人可以採取行動的問題。

  1. 1

    設定邊界

    盤點支援面向客戶、收入、可靠性或合規性決策的事件資料表。

  2. 2

    捕捉結果

    Begin with event_contract_checked, ingestion_freshness_sampled, duplicate_event_observed and document the grain of each event.

  3. 3

    證明行數

    僅在所有者檢查閾值、排除和預期恢復行為後才發布品質查詢和警示。

  4. 4

    做出決定

    哪些關鍵事件流過時、不完整、重複或型別發生變化?

範圍和鄰近用例

選擇此頁面以獲得正確的測量邊界

  • 使用此頁面來驗證遙測本身:新鮮度、必填欄位、型別、重複項、版本和數量。
  • 當源事件可信且應用程式工作流程可能出現故障時,請使用操作監控頁面。
  • 使用事件追蹤計劃範本來獲取簡明的實施簡介;本指南涵蓋了正在進行的品質控制計劃。

代理提示

將其貼上到您的編碼代理中

更換 YOUR_API_KEY 註冊後,然後要求代理執行產品流程並驗證第一個事件。

代理提示

Telemetry Data Quality Monitoring with SQL 設定提示

text
使用 Telemetry 新增遙測資料品質監控。

使用 /skill.md 和此 Telemetry API 金鑰:YOUR_API_KEY

對於每個 decision 關鍵事件資料表,記錄事件粒度、owner、必填欄位、欄位型別、時間戳 unit、允許值、schema_version、重複鍵、預期到達延遲和預期每日交易量範圍。

為有效事件、缺少必填欄位、重複事件 ID、遲到和不相容的欄位型別建立確定性固定裝置。建置 SQL,以獲取新鮮度、必填欄位空率、重複事件率、架構版本採用率、延遲到達率以及按事件名稱和發布的數量變化。

僅針對具有最小樣本量和所有者的持續違規行為新增警示。包括從每個警示到合約和驗證查詢的連結。

請勿將生產負載、憑證、個人資料或不受限制的錯誤文字放置在品質測試事件中。

設定步驟

  1. 1盤點支援面向客戶、收入、可靠性或合規性決策的事件資料表。
  2. 2為每個合約定義粒度、必填欄位、型別、單位、允許值、延遲和重複策略。
  3. 3傳送有效、缺失、重複、延遲和不相容事件的確定性賽程。
  4. 4僅在所有者檢查閾值、排除和預期恢復行為後才發布品質查詢和警示。

要捕獲的事件

event_contract_checkedingestion_freshness_sampledduplicate_event_observedschema_version_observedevent_volume_sampled

問題已解鎖

  • 哪些關鍵事件流過時、不完整、重複或型別發生變化?
  • 當前流量使用批准的架構版本的百分比是多少?
  • 在儀表板更改之前,版本是否更改了事件量或必填欄位的完整性?

事件架構起點

在將查詢或程式碼片段適應生產之前,請檢查行粒度、發出邊界、所需型別、隱私類、範例有效負載和驗證清單。

相關產品功能

繼續此工作流程 結構化事件

捕獲穩定的事件名稱、鍵入的欄位和經過隱私審查的操作上下文。

相關 SQL 查詢範例

用 SQL 回答下一個問題

針對此工作流程中的結構化欄位執行查詢,檢查範例結果,並將有用的答案轉換為儀表板或警示。

瀏覽所有查詢範例
完整系列資料品質 SQL

客戶案例

客戶描述的相關工作流程

下一步

建立您的代理將使用的 API 金鑰

免費計劃足以執行提示、傳送測試事件和檢視第一個儀表板。

相關頁面