iii-observability 0.19.2.dev1__tar.gz → 0.19.3.dev1__tar.gz

{iii_observability-0.19.2.dev1 → iii_observability-0.19.3.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iii-observability
-Version: 0.19.2.dev1
+Version: 0.19.3.dev1
 Summary: OpenTelemetry and logging primitives shared across iii SDKs.
 Project-URL: Homepage, https://github.com/iii-hq/iii
 Project-URL: Repository, https://github.com/iii-hq/iii

{iii_observability-0.19.2.dev1 → iii_observability-0.19.3.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "iii-observability"
-version = "0.19.2.dev1"
+version = "0.19.3.dev1"
 description = "OpenTelemetry and logging primitives shared across iii SDKs."
 authors = [{ name = "III" }]
 license = { text = "Apache-2.0" }

{iii_observability-0.19.2.dev1 → iii_observability-0.19.3.dev1}/src/iii_observability/telemetry.py

@@ -115,7 +115,21 @@ def init_otel(
     from .baggage_span_processor import BaggageSpanProcessor
 
     provider.add_span_processor(BaggageSpanProcessor())
-    provider.add_span_processor(BatchSpanProcessor(span_exporter))  # type: ignore[arg-type]
+    # Without an explicit schedule_delay_millis, BatchSpanProcessor inherits the
+    # OpenTelemetry default of 5000ms, so an ended span sits in the buffer up to
+    # 5s before reaching the engine — the dominant reason traces appear seconds
+    # late. Mirror the logs path with a small flush delay.
+    spans_flush_interval_ms = _resolve_int(
+        cfg.spans_flush_interval_ms,
+        "OTEL_SPANS_FLUSH_INTERVAL_MS",
+        default=100,
+    )
+    provider.add_span_processor(
+        BatchSpanProcessor(
+            span_exporter,  # type: ignore[arg-type]
+            schedule_delay_millis=spans_flush_interval_ms,
+        )
+    )
     trace.set_tracer_provider(provider)
     _tracer = trace.get_tracer("iii-python-sdk")
 

{iii_observability-0.19.2.dev1 → iii_observability-0.19.3.dev1}/src/iii_observability/telemetry_types.py

@@ -30,6 +30,13 @@ class OtelConfig:
     fetch_instrumentation_enabled: bool = True
     """Auto-instrument urllib HTTP calls via URLLibInstrumentor. Defaults to True."""
 
+    spans_flush_interval_ms: int | None = None
+    """Span processor flush delay in milliseconds. Defaults to 100ms when not set.
+
+    The OpenTelemetry default of 5000ms is what makes traces appear seconds
+    after the action. Env override: OTEL_SPANS_FLUSH_INTERVAL_MS.
+    """
+
     logs_enabled: bool | None = None
     """Enable OTel log export via EngineLogExporter. Defaults to True when OTel is enabled."""