Changelog

All notable changes to otelio are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.0.2 - 2026-06-20

otel_set_span_status(status, message=None, span=None) — set a span's StatusCode (UNSET / OK / ERROR) with an optional description. StatusCode is now re-exported from the otelio package.
Pluggable exporter registry: init_otelio accepts trace_exporters / log_exporters to register custom exporters inline (lists of {"name", "factory"}), selectable via OTELIO_TARGET. Built-in otlp (gRPC) and azure targets are now pre-registered entries. Exports Settings, TraceExporterEntry, and LogExporterEntry.
OTELIO_CONSOLE — when truthy, attach a SimpleSpanProcessor + ConsoleSpanExporter alongside the batch exporter so spans print to stdout for local debugging.
Custom resource attributes via init_otelio.
docs/custom-exporter.md documenting built-in targets, OTELIO_CONSOLE, and custom exporters.

Renamed the DEPLOYMENT_ENVIRONMENT env var to OTELIO_ENVIRONMENT for consistency with the OTELIO_* prefix. The deployment.environment resource attribute key is unchanged.
Pinned OpenTelemetry to 1.40 for Azure exporter compatibility.

init_otelio(...) — one-call bootstrap of the tracer + logger providers, the Loguru bridge, and an atexit flush hook.
Span helpers: otel_span, otel_current_span, otel_get_tracer.
Attribute / event helpers: otel_set_attributes, otel_add_event.
Context propagation helpers: otel_inject_headers, otel_context_from_headers.
Baggage helpers: otel_set_baggage, otel_get_baggage, otel_get_all_baggage.
OTLP/gRPC exporter (core install) and optional Azure Application Insights exporter (otelio[azure]), selected at runtime via the OTELIO_TARGET environment variable.
Automatic correlation of Loguru log records to the active trace_id / span_id.