Stackdriver Trace无法正确展示Express API的Zipkin追踪，列信息显示异常

我之前碰到过几乎一模一样的问题，这大概率是Zipkin Span的HTTP标签和Stackdriver Trace的字段映射不匹配导致的。Stackdriver对HTTP元数据有特定的字段要求，默认的Zipkin收集器可能没做好对应转换，下面给你几个具体的调整步骤：

1. 修正应用代码里的Span标签设置 #

Stackdriver Trace会把Zipkin标准标签http.method映射到自己的「HTTP Method」列，把http.path（或http.url）映射到「URI」列。你需要检查recorder.js里的Span标签是否正确设置：

• 确保明确设置http.method标签，值为请求的HTTP方法（GET/POST等）
• 确保http.path标签对应请求的URI路径，而不是方法名

举个正确的代码示例：

// recorder.js 中正确的Span标签配置
recorder.recordSpan({
  name: 'user-api-request',
  labels: {
    'http.method': 'POST',
    'http.path': '/api/users/create',
    'http.status_code': '200' // 可选，还能显示状态码
  },
  startTime: Date.now() * 1000, // 注意时间戳单位是微秒
  duration: 250 * 1000 // 耗时也用微秒
});

如果之前的代码把方法名放到了http.path里，或者没设置http.method，就会出现你遇到的显示混乱问题。

2. 调整Zipkin收集器的映射配置（若使用官方桥接器） #

如果你用的是官方的zipkin-stackdriver桥接组件，可能需要自定义字段映射规则，确保HTTP标签被正确关联到Stackdriver的对应字段：

比如在收集器的YAML配置文件中添加以下映射：

zipkin:
  stackdriver:
    span-label-mappings:
      # 将Zipkin的http.method映射到Stackdriver的HTTP_METHOD字段
      http.method: "HTTP_METHOD"
      # 将Zipkin的http.path映射到Stackdriver的HTTP_REQUEST_URL字段
      http.path: "HTTP_REQUEST_URL"

这样收集器会自动把Zipkin的标准标签转换成Stackdriver能识别的字段。

3. 验证Span数据的正确性 #

先通过Zipkin UI确认发送的Span是否有正确的标签：

• 访问Zipkin控制台（默认是http://<收集器地址>:9411）
• 找到对应的Trace，查看Span的Tags部分，确认http.method和http.path存在且值正确

如果Zipkin里的标签就不对，那Stackdriver肯定也会显示错误。你也可以用curl发送测试Span来验证：

curl -X POST http://<收集器地址>:9411/api/v2/spans -H "Content-Type: application/json" -d '[
  {
    "traceId": "test-trace-123",
    "id": "test-span-456",
    "name": "test-http-call",
    "timestamp": '"$(date +%s000000)"',
    "duration": 1500000,
    "tags": {
      "http.method": "GET",
      "http.path": "/test/endpoint"
    }
  }
]'

发送后去Stackdriver Trace查看，如果这条测试Trace显示正常，那就是你的应用代码标签设置有问题。

4. 排查自定义Span处理器 #

如果你的应用里有自定义的Span处理逻辑，比如修改标签的中间件，要检查是否不小心覆盖了http.method或http.path的值，导致映射错误。

如果按照上面的步骤调整后还是有问题，可以把你的recorder.js代码片段或者收集器的配置贴出来，我再帮你精准定位问题。

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