Files

88 lines
2.9 KiB
Go

package middleware
import (
"context"
"fmt"
"time"
"github.com/gin-gonic/gin"
"go.opentelemetry.io/otel"
"go.opentelemetry.io/otel/attribute"
"go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp"
"go.opentelemetry.io/otel/propagation"
sdkresource "go.opentelemetry.io/otel/sdk/resource"
sdktrace "go.opentelemetry.io/otel/sdk/trace"
"go.opentelemetry.io/otel/semconv/v1.26.0"
oteltrace "go.opentelemetry.io/otel/trace"
)
// InitTracer 初始化 OpenTelemetry:OTLP/HTTP 上报(Jaeger 兼容)。
// endpoint 形如 "127.0.0.1:4318"(OTLP HTTP 接收端口,不带 scheme)。
// 返回 shutdown 供进程退出时刷盘。
func InitTracer(ctx context.Context, endpoint, serviceName string) (func(context.Context) error, error) {
exporter, err := otlptracehttp.New(ctx,
otlptracehttp.WithEndpoint(endpoint),
otlptracehttp.WithInsecure(),
)
if err != nil {
return nil, fmt.Errorf("middleware: 创建 OTLP exporter 失败: %w", err)
}
res, _ := sdkresource.Merge(
sdkresource.Default(),
sdkresource.NewWithAttributes(semconv.SchemaURL,
semconv.ServiceName(serviceName),
),
)
tp := sdktrace.NewTracerProvider(
sdktrace.WithBatcher(exporter), // 后台批量上报,不阻塞请求
sdktrace.WithResource(res),
)
otel.SetTracerProvider(tp)
otel.SetTextMapPropagator(propagation.NewCompositeTextMapPropagator(
propagation.TraceContext{}, // W3C traceparent(与现有 trace_id 头兼容层在 Logger 中处理)
propagation.Baggage{},
))
return tp.Shutdown, nil
}
// Tracer Gin 链路追踪中间件(自研,替代 otelgin):
// 每请求一个 span,记录方法/路径/状态/耗时,并从 traceparent 头续接上游链路。
func Tracer(serviceName string) gin.HandlerFunc {
tracer := otel.GetTracerProvider().Tracer("go-sms/gin")
propagator := otel.GetTextMapPropagator()
return func(c *gin.Context) {
ctx := propagator.Extract(c.Request.Context(), propagation.HeaderCarrier(c.Request.Header))
ctx, span := tracer.Start(ctx, spanName(c))
defer span.End()
c.Request = c.Request.WithContext(ctx)
start := time.Now()
c.Next()
span.SetAttributes(
attribute.String("http.method", c.Request.Method),
attribute.String("http.route", c.FullPath()),
attribute.String("http.target", c.Request.URL.Path),
attribute.Int("http.status_code", c.Writer.Status()),
attribute.Int64("http.duration_ms", time.Since(start).Milliseconds()),
attribute.String("net.peer.ip", c.ClientIP()),
)
if len(c.Errors) > 0 {
span.SetAttributes(attribute.String("gin.errors", c.Errors.String()))
}
// 回写 traceparent,便于响应侧关联
if sc := oteltrace.SpanContextFromContext(ctx); sc.IsValid() {
c.Header("Traceparent", fmt.Sprintf("00-%s-%s-01", sc.TraceID(), sc.SpanID()))
}
}
}
// spanName 生成 span 名称(method + 命中路由)。
func spanName(c *gin.Context) string {
if p := c.FullPath(); p != "" {
return c.Request.Method + " " + p
}
return c.Request.Method + " " + c.Request.URL.Path
}