为什么全零的 trace-id 或 parent-id 会被直接标记为非法？

根据 W3C Trace Context 规范，trace-id 和 parent-id 全为 0 时表示未初始化或无效上下文，接收端必须将其视为非法并抛弃或重新生成。

traceparent 中使用大写十六进制字符会发生什么？

W3C 规范要求十六进制必须为小写字母。虽然部分解析器兼容大写，但验证器会输出告警以避免跨语言 SDK 互操作异常。

grpc-trace-context-bin 二进制头的标准长度是多少？

标准长度为 25 字节（Base64 编码后为 36 字符），包含 16 字节 trace-id、8 字节 span-id 和 1 字节 trace-flags。

tracestate 列表有哪些数量与格式限制？

tracestate 最多包含 32 个逗号分隔的键值对，单项值不能包含空白、逗号或等号，且总长度需在 256 个可打印字符以内。

baggage 中的特殊字符如何正确传递？

超出标准 baggage-octet 范围的字符（如空格、非 ASCII 字符）必须经过 URI 百分号编码（如空格编码为 %20），无效的 % 序列将被拒绝。

Elysia Tools

导航

Development

OpenTelemetry W3C traceparent / tracestate / baggage 与 OTLP 头传播验证器

按 W3C Trace Context ABNF 校验 traceparent（版本/16 字节 trace-id/8 字节 parent-id/1 字节 trace-flags，全零与 ff 版本拒绝、大写告警）、tracestate（≤32 个成员、simple 与 tenant@system 键、重复键告警）、baggage（百分号编码值 + 不透明属性）；校验 OTLP 导出 Content-Type 与 gRPC grpc-trace-context-bin 的 25 字节二进制上下文往返一致性；并对两个独立 traceparent 做关联 round-trip（trace-id 稳定性 + 随机子 span-id 冲突检查），输出可直接重发的规范化头。

详情

这个工具可以帮你完成什么

traceparent 语法：version(2 HEX)-trace-id(32 小写 HEX)-parent-id(16 小写 HEX)-trace-flags(2 HEX)；头内禁止空白；trace-id/parent-id 不得全零；version ff 保留非法；bit0 = sampled，version-00 接收端忽略其余位。tracestate 为 OWS","OWS 分隔的 key=value 列表（≤32 项），键为 simple（lcalpha 起头）或 system-id@tenant 形式，值不含 =/, 与空白且 ≤256 可打印字符。baggage 首段为 key=value（值限 baggage-octet，越界必须百分号编码，非法 % 序列报错），后续 ;prop 为不透明属性。OTLP：二进制 Protobuf 导出必须 Content-Type: application/x-protobuf（JSON 为 application/json）；gRPC 的 grpc-trace-context-bin = base64(trace-id 16B ‖ span-id 8B ‖ flags 1B)，共 25 字节，并与 traceparent 做 trace-id/span-id 一致性往返。关联 round-trip：同一 trace-id 跨两跳轮换新 span-id（8 字节随机、非零、不与父冲突），trace-id 稳定即两上下文并入同一分布式 trace。

执行

运行这个工具

填写表单、运行工具，并在同一页面查看结果。

案例

与这个工具匹配的案例

继续查看相关工具与专题

traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01 tracestate: congo=t61rcWkgMzE,rojo=00f067aa0ba902b7 baggage: userId=alice;serverNode=DF%2028;isProduction=false transport: grpc contentType: application/x-protobuf grpcTraceContextBin: S/kvNXezTaajzpKdDg5HNgDwZ6oLqQK3AQ== secondTraceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-aabbccddeeff0011-01

OpenTelemetry W3C traceparent / tracestate / baggage 与 OTLP 头传播验证器

这个工具可以帮你完成什么

运行这个工具

与这个工具匹配的案例

继续查看相关工具与专题

详细了解工具的适用范围、支持能力及用户案例。

关键事实

概览

适用场景

使用方式

常见用途

示例

1. 验证 gRPC 传输与二进制上下文传播

2. 检测网关非法注入的追踪头与配置错误

常见问题

OpenTelemetry 示例

分布式追踪示例

无版权MP3音频样本

Web Python 图像处理示例

哈希算法对比器

PKCE Code Verifier 与 Challenge 生成器

RSA 加解密

Data URI 生成器