Elastic APM服务地图链路显示异常，如何修正Golang-Gateway-Nodejs调用链

问题根源 #

Spring Cloud Gateway在转发请求时直接透传了上游Golang应用的parent.id，未将自身的transaction.id作为下游Nodejs服务的父ID，导致APM无法识别正确的调用链路。

解决方案 #

1. 配置Spring Cloud Gateway的Elastic APM代理 #

确保网关的APM代理正确生成并传递trace上下文：

• 确认引入适配Spring Cloud Gateway版本的Elastic APM Java Agent依赖。
• 在网关配置文件（如application.yml）中添加关键配置：

  elastic.apm:
    service_name: spring-cloud-gateway
    server_urls: http://your-apm-server:8200
    propagation.enabled: true
    capture_headers: traceparent,apm-traceparent
  

  开启propagation.enabled让APM代理自动处理trace头传递，替代手动透传逻辑。

2. 移除网关手动透传trace头的代码 #

如果网关有自定义过滤器或代码手动传递traceparent、apm-traceparent等trace相关HTTP头，直接删除这些逻辑。APM代理会自动将网关自身的transaction.id作为新的parent.id注入到转发给Nodejs服务的请求头中。

3. 验证Golang端的trace传递正确性 #

确保Golang代码中的trace上下文正确注入请求：

• 确认apmhttp.WrapClient正确包装HTTP客户端，req.WithContext(ctx)中的ctx包含有效的APM trace上下文。
• 可打印请求头验证traceparent格式是否符合W3C标准：00-<trace-id>-<golang-transaction-id>-01。

4. 检查Nodejs服务的APM配置 #

确保Nodejs服务的APM代理正确读取上游传递的trace头：

• 确认Nodejs的APM配置中propagateTraceHeaders包含traceparent，且未禁用自动上下文传播。示例配置：

  require('elastic-apm-node').start({
    serviceName: 'nodejs-microservice',
    serverUrl: 'http://your-apm-server:8200',
    propagateTraceHeaders: ['traceparent', 'apm-traceparent']
  });
  

验证结果 #

修复后重新发起请求，各服务的transaction信息应满足：

• Golang应用的transaction.id = Spring Cloud Gateway的parent.id
• Spring Cloud Gateway的transaction.id = Nodejs微服务的parent.id
• 三者的trace.id完全一致

此时Elastic APM服务地图会正确显示链路：Golang应用→Spring Cloud Gateway→Nodejs微服务应用

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