跳转到内容
Telemetry
事件响应

incident_impact_observed 事件图式

有限影响观察,将已声明的事件连接到客户工作流程,而无需将请求有效负载复制到事件记录中。

审阅者 Telemetry产品团队 . 事件粒度、所有权、字段类型、隐私分类、示例有效负载和验证. 审查标准和所有权

问题本合同的答案

事件期间哪些帐户和工作流程受到影响?

字段
9
必填
9
合同证据路径

incident_impact_observed:从拥有边界到可信查询

将 incident_impact_observed 视为持久的分析合约:所有者发出一个记录的谷物,一个固定装置证明字段,并且经过审查的查询回答所述问题。

  1. 1

    结果成为最终结果

    Affected service or incident enrichment pipeline emits only when an operation falls inside a confirmed impact rule.

  2. 2

    合同是有约束力的

    9 required fields preserve the declared grain: One affected operation associated with a declared incident.

  3. 3

    夹具已验证

    检查类型、UTC 时间、替代结果、幂等性以及每个假名或评论分类字段。

  4. 4

    问题得到解答

    事件期间哪些帐户和工作流程受到影响?

谷物

与已宣布的事件相关的一项受影响的操作。

业主

受影响的服务或事件丰富管道

何时发出

当操作属于已确认的影响规则时。

现场合同

具有明确隐私边界的类型化字段

在生产查询依赖现有字段名称和类型后,保持现有字段名称和类型稳定。可选上下文应受到特定决策的限制、记录和证明。

字段类型必填隐私含义
timestamp_utctimestampyesnon-sensitive结果边界处的 UTC 时间。
event_idstringyesnon-sensitive用于重复数据删除的稳定唯一标识符。
releasestringyesnon-sensitive发出事件的应用程序或服务版本。
account_idstringyespseudonymous稳定的内部帐户标识符,绝不是电子邮件或姓名。
incident_idstringyesnon-sensitive稳定声明的事件标识符。
servicestringyesnon-sensitive受影响的服务。
workflowstringyesnon-sensitive影响客户工作流程。
regionstringyesnon-sensitive影响分组的粗略区域。
impact_typestringyesnon-sensitive低基数症状,例如超时或延迟增加。

合成 JSON 事件

{
  "timestamp_utc": "2026-07-28T14:31:40Z",
  "event_id": "evt_impact_01",
  "account_id": "acct_8f31",
  "release": "2026.07.2",
  "incident_id": "inc_checkout_latency",
  "service": "checkout",
  "workflow": "subscription_upgrade",
  "region": "north_america",
  "impact_type": "upstream_timeout"
}

隐私审查

摄取前检查标识符

此示例使用合成标识符。假名值仍然可以是个人数据,并且审核字段可以公开业务或提供商上下文。应用您自己的同意、保留、访问、居住和删除要求。

  • account_id: pseudonymous

验证清单

在构建仪表板之前证明合同

  • Send one known incident_impact_observed fixture after the documented outcome boundary.
  • Verify all 9 required fields arrive with the documented types.
  • 重试相同的事件标识符并确认所选的重复数据删除行为。
  • 当工作流支持时,发送受控失败或替代结果。
  • 在固定窗口上运行相关 SQL 并将结果与固定装置进行协调。

常见错误

保持一行等于一个持久结果

  • Emitting incident_impact_observed before affected service or incident enrichment pipeline knows the final outcome.
  • 在一张表中混合多种谷物,这使得计数和比率不明确。
  • 用原始 URL、有效负载、提示或错误文本替换受控类别。
  • 保存查询和仪表板依赖于它后就地更改字段类型。
  • 添加标识符,无需记录调查、访问和保留需求。

使用合同

查询并操作事件

相关合同

在生产流量之前发送夹具

创建免费的 API 密钥、发送合成事件并在连接实时工作流程之前检查推断表。

测试这个模式