17 lines
1.2 KiB
Markdown
17 lines
1.2 KiB
Markdown
# Event Bridge Trace 传播基线
|
|
|
|
- Event Bridge 领取 Inbox 后，仅从事件信封已冻结的 `traceId` 建立投递线程 MDC。
|
|
- 32 位非零十六进制 trace ID 直接沿用；历史规范 UUID 去除连字符后沿用。
|
|
- 其他旧值不满足 W3C Trace ID 约束，投递时安全重建新 trace，但不覆盖或迁移原事件信封。
|
|
- 每次 HTTP 投递生成新的 `X-Request-Id` 和 child span，并统一覆盖 `X-Trace-Id`、`traceparent`。
|
|
- `correlationId`、`eventId`、customer ID、聚合 ID、JWT 和内部服务令牌不得写入 Trace 标准字段。
|
|
- 投递日志在 MDC 和显式 `traceId` 字段中记录本次标准 trace；投递 attempt 仍通过 `event_id`
|
|
关联 `bridge_inbox.trace_id`，本轮不增加数据库字段。
|
|
|
|
## 共享契约缺口
|
|
|
|
当前 `EventEnvelope.traceId` 仍是通用字符串契约，没有强制 32 位 W3C Trace ID；因此历史任意字符串不能
|
|
无损映射为 W3C trace。若后续要求所有事件跨重试、跨语言绝对保持同一标准 trace，必须由
|
|
`common-event-contract` 生产者、消费者和 Event Bridge 共同冻结字段校验后再收敛。本轮没有修改共享
|
|
Payload、信封字段、哈希规则或可靠性状态机。
|