合同证据路径
incident_impact_observed:从拥有边界到可信查询
将 incident_impact_observed 视为持久的分析合约:所有者发出一个记录的谷物,一个固定装置证明字段,并且经过审查的查询回答所述问题。
- 1
结果成为最终结果
Affected service or incident enrichment pipeline emits only when an operation falls inside a confirmed impact rule.
- 2
合同是有约束力的
9 required fields preserve the declared grain: One affected operation associated with a declared incident.
- 3
夹具已验证
检查类型、UTC 时间、替代结果、幂等性以及每个假名或评论分类字段。
- 4
问题得到解答
事件期间哪些帐户和工作流程受到影响?
谷物
与已宣布的事件相关的一项受影响的操作。
业主
受影响的服务或事件丰富管道
何时发出
当操作属于已确认的影响规则时。
现场合同
具有明确隐私边界的类型化字段
在生产查询依赖现有字段名称和类型后,保持现有字段名称和类型稳定。可选上下文应受到特定决策的限制、记录和证明。
| 字段 | 类型 | 必填 | 隐私 | 含义 |
|---|---|---|---|---|
| timestamp_utc | timestamp | yes | non-sensitive | 结果边界处的 UTC 时间。 |
| event_id | string | yes | non-sensitive | 用于重复数据删除的稳定唯一标识符。 |
| release | string | yes | non-sensitive | 发出事件的应用程序或服务版本。 |
| account_id | string | yes | pseudonymous | 稳定的内部帐户标识符,绝不是电子邮件或姓名。 |
| incident_id | string | yes | non-sensitive | 稳定声明的事件标识符。 |
| service | string | yes | non-sensitive | 受影响的服务。 |
| workflow | string | yes | non-sensitive | 影响客户工作流程。 |
| region | string | yes | non-sensitive | 影响分组的粗略区域。 |
| impact_type | string | yes | non-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 密钥、发送合成事件并在连接实时工作流程之前检查推断表。