首页/云/可观测性速查/Baggage:随链路传播的业务上下文

Baggage:随链路传播的业务上下文

Baggage 携带跨服务共享的键值(如租户、灰度标记),随请求一路传递;数据量小、无敏感信息是使用底线。

可观测性速查云更新于 2026-10-12

传播格式与用法

传播格式与用法
# HTTP 头
baggage: tenant=acme,gray=1

# 读取后可作为 span 属性或日志字段,用于统一筛选
# 注意:baggage 对每个下游都可见,不要放敏感数据
典型用途:按租户维度过滤链路、给灰度流量打标;与采样的“按标记强制采样”策略也常组合。

易错点

  • baggage 值过长会抬高每个请求的头开销,控制条目数量与长度
  • 把它当跨服务配置通道会引入隐式耦合,只放观测用途的标记

数据来源与参考

  • W3C Baggage 规范
  • OpenTelemetry 官方文档 · Baggage
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌