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

observability

package

Go to main page

Versions in this module

v0

v0.26.0

Jun 25, 2026

v0.25.0

Jun 25, 2026

Changes in this version

+ func MetricsHandler(reg *Registry) http.Handler

+ func Middleware(tracer Tracer, reg *Registry, opts ...HTTPOption) func(http.Handler) http.Handler

+ func NewRoundTripper(base http.RoundTripper, tracer Tracer, reg *Registry, opts ...HTTPOption) http.RoundTripper

+ type HTTPOption func(*httpOptions)

+ func WithBuckets(buckets []float64) HTTPOption

+ func WithMetricNames(requestsTotal, requestDuration, inFlight string) HTTPOption

+ func WithSpanName(name string) HTTPOption

+ func WithTraceResponseHeader(name string) HTTPOption

+ type Provider struct

+ func NewProvider(tracer Tracer, reg *Registry) *Provider

+ func (p *Provider) MetricsHandler() http.Handler

+ func (p *Provider) Middleware(opts ...HTTPOption) func(http.Handler) http.Handler

+ func (p *Provider) Registry() *Registry

+ func (p *Provider) RoundTripper(base http.RoundTripper, opts ...HTTPOption) http.RoundTripper

+ func (p *Provider) Tracer() Tracer

v0.24.0

Jun 24, 2026

Changes in this version

+ var DefaultBuckets = []float64

+ func ContextWithSpanContext(ctx context.Context, sc SpanContext) context.Context

+ func FormatTraceparent(sc SpanContext) string

+ func InjectHTTP(h http.Header, sc SpanContext)

+ type Counter interface

+ Add func(v float64)

+ Inc func()

+ Value func() float64

+ type Gauge interface

+ Add func(v float64)

+ Dec func()

+ Inc func()

+ Set func(v float64)

+ Value func() float64

+ type Histogram interface

+ Observe func(v float64)

+ Snapshot func() HistogramSnapshot

+ type HistogramSnapshot struct

+ Buckets []float64

+ Count uint64

+ Counts []uint64

+ Sum float64

+ type Meter interface

+ Counter func(name string, labels ...string) Counter

+ Gauge func(name string, labels ...string) Gauge

+ Histogram func(name string, buckets []float64, labels ...string) Histogram

+ type Recorder interface

+ Spans func() []SpanRecord

+ type Registry struct

+ func NewRegistry() *Registry

+ func (r *Registry) Counter(name string, labels ...string) Counter

+ func (r *Registry) Gauge(name string, labels ...string) Gauge

+ func (r *Registry) Histogram(name string, buckets []float64, labels ...string) Histogram

+ type Span interface

+ Context func() SpanContext

+ End func()

+ RecordError func(err error) Span

+ SetAttr func(key string, value any) Span

+ SetStatus func(status SpanStatus, desc string) Span

+ type SpanContext struct

+ ParentID string

+ Sampled bool

+ SpanID string

+ TraceID string

+ func ExtractHTTP(h http.Header) (SpanContext, bool)

+ func ParseTraceparent(value string) (SpanContext, bool)

+ func SpanContextFromContext(ctx context.Context) (SpanContext, bool)

+ func (sc SpanContext) Valid() bool

+ type SpanRecord struct

+ Attrs map[string]any

+ Context SpanContext

+ Duration time.Duration

+ End time.Time

+ Err string

+ Name string

+ Start time.Time

+ Status SpanStatus

+ StatusMsg string

+ type SpanStatus int

+ const StatusError

+ const StatusOK

+ const StatusUnset

+ func (s SpanStatus) String() string

+ type Tracer interface

+ Start func(ctx context.Context, name string) (context.Context, Span)

+ func NewTracer(opts ...TracerOption) Tracer

+ type TracerOption func(*defaultTracer)

+ func WithRingCapacity(n int) TracerOption

+ func WithSpanLogger(l *slog.Logger) TracerOption