跳至主要內容
Telemetry
複製貼上儀表範本

事件追蹤計劃範本

建立可審查的事件目錄,涵蓋粒度、所有權、欄位、隱私、保留、驗證和下游 SQL 依賴項。

審閱者 Telemetry產品團隊 . 事件名稱、推薦欄位、分析問題和隱私邊界. 審查標準和所有權

由此解鎖的問題
  • 一行代表什麼,它支援哪一個決定?
  • 哪些欄位是必填欄位、敏感欄位、受限欄位或禁止欄位?
  • 哪些查詢、儀表板、警示和所有者依賴於該合約?
範本證據路徑

Event Tracking Plan Template:實施到決策

將提示視為實施概要。有用的工件不僅僅是複製的程式碼,而是經過審查的事件契約,可以產生值得信賴的答案。

  1. 1

    選擇邊界

    Instrument the point where tracking_plan_reviewed becomes final.

  2. 2

    建立合約

    Start with tracking_plan_reviewed, event_contract_changed, instrumentation_verified and keep every field typed, bounded, and privacy-reviewed.

  3. 3

    執行夾具

    在依賴彙總結果之前,先練習已知的成功、失敗、重試和空結果案例。

  4. 4

    回答問題

    一行代表什麼,它支援哪一個決定?

範本

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

更換 YOUR_API_KEY,在本地執行流程,然後驗證生成的事件和儀表板。

event-tracking-plan

事件追蹤計劃範本

text
在新增 Telemetry 之前,為此程式碼儲存庫建立事件追蹤計劃。

使用 /skill.md 並檢查生產工作流程、現有分析呼叫、測試、部署設定、隱私控制和下游報告。

對於每個提議的活動,記錄:
event_name、事件粒度、業務或運營 decision、owner、精確觸發器、必填欄位、可選欄位、型別和單位、受控值、禁止內容、隱私分類、保留期望、schema_version、下游 SQL 或儀表板以及綜合驗證案例。

識別不明確的重試、重複交付、原始 URL、無限制的字串、個人資料、秘密以及真實來源不明的欄位。在這些邊界得到解決之前,不要新增儀器。

然後實施最小的批准事件集,新增合約和故障路徑測試,驗證非生產環境中的攝取,並建立除了速率之外還計數的 SQL。

將追蹤計劃作為提交的 Markdown 文件返回,並總結仍需要的任何審查決策。不要發明同意、保留、安全或合規政策。

要捕獲的事件

tracking_plan_reviewedevent_contract_changedinstrumentation_verifiedschema_drift_detectedevent_contract_retired

驗證清單

完整的埋點通行證留下了什麼

活動

綜合事件以穩定的名稱和欄位型別到達預期的資料表。

查詢

第一個 SQL 查詢返回具有明確時間視窗的合理行。

意見

儀表板使用真實欄位幷包含足夠的上下文來解釋更改。

安全

檢查提示、正文、憑據、簽名和私人內容是否經過編輯。

事件架構起點

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

相關產品功能

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

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

相關 SQL 查詢範例

用 SQL 回答下一個問題

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

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

更多範本