Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

telemetry

package

Go to main page

Versions in this module

v1

v1.13.2

Oct 26, 2026

v1.13.1

Oct 25, 2026

v1.13.0

Oct 22, 2026

Changes in this version

+ type LogsInputs struct

+ Code shared.LogsExportConfig

+ File shared.LogsExportConfig

+ Getenv func(string) string

+ UnderTest bool

+ type LogsPipeline struct

+ func NewLogsPipeline(ctx context.Context, s LogsSettings, res *resource.Resource, l logger.Logger) (*LogsPipeline, error)

+ func (p *LogsPipeline) Attach(l logger.Logger) error

+ func (p *LogsPipeline) Flush()

+ func (p *LogsPipeline) Settings() LogsSettings

+ func (p *LogsPipeline) Shutdown(ctx context.Context) error

+ type LogsSettings struct

+ Enabled bool

+ Endpoint string

+ Headers map[string]string

+ Level string

+ Warnings []string

+ func ResolveLogs(in LogsInputs) LogsSettings

v1.12.10

Oct 20, 2026

Changes in this version

type Settings

+ AllowedQueryKeys []string

+ RecordRawPath bool

+ RecordUserAgent bool

v1.12.9

Oct 15, 2026

Changes in this version

+ const LifecycleKey

+ const TemporalityCumulative

+ const TemporalityDelta

+ var ErrInvalidEndpoint = errors.New("telemetry: invalid OTLP endpoint")

+ var ErrTracingDisabled = errors.New("telemetry: tracing is disabled")

+ func BuildResource(ctx context.Context, name, version, environment string, ...) (*resource.Resource, error)

+ func BuildSampler(s Settings) sdktrace.Sampler

+ func Excluded(path string, prefixes []string) bool

+ func HTTPClient() *http.Client

+ func InstrumentTransport(rt http.RoundTripper) http.RoundTripper

+ func NewForgeSampler(inner sdktrace.Sampler, off bool, wants *atomic.Pointer[[]func() bool]) sdktrace.Sampler

+ func NormalizeMethod(m string) (method, original string)

+ func PropagationMiddleware() func(http.Handler) http.Handler

+ func RouteMatchMiddleware(excludePaths []string) func(http.Handler) http.Handler

+ func SamplerOff(s Settings) bool

+ func ServerMiddleware(tp trace.TracerProvider, s Settings) func(http.Handler) http.Handler

+ type Inputs struct

+ Code shared.TracingConfig

+ Environment string

+ File shared.TracingConfig

+ Getenv func(string) string

+ type MetricsInputs struct

+ Code shared.MetricsExportConfig

+ File shared.MetricsExportConfig

+ Getenv func(string) string

+ type MetricsPusher struct

+ func NewMetricsPusher(s MetricsSettings, res *resource.Resource, producer sdkmetric.Producer, ...) (*MetricsPusher, error)

+ func (p *MetricsPusher) Settings() MetricsSettings

+ func (p *MetricsPusher) Shutdown(ctx context.Context) error

+ func (p *MetricsPusher) Start(ctx context.Context) error

+ type MetricsSettings struct

+ Enabled bool

+ Endpoint string

+ Headers map[string]string

+ Interval time.Duration

+ Temporality string

+ Warnings []string

+ func ResolveMetrics(in MetricsInputs) MetricsSettings

+ type Provider struct

+ func NewProvider(ctx context.Context, s Settings, res *resource.Resource, log logger.Logger) (*Provider, error)

+ func (p *Provider) RegisterSpanProcessor(sp sdktrace.SpanProcessor) error

+ func (p *Provider) Resource() *resource.Resource

+ func (p *Provider) Settings() Settings

+ func (p *Provider) Shutdown(ctx context.Context) error

+ func (p *Provider) TracerProvider() trace.TracerProvider

+ type Settings struct

+ Enabled bool

+ Endpoint string

+ ExcludePaths []string

+ Headers map[string]string

+ Propagators []string

+ Resource map[string]string

+ ResponseHeader string

+ SampleRatio float64

+ SamplerName string

+ SpanLabels bool

+ Warnings []string

+ func Resolve(in Inputs) Settings

+ type StatusRecorder struct

+ func NewStatusRecorder(w http.ResponseWriter) *StatusRecorder

+ func (r *StatusRecorder) BytesWritten() int64

+ func (r *StatusRecorder) Flush()

+ func (r *StatusRecorder) Hijack() (net.Conn, *bufio.ReadWriter, error)

+ func (r *StatusRecorder) Status() int

+ func (r *StatusRecorder) Unwrap() http.ResponseWriter

+ func (r *StatusRecorder) Write(b []byte) (int, error)

+ func (r *StatusRecorder) WriteHeader(code int)