88 lines
2.9 KiB
Go
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
|
|
}
|