tracing

Documentation

Overview

Package tracing configures OpenTelemetry provider lifecycle for the API process.

Index

• type Service
  • func New(ctx context.Context, cfg config.TracingConfig, env string) (*Service, error)
  • func NewWithProvider(provider trace.TracerProvider, shutdownFn func(context.Context) error) *Service
  • func (s *Service) Enabled() bool
  • func (s *Service) Shutdown(ctx context.Context) error
  • func (s *Service) Tracer() trace.Tracer

Types

type Service

type Service struct {
	// contains filtered or unexported fields
}

Service owns tracer construction and shutdown for the process.

func New

func New(ctx context.Context, cfg config.TracingConfig, env string) (*Service, error)

New configures OpenTelemetry tracing and installs global providers.

func NewWithProvider

func NewWithProvider(provider trace.TracerProvider, shutdownFn func(context.Context) error) *Service

NewWithProvider wraps an existing tracer provider in Service API.

func (*Service) Enabled

func (s *Service) Enabled() bool

Enabled reports whether tracing is active.

func (*Service) Shutdown

func (s *Service) Shutdown(ctx context.Context) error

Shutdown flushes telemetry and closes exporter resources.

func (*Service) Tracer

func (s *Service) Tracer() trace.Tracer

Tracer returns the HTTP tracer used by middleware and handlers.