observability

type AuditEvent struct {
	Name       string
	Attributes map[string]string
}

type Auditor interface {
	Audit(context.Context, AuditEvent)
}

type AuditorFunc func(context.Context, AuditEvent)

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

type HeaderCarrier http.Header

type Health struct {
	Name    string            `json:"name"`
	Status  HealthStatus      `json:"status"`
	Message string            `json:"message,omitempty"`
	Details map[string]string `json:"details,omitempty"`
}

type HealthChecker interface {
	CheckHealth(ctx context.Context) Health
}

type HealthStatus string

type InstrumentOption func(*instrumentOptions)

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

type MapCarrier map[string]string

type MeterConfig struct {
	// ServiceName is the name of the service.
	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 host:port (e.g., "localhost:4318" for HTTP, "localhost:4317" for gRPC).
	Endpoint string
	// Protocol selects the OTLP wire protocol (HTTP or gRPC). Defaults to HTTP.
	Protocol OTLPProtocol
	// Insecure allows insecure connections (for development).
	Insecure bool
	// Interval is the metric export interval.
	Interval time.Duration
	// SkipGlobalRegistration, when true,
	// prevents InitMeter from mutating the global otel.SetMeterProvider state.
	// See TracerConfig.SkipGlobalRegistration.
	SkipGlobalRegistration bool
}

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

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

type OTLPProtocol int

type OperationContext struct {
	ServiceName   string
	OperationName string
	RequestID     string
	UserID        string
	StartTime     time.Time
	Metrics       *Metrics
}

type OperationMetric struct {
	Service   string
	Operation string
	Status    string
	Duration  time.Duration
}

type OperationSpec struct {
	ServiceName   string
	OperationName string
	RequestID     string
	UserID        string
	Metrics       *Metrics
}

type RequestMetric struct {
	Service  string
	Method   string
	Status   string
	Duration time.Duration
}

type ServiceHealth struct {
	Service    string       `json:"service"`
	Status     HealthStatus `json:"status"`
	Version    string       `json:"version,omitempty"`
	Components []Health     `json:"components,omitempty"`
}

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

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

type SpanKind int

type SpanOption func(*spanOptions)

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

type TracerConfig struct {
	// ServiceName is the name of the service.
	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 host:port (e.g., "localhost:4318" for HTTP, "localhost:4317" for gRPC).
	Endpoint string
	// Protocol selects the OTLP wire protocol (HTTP or gRPC). Defaults to HTTP.
	Protocol OTLPProtocol
	// Insecure allows insecure connections (for development).
	Insecure bool
	// SampleRate is the sampling rate (0.0 to 1.0).
	SampleRate float64
	// SkipGlobalRegistration, when true,
	// prevents InitTracer from mutating the global otel.SetTracerProvider / otel.SetTextMapPropagator state.
	// Callers that want to thread the returned *TracerProvider through DI can opt out of process-global state.
	// Defaults to false to preserve the convenient "init once,
	// instrument anywhere via observability.Tracer(...)" pattern.
	SkipGlobalRegistration bool
}