observability

type Collector interface {
	// RecordDuration records the duration of an operation.
	RecordDuration(operation string, duration time.Duration, labels map[string]string)

	// RecordCount records the count of an operation (success/failure).
	RecordCount(operation string, status string, labels map[string]string)

	// RecordValue records a custom metric value.
	RecordValue(metricName string, value float64, labels map[string]string)
}

type Span interface {
	// SetTag sets a tag on the span.
	SetTag(key string, value interface{})

	// LogEvent logs an event within the span.
	LogEvent(eventName string, fields map[string]interface{})

	// End ends the span.
	End()
}

type Tracer interface {
	// StartSpan starts a new span/tracing context.
	StartSpan(ctx context.Context, operationName string) (context.Context, Span)

	// GetSpan retrieves the current span from context.
	GetSpan(ctx context.Context) Span
}