Go中设置OpenTelemetry Span服务名无效，求解决方案

你遇到的核心问题是对OpenTelemetry中**服务名（service.name）**的定义和作用范围理解有误：

• service.name是资源属性（Resource Attribute），属于TracerProvider的全局配置，而非单个Span的可修改属性；
• Span的名称（SetName修改的内容）用于标识具体操作（如HTTP接口、方法调用），和服务名是完全不同的概念；
• 上游服务传入的Span的服务名由上游服务初始化时的Resource配置决定，下游无法修改。

正确解决方案分两种场景： #

场景1：让当前服务创建的Span关联api2服务名

如果需要让当前服务生成的所有Span都显示为api2服务，需在初始化TracerProvider时配置对应的Resource：

import (
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/sdk/resource"
    sdktrace "go.opentelemetry.io/otel/sdk/trace"
    semconv "go.opentelemetry.io/otel/semconv/v1.21.0"
)

func initTracer() {
    // 合并默认资源与自定义服务名资源
    res, err := resource.Merge(
        resource.Default(),
        resource.NewWithAttributes(
            semconv.SchemaURL,
            semconv.ServiceNameKey.String("api2"),
        ),
    )
    if err != nil {
        panic(err)
    }

    tp := sdktrace.NewTracerProvider(
        sdktrace.WithResource(res),
        // 按需添加采样器、导出器等其他配置
    )
    otel.SetTracerProvider(tp)
}

后续通过全局Tracer创建的所有Span都会关联api2服务名。

如果仅需单个Span使用不同服务名（不推荐，服务名应代表当前服务身份），可创建带有独立Resource的Tracer：

import (
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/attribute"
    "go.opentelemetry.io/otel/sdk/resource"
    semconv "go.opentelemetry.io/otel/semconv/v1.21.0"
)

// 创建带有api2资源的专属Tracer
api2Tracer := otel.Tracer("api2-tracer", trace.WithResource(
    resource.NewWithAttributes(
        semconv.SchemaURL,
        semconv.ServiceNameKey.String("api2"),
    ),
))

// 使用该Tracer创建Span
_, span := api2Tracer.Start(r.Context(), "http://api2:8001/monitoring")
defer span.End()

场景2：标记对下游api2服务的调用

如果你的真实需求是追踪当前服务对api2的调用，无需修改自身服务名，只需给Span添加peer.service属性标记下游服务：

import semconv "go.opentelemetry.io/otel/semconv/v1.21.0"

_, span := tracer.Start(r.Context(), "call api2 /monitoring")
// 标记下游服务名
span.SetAttributes(semconv.PeerServiceKey.String("api2"))
// 发起对api2的请求逻辑
defer span.End()

这样在Grafana Trace视图中，会清晰展示当前服务（api）调用了下游服务（api2）的关系。

为什么之前的方法无效： #

1. 第一种方法：span.SetAttributes(attribute.String("service.name", "api2"))只是给Span添加了一个普通自定义属性，而Grafana遵循OpenTelemetry规范，从Resource而非Span属性中读取service.name；
2. 第二种方法：span.SetName("api2")修改的是Span的操作名称，和服务名无关联，Span名称应描述具体操作而非服务身份。

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