OpenTelemetry span integration for ExDataSketch telemetry events.

This module bridges ExDataSketch's :telemetry events to OpenTelemetry spans when the :opentelemetry_api dependency is available. It attaches handlers that create spans for sketch, persistence, stream, and pipeline events.

Dependency

This module requires the :opentelemetry_api package. If it is not available, calling setup/0 will raise an error directing the user to add it as a dependency.

Usage

# In your application's `start/2` callback:
ExDataSketch.Telemetry.OpenTelemetry.setup()

This attaches handlers for all ExDataSketch telemetry events and creates corresponding OpenTelemetry spans with appropriate attributes.

Span Attributes

Each span includes the following attributes:

• ex_data_sketch.sketch_type -- the sketch type (e.g., :hll, :cms)
• ex_data_sketch.backend -- the persistence backend (for persistence events)
• ex_data_sketch.key -- the storage key (for persistence events)
• ex_data_sketch.merge_count -- number of sketches merged
• ex_data_sketch.item_count -- number of items ingested
• ex_data_sketch.size_bytes -- serialized size in bytes
• ex_data_sketch.category -- event category (:sketch, :persistence, etc.)

Configuration

OpenTelemetry integration can be disabled via application config:

config :ex_data_sketch, :integrations, opentelemetry: false

When not explicitly configured, availability defaults to whether :opentelemetry_api is loaded at runtime.