observability

type Counter ¶

type Counter interface {
	Add(ctx context.Context, value int64, fields ...Fields)
}

Counter records monotonically increasing integer values.

type Fields ¶

type Fields map[string]any

Fields is an observability-agnostic key/value hashmap.

func FromPairs(pairs ...any) Fields

func MergeFields(fieldSets ...Fields) Fields

func OptionalFields(fieldSets ...Fields) Fields

type Histogram ¶

type Histogram interface {
	Record(ctx context.Context, value float64, fields ...Fields)
}

Histogram records distribution samples.

type LogEmitter ¶

type LogEmitter interface {
	Emit(ctx context.Context, severity Severity, message string, fields ...Fields)
}

LogEmitter is the contract for a secondary log sink.

type Meter ¶

type Meter interface {
	Counter(name string, options ...MetricOption) Counter
	UpDownCounter(name string, options ...MetricOption) UpDownCounter
	Histogram(name string, options ...MetricOption) Histogram
}

Meter creates and owns metric instruments for app layers.

type MetricOption ¶

type MetricOption struct {
	Description string
	Unit        string
}

MetricOption configures metric instruments.

type NoopLogEmitter ¶

type NoopLogEmitter struct{}

NoopLogEmitter is a no-op implementation of LogEmitter.

func (n NoopLogEmitter) Emit(context.Context, Severity, string, ...Fields)

type NoopMeter ¶

type NoopMeter struct{}

NoopMeter is a no-op implementation of Meter.

func (NoopMeter) Counter(string, ...MetricOption) Counter

func (NoopMeter) Histogram(string, ...MetricOption) Histogram

func (NoopMeter) UpDownCounter(string, ...MetricOption) UpDownCounter

type NoopRuntime ¶

type NoopRuntime struct{}

NoopRuntime is a no-op observability facade.

func (NoopRuntime) LogEmitter() LogEmitter

func (NoopRuntime) Meter() Meter

func (NoopRuntime) Shutdown(context.Context) error

func (NoopRuntime) Tracer() Tracer

type NoopTracer ¶

type NoopTracer struct{}

func (NoopTracer) ExtractHTTP(ctx context.Context, _ http.Header) context.Context

func (NoopTracer) Start(ctx context.Context, _ string, _ string, _ ...Fields) (context.Context, Span)

func (NoopTracer) StartServer(ctx context.Context, _ string, _ string, _ ...Fields) (context.Context, Span)

type Runtime ¶

type Runtime interface {
	LogEmitter() LogEmitter
	Tracer() Tracer
	Meter() Meter
	Shutdown(ctx context.Context) error
}

Runtime is the observability facade exposed to app wiring.

type Severity ¶

type Severity uint8

const (
	SeverityDebug Severity = iota
	SeverityInfo
	SeverityWarn
	SeverityError
)

func (s Severity) String() string

type Span ¶

type Span interface {
	SetAttributes(fields ...Fields)
	Finish(err error, description ...string)
	IDs() (traceID, spanID string, ok bool)
}

Span is an observability-agnostic span contract for app layers.

type Tracer ¶

type Tracer interface {
	Start(ctx context.Context, scope, spanName string, fields ...Fields) (context.Context, Span)
	StartServer(ctx context.Context, scope, spanName string, fields ...Fields) (context.Context, Span)
	ExtractHTTP(ctx context.Context, headers http.Header) context.Context
}

Tracer is injected into app layers to avoid direct OTel dependency.

type UpDownCounter ¶

type UpDownCounter interface {
	Add(ctx context.Context, value int64, fields ...Fields)
}

UpDownCounter records integer values that can increase or decrease.