observability

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

type Logger interface {
	// Info logs an info message
	Info(ctx context.Context, message string, fields map[string]interface{})
	// Error logs an error message
	Error(ctx context.Context, message string, err error, fields map[string]interface{})
	// Debug logs a debug message
	Debug(ctx context.Context, message string, fields map[string]interface{})
	// Warn logs a warning message
	Warn(ctx context.Context, message string, fields map[string]interface{})
}

type Metrics interface {
	// RecordQueryLatency records the latency of a query
	RecordQueryLatency(ctx context.Context, duration time.Duration)
	// RecordIndexLatency records the latency of an index operation
	RecordIndexLatency(ctx context.Context, duration time.Duration)
	// RecordQueryCount records the number of queries
	RecordQueryCount(ctx context.Context, status string)
	// RecordIndexCount records the number of index operations
	RecordIndexCount(ctx context.Context, status string)
	// RecordErrorCount records the number of errors
	RecordErrorCount(ctx context.Context, errorType string)
	// Register registers the metrics with Prometheus
	Register() error
}

type NoopSpan struct{}

type NoopTracer struct{}

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

type Span interface {
	// End ends the span
	End()
	// SetAttribute sets an attribute on the span
	SetAttribute(key string, value interface{})
	// SetError sets an error on the span
	SetError(err error)
}

type SpanContext struct {
	TraceID string
	SpanID  string
}

type Tracer interface {
	// StartSpan starts a new span
	StartSpan(ctx context.Context, name string) (context.Context, Span)
	// Extract extracts a span from a context
	Extract(ctx context.Context) (Span, bool)
}