故障事件
事件是指任何对 EvoMap 服务的可用性、可靠性、延迟、正确性或安全态势产生实质影响的非计划性情况。
生命周期
| 阶段 | 含义 |
|---|---|
| Investigating | 团队正在确认影响、范围和可能的原因。 |
| Identified | 受影响的组件或依赖已定位。 |
| Mitigating | 正在实施修复、回滚、流量切换或变通办法。 |
| Monitoring | 服务看起来已恢复，团队正在观察是否复发。 |
| Resolved | 事件已关闭，不再对客户造成影响。 |
| Postmortem | 正在准备或已发布后续总结或更深入的分析。 |
严重级别
| 严重级别 | 客户影响 | 示例 |
|---|---|---|
| P0 | 大面积生产中断或存在数据安全风险。 | 所有客户端的 OAuth 令牌交换不可用；公开 API 持续返回 5xx。 |
| P1 | 关键路径严重降级。 | 大量应用的 webhook 投递延迟；应用审核队列被卡住。 |
| P2 | 影响有限，或存在可靠的变通办法。 | 某一族端点变慢；状态历史陈旧但线上 API 正常。 |
| P3 | 轻微缺陷、文档问题或个别支持个案。 | 文档链接错误；更新日志条目表述不清。 |
公开事件记录
一份公开事件记录应包含：
- 受影响的服务和客户可见的症状。
- 首次发现时间和恢复时间。
- 进展通报的时间线。
- 缓解措施或变通办法（如果有）。
- 最终的解决总结。
- 当值得做更深入的书面分析时，附上复盘链接。
事件记录不应包含客户个人数据、密钥、私密工单、内部日志或未脱敏的请求负载。
计划内维护
计划内维护应列明：
- 计划的开始与结束时间（带时区）。
- 可能受影响的服务。
- API 调用、OAuth 流程、webhook 投递或应用审核是否可能中断。
- 需要客户采取的动作（如果有）。
维护通报应在窗口之前、窗口开始时和窗口完成时发布。
支持工单与事件的关系
支持工单是围绕某个具体开发者、组织、OAuth 客户端、webhook 投递或计费个案的私密对话。事件则是在影响面足够大、需要在状态页上对外沟通时的公开运维记录。
当一个工单反映的是同一个底层平台问题时，它可以被关联到某个事件。工单仍然保持私密；事件记录保持公开且已脱敏。
报告疑似事件
在提交工单之前：
- 查看
/status。 - 查看更新日志，看是否有近期的 API 或行为变更。
- 提交支持工单或发邮件到
[email protected]，附上时间戳、request ID、受影响的端点和观察到的错误码。