Function init_tracing

src/observability/tracing.py:52–114

Initialize the global OTEL tracer provider. Idempotent. No-op when tracing isn't configured, so callers can invoke unconditionally from CLI entry points.

(service_name: str)

def init_tracing(service_name: str) -> None:
    """Initialize the global OTEL tracer provider.

    Idempotent.  No-op when tracing isn't configured, so callers can invoke
    unconditionally from CLI entry points.
    """
    global _initialized
    if _initialized:
        return
    if not _tracing_enabled():
        return

    try:
        from opentelemetry.sdk.resources import Resource
        from opentelemetry.sdk.trace import TracerProvider
        from opentelemetry.sdk.trace.export import BatchSpanProcessor
    except ImportError as exc:
        _log.warning("OTEL SDK not installed; tracing disabled: %s", exc)
        return

    with _init_lock:
        if _initialized:
            return

        provider = TracerProvider(
            resource=Resource.create({"service.name": service_name})
        )

        if (path := _traces_file_path()) is not None:
            from .file_exporter import OTLPJsonFileExporter

            provider.add_span_processor(BatchSpanProcessor(OTLPJsonFileExporter(path)))
            _log.info("OTEL file exporter enabled (path=%s).", path)

        if _http_endpoint_set():
            try:
                from opentelemetry.exporter.otlp.proto.http.trace_exporter import (
                    OTLPSpanExporter,
                )
            except ImportError:
                _log.warning(
                    "opentelemetry-exporter-otlp-proto-http not installed; "
                    "HTTP export disabled."
                )
            else:
                provider.add_span_processor(BatchSpanProcessor(OTLPSpanExporter()))
                _log.info("OTEL HTTP exporter enabled.")

        trace.set_tracer_provider(provider)
        atexit.register(provider.shutdown)

        try:
            from opentelemetry.instrumentation.httpx import HTTPXClientInstrumentor

            HTTPXClientInstrumentor().instrument()
        except ImportError:
            _log.warning(
                "opentelemetry-instrumentation-httpx not installed — LiteLLM "