OpenTelemetry Collector快速启动后debug/tracez未显示预期Span

问题详情 #

• 完成OpenTelemetry Collector快速启动流程1-5步后，输出文件中成功生成lets-go和okey-dokey两个Span
• 访问http://localhost:55679/debug/tracez时，页面未显示这两个Span的名称，也未匹配到对应的Span计数
• 附页面截图：tracez页面无目标Span截图
• 预期结果：tracez页面列表中应显示这两个Span的名称及对应计数

排查与修复步骤 #

1. 确认Collector配置正确加载zpages扩展 #

检查Collector配置文件（默认otel-collector-config.yaml），确保包含以下配置：

extensions:
  zpages: {}

service:
  extensions: [zpages]
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [logging]

启动Collector时必须指定该配置文件：

./otelcol-contrib --config otel-collector-config.yaml

查看启动日志，确认zpages扩展已初始化，且tracez端点0.0.0.0:55679/debug/tracez已注册。

2. 验证Span数据已正确发送到Collector #

检查Collector的日志输出，确认存在包含lets-go和okey-dokey的Span记录，且无发送失败的错误日志（如连接拒绝、格式错误等）。

3. 检查tracez页面的显示逻辑 #

• 强制刷新页面（Ctrl+F5），避免浏览器缓存旧数据
• 使用浏览器页面搜索功能（Ctrl+F）直接查找lets-go或okey-dokey，确认未被页面滚动隐藏
• 确认访问的localhost:55679是当前运行Collector的实例端口，无端口冲突或代理干扰

4. 升级Collector到最新稳定版 #

旧版本Collector可能存在tracez展示Span名称的兼容性问题，下载并使用最新版otelcol-contrib重新测试。

内容的提问来源于stack exchange，提问作者Dan Debrunner