OpenTelemetry跨gRPC服务链路追踪：Span关联与Trace合并问题

我刚接触OpenTelemetry，搭建了Standard和GeoMap两个gRPC微服务。终端用户请求Standard服务后，该服务会调用GeoMap服务获取信息再返回结果。我已经给两个服务的函数做了链路埋点，也配置了把Trace发送到Jaeger后端。

一开始GeoMap生成的Span根本不是Standard Span的子Span，在Jaeger里完全没关系。后来按建议加了拦截器，Span虽然关联上了，但还是生成两个独立Trace，GeoMap的Span属性也没法在主Trace里查看。现在想实现单条用户请求对应单个Trace，该怎么改代码？

要实现单Trace关联跨服务Span，核心是让gRPC调用自动传递并解析OpenTelemetry的Trace上下文，这需要通过OpenTelemetry的gRPC拦截器来完成，同时修正代码里的上下文传递逻辑。

1. 给gRPC客户端和服务端添加OpenTelemetry拦截器 #

Standard服务（gRPC客户端侧） #

创建gRPC客户端时，必须添加otelgrpc.UnaryClientInterceptor()拦截器，它会自动把当前Span的Trace上下文注入到gRPC请求的Metadata中：

// 在Standard服务的main函数中，创建GeoMap客户端的代码修改如下
conn, err := grpc.Dial(
    "geomap-service:50051", // 替换为你的GeoMap服务地址
    grpc.WithInsecure(),
    grpc.WithUnaryInterceptor(otelgrpc.UnaryClientInterceptor()),
)
if err != nil {
    log.Fatalf("连接GeoMap服务失败: %v", err)
}
defer conn.Close()
geoMapServiceClient = pb.NewGeoMapClient(conn)

GeoMap服务（gRPC服务端侧） #

启动gRPC服务时，添加otelgrpc.UnaryServerInterceptor()拦截器，它会从gRPC请求的Metadata中提取Trace上下文，作为当前Span的父上下文：

// 在GeoMap服务的main函数中，启动gRPC服务的代码修改如下
s := grpc.NewServer(
    grpc.UnaryInterceptor(otelgrpc.UnaryServerInterceptor()),
)
pb.RegisterGeoMapServer(s, &geomapService{})

lis, err := net.Listen("tcp", ":50051")
if err != nil {
    log.Fatalf("监听端口失败: %v", err)
}
log.Println("GeoMap服务启动，监听端口50051")
if err := s.Serve(lis); err != nil {
    log.Fatalf("服务启动失败: %v", err)
}

2. 修正Span创建与上下文传递逻辑 #

Standard服务的GetStandard函数中，你已经传递了newCtx给gRPC调用，这部分是对的，但可以移除无用的span.SpanContext()调用：

func (s *server) GetStandard(ctx context.Context, in *pb.GetStandardRequest) (*pb.GetStandardResponse, error) {
    newCtx, span := otel.Tracer(name).Start(ctx, "GetStandard")
    defer span.End()

    // 必须传递newCtx给gRPC客户端，确保Trace上下文被携带
    countryInfo, err := geoMapServiceClient.GetCountry(newCtx,
        &pb.GetCountryRequest{
            Name: in.Name,
        })

    // ... 你的业务逻辑代码

    return &pb.GetStandardResponse{
        Standard: standard,
    }, nil
}

GeoMap服务的GetCountry函数无需修改，只要服务端拦截器生效，它会自动从传入的ctx中获取父Span的上下文，生成属于同一个Trace的子Span。

3. 确保TracerProvider配置一致 #

两个服务的TracerProvider配置要确保使用相同的Schema（你当前代码里用了semconv.SchemaURL，这部分是对的），且服务名配置正确，这样Jaeger才能正确识别不同服务的Span并关联到同一个Trace。

• 客户端拦截器负责将当前Span的Trace上下文（Trace ID、Span ID等）注入到gRPC请求的Metadata中
• 服务端拦截器负责从Metadata中提取这些上下文信息，作为新Span的父上下文，从而让跨服务的Span属于同一个Trace
• 代码中只需保证传递正确的上下文（newCtx）给gRPC调用，无需手动处理Trace上下文的序列化和传递

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