otel

README

HTTPServer OTel Observability 包

httpserver/observability/otel 提供 OpenTelemetry tracing 中间件，负责请求上下文中的 span 创建与传播。

设计约束

• 不在包内初始化 exporter
• 不修改 httpserver core 的默认行为
• 优先从请求上下文和 Header 中传播 trace 上下文

快速开始

srv.Use(otel.Middleware(otel.Config{
	TracerName: "user-service",
}))

Documentation

Overview

Package otel 提供 HTTP tracing 中间件。

该包只负责 span 创建、上下文传播和错误状态记录，不负责 exporter 或 provider 初始化，后者应由应用装配层显式提供。

Index

• func Middleware(config Config) gin.HandlerFunc
• type Config

Functions

func Middleware

func Middleware(config Config) gin.HandlerFunc

Middleware 创建 tracing 中间件。

Types

type Config

type Config struct {
	TracerProvider  oteltrace.TracerProvider
	TracerName      string
	Propagator      propagation.TextMapPropagator
	SpanNameBuilder func(*gin.Context) string
}

Config 描述 tracing 中间件配置。