tracer

type Attribute struct {
	Key   string
	Value any
}

type Carrier interface {
	Get(key string) string
	Set(key, value string)
	Keys() []string
}

type Configuration struct {
	ServiceName string  `required:"true"  envconfig:"SVC_NAME"`
	Type        string  `required:"false" envconfig:"TRACER_TYPE"             default:"otel"`
	Exporter    string  `required:"false" envconfig:"TRACER_EXPORTER"         default:"otlphttp"`
	Endpoint    string  `required:"false" envconfig:"OTEL_EXPORTER_OTLP_ENDPOINT"`
	Insecure    bool    `required:"false" envconfig:"TRACER_INSECURE"         default:"true"`
	SampleRatio float64 `required:"false" envconfig:"TRACER_SAMPLE_RATIO"     default:"1.0"`
	Enabled     bool    `required:"false" envconfig:"TRACER_ENABLED"          default:"true"`
}

type ExporterType string

type MapCarrier map[string]string

type Option func(*config)

type Span interface {
	End()
	SetAttributes(attrs ...Attribute)
	SetStatus(code StatusCode, description string)
	RecordError(err error, attrs ...Attribute)
	AddEvent(name string, attrs ...Attribute)
	SpanContext() SpanContext
	IsRecording() bool
}

type SpanContext struct {
	TraceID    string
	SpanID     string
	TraceFlags byte
	Remote     bool
}

type SpanKind int

type StartConfig struct {
	Kind       SpanKind
	Attributes []Attribute
}

type StartOption func(*StartConfig)

type StatusCode int

type Tracer interface {
	// Start opens a new span as a child of any span already in ctx and returns
	// the derived context plus the span handle. Callers must End() the span.
	Start(ctx context.Context, name string, opts ...StartOption) (context.Context, Span)

	// SpanFromContext returns the span currently recorded in ctx, or a no-op
	// span if none is present.
	SpanFromContext(ctx context.Context) Span

	// Inject writes the current span context into carrier using the configured
	// propagator (defaults to W3C tracecontext + baggage).
	Inject(ctx context.Context, carrier Carrier)

	// Extract reads a span context from carrier and returns a context with it
	// installed as the remote parent.
	Extract(ctx context.Context, carrier Carrier) context.Context

	// Shutdown flushes any buffered spans and releases exporter resources.
	// Safe to call multiple times.
	Shutdown(ctx context.Context) error
}

type TracerType string