mizcausevic-dev/miz-otel-pack

Purpose and principal workflow

otel-pack is a Go library that wraps an OpenTelemetry SDK span processor and converts completed GenAI operation spans into sibling business-metric spans. The external caller is a Go service integrating the library into its OTel TracerProvider; that service’s instrumented code emits spans, and the processor derives cost, token, latency, tenant, provider, and model attributes before forwarding the original span to the wrapped processor.

Components

Provider wiring and processor lifecycle

• Business Span Processor — processor.go: Implements the SDK SpanProcessor interface, wraps another processor, forwards lifecycle calls, and invokes derivation on completed spans.

GenAI-to-business translation

• Span Attribute Translator — processor.go: Reads GenAI attributes from ended spans, requires a model attribute, calculates token totals and elapsed time, and creates a business. sibling span with a source-span ID.

Pricing

• Model Pricing Registry — pricing.go: Provides built-in per-million-token rates, lookup and cost calculation, and RegisterPricing for consumer overrides.

External participants

• Integrating Go Service — null: The consumer configures the tracer provider and processor, and its instrumented code creates GenAI spans.

• OpenTelemetry SDK and Global Tracer Provider — null: The external SDK invokes processor lifecycle methods; the global provider supplies the tracer used for derived spans.

• Wrapped Span Processor / Exporter Pipeline — null: The consumer supplies a processor, such as a batch processor connected to an exporter, to receive original spans.

Relationships

• Integrating Go Service -> Business Span Processor: Installs it in the tracer provider; documented quickstart constructs the wrapper and passes it to trace.NewTracerProvider.

• Integrating Go Service -> OpenTelemetry SDK and Global Tracer Provider: Configures the global provider and emits instrumented spans; documented quickstart and GenAI example.

• OpenTelemetry SDK and Global Tracer Provider -> Business Span Processor: Calls OnStart and OnEnd through the SDK processor interface; OnEnd is implemented in processor.go.

• Business Span Processor -> Span Attribute Translator: Invokes translation when an original span ends; OnEnd calls emitBusinessSpan.

• Span Attribute Translator -> Model Pricing Registry: Looks up provider when the span lacks a provider attribute and calculates cost from model and token counts; processor.go calls LookupPricing and CostUSD.

• Span Attribute Translator -> OpenTelemetry SDK and Global Tracer Provider: Requests a tracer from the global provider and starts and ends the derived sibling span; processor.go calls otel.Tracer and Start/End.

• Business Span Processor -> Wrapped Span Processor / Exporter Pipeline: Forwards original-span start/end and flush/shutdown calls; processor.go delegates to next.

• Integrating Go Service -> Model Pricing Registry: Registers or overrides model prices through RegisterPricing; documented pricing example.

Coverage limits

The source sample does not show exporter implementations or consumer-specific provider setup beyond the README quickstart. Pricing registry synchronization and behavior under concurrent registration are not established by the sampled code.