Files
baiyue-firstleg/event-bridge-service/docs/event-trace-propagation.md
T
2026-08-25 19:07:34 +08:00

1.2 KiB

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、信封字段、哈希规则或可靠性状态机。