observability

package

v1.1.5 Latest Latest Go to latest Published: Feb 18, 2026 License: Apache-2.0 Imports: 26 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

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

Runtime exposes OpenTelemetry HTTP wrappers and gateway metric hooks.

func Setup(ctx context.Context, cfg config.OTelConfig, serviceVersion string, logger *slog.Logger) (*Runtime, error)

Setup initializes OpenTelemetry providers and runtime hooks.

func (r *Runtime) Enabled() bool

Enabled reports whether OpenTelemetry instrumentation is active.

func (r *Runtime) RecordTraceQueueDrop(path string, status int)

RecordTraceQueueDrop increments a counter when the async trace queue is full.

func (r *Runtime) RecordTraceWriteFailure(operation string, failedCount int)

RecordTraceWriteFailure increments a counter for dropped trace records.

func (r *Runtime) Shutdown(ctx context.Context) error

Shutdown flushes and stops OpenTelemetry providers.

func (r *Runtime) SpanEnrichmentMiddleware(next http.Handler) http.Handler

SpanEnrichmentMiddleware adds gateway attributes and stable error status on 5xx responses.

func (r *Runtime) WrapHTTPHandler(next http.Handler) http.Handler

WrapHTTPHandler wraps an inbound HTTP handler with OpenTelemetry spans.

func (r *Runtime) WrapHTTPTransport(base http.RoundTripper) http.RoundTripper

WrapHTTPTransport wraps an outbound HTTP transport with OpenTelemetry spans.