如何在Go语言中自动为每个函数创建Otel Span？

1. 借助OpenTelemetry官方自动插桩工具 #

如果你的函数是HTTP、gRPC、数据库这类通用组件的调用，直接用OpenTelemetry官方提供的对应instrumentation库就行——这些库会自动给框架层面的调用生成Span，完全不用改业务代码。比如HTTP服务端，只需要初始化时加几行配置，所有请求对应的处理函数都会自动纳入链路追踪。

要是针对自定义业务函数，有两个无侵入选项：

• 用go.opentelemetry.io/otel/instrumentation/go配合编译参数，编译时自动给函数插桩；
• 用基于eBPF的opentelemetry-go-instrumentation工具，运行时通过eBPF注入Span逻辑，全程不用碰业务代码。

2. 编译时代码生成（go generate） #

写个简单的代码生成工具，利用Go的AST语法树解析功能，扫描指定包下的函数，自动给符合条件的函数插入Span代码。步骤大概是：

1. 写一个trace_gen.go，用go/ast遍历目标文件，找到带context.Context参数的函数，在函数开头插入Span创建和defer结束的代码；
2. 在业务代码顶部加//go:generate go run trace_gen.go；
3. 执行go generate，工具自动修改业务代码，生成带Span的版本。

这种方式和手动写代码性能完全一致，只是把重复劳动自动化了。

3. 泛型包装器（Go 1.18+） #

用泛型写个通用包装函数，把业务函数传进去，包装器自动处理Span的生命周期。比如：

// 适配带context.Context和string参数的无返回值函数
func TraceStringFunc(ctx context.Context, opName string, fn func(context.Context, string)) func(context.Context, string) {
    return func(ctx context.Context, username string) {
        span, _ := opentracing.StartSpanFromContext(ctx, opName)
        defer span.Finish()
        fn(ctx, username)
    }
}

业务代码里直接用包装后的函数：

// 原函数不用改，直接包装
var ATestFunction = TraceStringFunc(context.Background(), "ATestFunction", func(ctx context.Context, username string) {
    // do something
})

可以根据自己的函数签名扩展更多包装器，比手动写Span代码省事很多。

4. 反射拦截（适合非性能敏感场景） #

用Go的反射机制，在调用函数时动态创建Span。写个通用调用函数：

func CallWithTrace(ctx context.Context, opName string, fn interface{}, args ...interface{}) {
    span, _ := opentracing.StartSpanFromContext(ctx, opName)
    defer span.Finish()

    fnVal := reflect.ValueOf(fn)
    callArgs := make([]reflect.Value, len(args))
    for i, arg := range args {
        callArgs[i] = reflect.ValueOf(arg)
    }
    fnVal.Call(callArgs)
}

调用时直接用这个函数包裹：

CallWithTrace(ctx, "ATestFunction", ATestFunction, ctx, "test-user")

这种方式不用修改原函数，但反射有一定性能开销，适合对性能要求不高的场景。

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