跳转到内容
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

将隐私标签视为审核队列

当“假名”标识符与个人相关时,它们仍然可以是个人数据。 “审查”字段可以公开收购或提供者的背景。在生产埋点之前应用您自己的保留、访问、同意、删除、驻留和合同要求。