observability

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

type MetricsSnapshot struct {
	ReleasesTotal      int64
	ReleasesSuccessful int64
	ReleasesFailed     int64
	ActiveReleases     int64
	PluginExecutions   int64
	PluginErrors       int64
	CommandInvocations map[string]int64
	Uptime             time.Duration
}

type Span interface {
	// End completes the span.
	End()
	// SetStatus sets the span status.
	SetStatus(status SpanStatus, description string)
	// SetAttribute sets a span attribute.
	SetAttribute(key string, value any)
	// SetAttributes sets multiple span attributes.
	SetAttributes(attrs map[string]any)
	// RecordError records an error on the span.
	RecordError(err error)
	// AddEvent adds an event to the span.
	AddEvent(name string, attrs map[string]any)
	// SpanContext returns the span context for propagation.
	SpanContext() SpanContext
}

type SpanContext struct {
	TraceID string
	SpanID  string
}

type SpanKind int

type SpanOption func(*spanConfig)

type SpanStatus int

type Tracer interface {
	// Start creates a new span and returns it along with a new context.
	Start(ctx context.Context, name string, opts ...SpanOption) (context.Context, Span)
	// Shutdown gracefully shuts down the tracer.
	Shutdown(ctx context.Context) error
}

type TracerConfig struct {
	// Enabled indicates whether tracing is enabled.
	Enabled bool
	// ServiceName is the name of the service for tracing.
	ServiceName string
	// ServiceVersion is the version of the service.
	ServiceVersion string
	// Environment is the deployment environment (dev, staging, prod).
	Environment string
	// Endpoint is the OTLP endpoint URL (e.g., "localhost:4317").
	Endpoint string
	// Insecure disables TLS for the OTLP connection.
	Insecure bool
	// SampleRate is the sampling rate (0.0 to 1.0, default 1.0 = sample all).
	SampleRate float64
	// Headers are additional headers to send with OTLP requests.
	Headers map[string]string
}