Istio集成Jaeger追踪NodeJS服务时单条Trace的Span不超2个如何解决

问题根因 #

你之前的操作存在两个核心错误：

• 自行接入jaeger-client初始化新的链路是多余操作，Istio的Envoy Sidecar会自动生成、上报追踪Span，无需业务服务自行上报数据
• 没有正确透传Istio要求的链路追踪请求头，导致不同服务的Sidecar生成的Span无法关联到同一个Trace下

修复步骤 #

1. 删除所有自行接入jaeger-client的代码
   你编写的Tracer初始化、自定义Span生成的代码全部需要移除，自行初始化的Tracer会生成和Istio链路不匹配的Trace ID，反而会导致Span关联失败。

2. 添加Istio追踪头透传逻辑
   业务服务只需要在跨服务调用时，将上游请求携带的指定链路头原封不动传递给下游即可，需要透传的头列表如下：

x-request-id
x-b3-traceid
x-b3-spanid
x-b3-parentspanid
x-b3-sampled
x-b3-flags
x-ot-span-context
traceparent
tracestate

NodeJS服务透传示例（以axios调用下游服务为例）：

const axios = require('axios');
const express = require('express');
const app = express();

const ISTIO_TRACING_HEADERS = [
  'x-request-id',
  'x-b3-traceid',
  'x-b3-spanid',
  'x-b3-parentspanid',
  'x-b3-sampled',
  'x-b3-flags',
  'x-ot-span-context',
  'traceparent',
  'tracestate'
];

app.get('/your/api/path', async (req, res) => {
  // 提取上游请求中的所有追踪头
  const headersToForward = {};
  ISTIO_TRACING_HEADERS.forEach(header => {
    if (req.headers[header]) headersToForward[header] = req.headers[header];
  });

  // 调用下游服务时携带追踪头
  const downstreamRes = await axios.get('http://service-b/downstream/api', {
    headers: headersToForward
  });

  res.send(downstreamRes.data);
});

所有服务（A、B、C）都需要添加上述透传逻辑。

3. 验证Istio配置正确性
   执行以下命令确认Istio采样率配置为100%（测试环境建议开启）：

kubectl get istiooperator installed-state -n istio-system -o jsonpath='{.spec.meshConfig.tracing.sampling}'

如果返回值不是100，需要修改Istio配置将采样率调整为100，避免部分Trace未被采集。
同时确认所有跨服务调用都使用K8s内部服务名访问，确保流量经过Envoy Sidecar代理。

效果验证 #

修改完成后重新发起请求，Jaeger仪表盘就会显示完整的A->B->C链路，Span数量会包含所有服务的入站、出站Sidecar的Span，符合预期。

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