跳至主要內容
Telemetry
結構化事件合約目錄

圍繞結果建置的事件模式範例

選擇擁有結果的服務,以正確的粒度發出一個持久事件,並保持識別符號有用,而無需將敏感負載複製到分析中。

審閱者 Telemetry產品團隊 . 事件粒度、所有權、必填欄位、隱私分類、範例負載和相關 SQL. 審查標準和所有權

20

完整的合約

192

記錄欄位

沒有電子郵件、提示、有效負載、權杖或目標 URL

範例識別符號是合成的,隱私分類是您自己審查的起點。

在結果處發出

僅當服務知道最終狀態、持續時間和業務識別符號時才記錄事件。

給穀物命名

每個請求、作業、付款嘗試或持久里程碑一行可防止意外重複計算。

繫結基數和隱私

優先選擇路線範本和穩定的 ID。排除原始 URL、電子郵件、提示、有效負載、憑據和堆疊追蹤。

完整的合約

選擇您的服務擁有的結果

產品生命週期user_signed_up

啟用並保留哪些註冊群體?

具有收購和計劃背景的持久帳戶輸入事件。僅在隱私審查後才保持身分匿名並捕獲營銷歸因。

穀物
每個使用者和帳戶接受一次註冊。
欄位
7 記錄在案
檢視欄位和範例 JSON
產品分析product_milestone_completed

哪些帳戶達到定義啟用的持久時刻?

用於穩定產品結果的通用里程碑信封,例如連線源、執行第一個查詢或發布儀表板。

穀物
每個演員、帳戶和事件都有一個完成的里程碑。
欄位
8 記錄在案
檢視欄位和範例 JSON
API 可靠性api_request_completed

錯誤和緩慢的請求會對客戶產生哪些影響?

使用路由範本而不是原始 URL、有界錯誤類別和在服務邊界測量的延遲的終端請求事件。

穀物
一個已完成的 API 請求。
欄位
10 記錄在案
檢視欄位和範例 JSON
人工智慧運營llm_request_completed

每個成功的人工智慧工作流程的成本是多少?它的效能如何?

具有模型、代幣、延遲、分配成本和工具結果的終端模型呼叫事件,沒有提示或生成的內容。

穀物
一份已完成的模型提供商請求。
欄位
10 記錄在案
檢視欄位和範例 JSON
非同步可靠性background_job_completed

哪些作業失敗、重試、等待或執行緩慢?

終端作業事件,記錄最終結果並嘗試計數一次,避免每次重試一行導致的計數過多。

穀物
每項邏輯工作都有一個最終結果。
欄位
11 記錄在案
檢視欄位和範例 JSON
收入運營invoice_payment_completed

哪些計費金額成功、失敗或恢復?

一種支付結果事件,使提供商識別符號保持匿名並將計費金額與經常性收入定義分開。

穀物
一次終端付款嘗試。
欄位
9 記錄在案
檢視欄位和範例 JSON
整合可靠性webhook_delivery_completed

哪些目的地永久失敗,哪些狀態程式碼重複出現,哪些投遞在重試後恢復?

具有 attempt_count、最終 status_code、response_body_bytes 和有界內容型別的終端傳送日誌事件,但沒有客戶 URL、請求標頭、授權、原始回應正文或負載。

穀物
每個邏輯 Webhook 交付一個終端結果。
欄位
11 記錄在案
檢視欄位和範例 JSON
事件回應incident_impact_observed

事件期間哪些帳戶和工作流程受到影響?

有限影響觀察,將已宣告的事件連線到客戶工作流程,而無需將請求有效負載複製到事件記錄中。

穀物
與已宣佈的事件相關的一項受影響的操作。
欄位
9 記錄在案
檢視欄位和範例 JSON
身分安全authentication_attempt_completed

哪些身分驗證方法、客戶端和風險類別會產生失敗或可疑突發?

具有有限方法、結果和風險欄位的終端登入結果。它故意排除憑據、權杖、原始 IP 地址和自由格式的提供商錯誤。

穀物
一次已完成的身分驗證嘗試。
欄位
8 記錄在案
檢視欄位和範例 JSON
前端可靠性browser_performance_observed

哪些路由、版本和裝置類別降低了使用者可見的效能?

具有命名指標、數值、路由範本和發布上下文的取樣瀏覽器測量。原始 URL、使用者代理和 DOM 內容保留在事件之外。

穀物
一項取樣瀏覽器指標觀察。
欄位
8 記錄在案
檢視欄位和範例 JSON
資料庫可靠性database_operation_completed

哪些操作指紋、版本和資料庫角色緩慢或失敗?

由經過審查的指紋和粗略操作後設資料表示的已完成的資料庫操作。 SQL 文字、繫結值、憑據和客戶記錄被排除在外。

穀物
一項完成了應用程式擁有的資料庫操作。
欄位
9 記錄在案
檢視欄位和範例 JSON
Kubernetes 可靠性kubernetes_workload_observed

哪些工作負載、叢集和版本正在重新啟動、不可用或資源受限?

具有標準化 Kubernetes 座標和聚合狀態的定期工作負載快照。 Pod 日誌、環境變數、秘密名稱和註釋被排除在外。

穀物
每個叢集、名稱空間和時間間隔一個工作負載快照。
欄位
8 記錄在案
檢視欄位和範例 JSON
AI代理操作ai_agent_run_completed

哪些代理版本完成了預期任務、需要切換、迴圈還是失敗?

終端代理執行結果,包含版本化工作流程、工具摘要、成本和審查的任務結果。排除提示、完成、工具參數和檢索的內容。

穀物
每個邏輯代理執行一個最終結果。
欄位
10 記錄在案
檢視欄位和範例 JSON
AI代理安全agent_tool_authorization_decided

允許、拒絕哪些代理工具操作或將其轉交人工批准?

在隨後的代理工具呼叫之前記錄的策略決策。它捕獲有界的工具、風險、決策和策略欄位,同時排除提示、參數、結果、憑證和客戶內容。

穀物
每次邏輯工具呼叫嘗試都會做出一個最終授權決策。
欄位
12 記錄在案
檢視欄位和範例 JSON
功能交付feature_rollout_evaluated

首次推出群體在採用率、可靠性和客戶成果方面有何不同?

版本化的功能分配記錄,使曝光規則可查詢,而無需複製定位表示式或個人屬性。

穀物
每個演員、功能、作業版本和材料變更進行一次有效的功能評估。
欄位
9 記錄在案
檢視欄位和範例 JSON
人工智慧運營agent_tool_call_completed

在代理達到有用結果之前,哪些工具會失敗、重試、迴圈或增加延遲?

用於代理可靠性分析的有界終端工具呼叫事件。將參數和結果保留在專家追蹤系統中,並僅保留批准的類別和相關識別符號。

穀物
在代理執行中完成一次工具呼叫嘗試。
欄位
11 記錄在案
檢視欄位和範例 JSON
人工智慧品質rag_retrieval_evaluated

哪些檢索和提示版本會產生相關上下文和有根據的可接受答案?

版本化的 RAG 評估事件,可將檢索分數、答案審查、延遲和成本分開,而不儲存源文字、提示或生成的答案。

穀物
每個符合條件的查詢、檢索版本、評估器和候選執行一個評估器結果。
欄位
11 記錄在案
檢視欄位和範例 JSON
收入生命週期subscription_changed

有多少經常性收入是新的、擴大的、收縮的、流失的或重新啟用的?

從承諾的計費狀態發出的收入移動事件。儲存規範化的計劃和移動值,而不是發票正文或支付提供商有效負載。

穀物
每個帳戶、訂閱和有效變更的一項承諾經常性收入變動。
欄位
10 記錄在案
檢視欄位和範例 JSON
使用計費usage_meter_recorded

哪些帳戶接近配額,計量使用量是否可以與帳單分類賬進行核對?

包含數量、單位、計量版本和計費週期的冪等使用計量記錄。將原始源有效負載和客戶內容保留在分析事件之外。

穀物
每個冪等性金鑰和計量器有一個可接受的使用增量。
欄位
10 記錄在案
檢視欄位和範例 JSON
資料品質telemetry_delivery_observed

應用程式事件是否完全、及時到達並且沒有重試放大?

應用程式擁有的對遙測交付嘗試的觀察。使用單獨的接收器或有界樣本以避免為每次交付建立遞迴事件。

穀物
每次交付嘗試或交付視窗進行一次取樣或彙總觀察。
欄位
11 記錄在案
檢視欄位和範例 JSON

將隱私標籤視為審查佇列

當“假名”識別符號與個人相關時,它們仍然可以是個人資料。 “審查”欄位可以公開收購或提供者的背景。在生產埋點之前應用您自己的保留、存取、同意、刪除、駐留和合約要求。