elven-logs-interceptor-python 0.1.8__tar.gz → 0.1.9__tar.gz

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elven-logs-interceptor-python
-Version: 0.1.8
+Version: 0.1.9
 Summary: Production-grade logs interceptor for Python with Loki transport, resilience, batching, and framework integrations.
 Author: Elven Observability
 License: MIT
@@ -154,6 +154,7 @@ Transport:
 - `LOGS_WORKER_TIMEOUT`
 - `LOGS_CONNECTION_POOLING`
 - `LOGS_MAX_SOCKETS`
+- `LOGS_ENABLE_STRUCTURED_METADATA` (`false` by default; enable only when Loki allows `limits_config.allow_structured_metadata`)
 - `LOGS_TIMEOUT`
 - `LOGS_MAX_RETRIES`
 - `LOGS_RETRY_DELAY`

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/README.md

@@ -93,6 +93,7 @@ Transport:
 - `LOGS_WORKER_TIMEOUT`
 - `LOGS_CONNECTION_POOLING`
 - `LOGS_MAX_SOCKETS`
+- `LOGS_ENABLE_STRUCTURED_METADATA` (`false` by default; enable only when Loki allows `limits_config.allow_structured_metadata`)
 - `LOGS_TIMEOUT`
 - `LOGS_MAX_RETRIES`
 - `LOGS_RETRY_DELAY`

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "elven-logs-interceptor-python"
-version = "0.1.8"
+version = "0.1.9"
 description = "Production-grade logs interceptor for Python with Loki transport, resilience, batching, and framework integrations."
 readme = "README.md"
 requires-python = ">=3.10"

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/src/logs_interceptor/__init__.py

@@ -104,6 +104,9 @@ def _coerce_config(user_config: LogsInterceptorConfig | dict[str, Any] | None) -
                 transport_raw, "enable_connection_pooling", "enableConnectionPooling"
             ),
             max_sockets=_pick(transport_raw, "max_sockets", "maxSockets"),
+            enable_structured_metadata=_pick(
+                transport_raw, "enable_structured_metadata", "enableStructuredMetadata"
+            ),
         ),
         app_name=_pick(user_config, "app_name", "appName", ""),
         version=_pick(user_config, "version", "version"),

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/src/logs_interceptor/application/config_service.py

@@ -170,6 +170,11 @@ class ConfigService:
                 True if transport.enable_connection_pooling is None else transport.enable_connection_pooling
             ),
             max_sockets=transport.max_sockets if transport.max_sockets is not None else 50,
+            enable_structured_metadata=(
+                False
+                if transport.enable_structured_metadata is None
+                else transport.enable_structured_metadata
+            ),
         )
 
     @staticmethod

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/src/logs_interceptor/config.py

@@ -26,6 +26,7 @@ class TransportConfig:
     worker_timeout: int | None = None
     enable_connection_pooling: bool | None = None
     max_sockets: int | None = None
+    enable_structured_metadata: bool | None = None
 
 
 @dataclass(slots=True)
@@ -131,6 +132,7 @@ class ResolvedTransportConfig:
     worker_timeout: int
     enable_connection_pooling: bool
     max_sockets: int
+    enable_structured_metadata: bool = False
 
 
 @dataclass(slots=True)

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/src/logs_interceptor/infrastructure/transport/loki_json_transport.py

@@ -210,9 +210,10 @@ class LokiJsonTransport:
 
             timestamp_ns = self._timestamp_to_ns(entry.timestamp)
             value: list[Any] = [str(timestamp_ns), self._dumps(payload).decode("utf-8")]
-            structured_metadata = self._format_structured_metadata(entry.metadata)
-            if structured_metadata:
-                value.append(structured_metadata)
+            if self._config.enable_structured_metadata:
+                structured_metadata = self._format_structured_metadata(entry.metadata)
+                if structured_metadata:
+                    value.append(structured_metadata)
             values_map[key].append(value)
             streams[key] = labels
 

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/src/logs_interceptor/utils.py

@@ -530,6 +530,9 @@ def load_config_from_env() -> LogsInterceptorConfig:
             enable_connection_pooling=parse_bool(env.get("LOGS_CONNECTION_POOLING"), True),
             max_sockets=parse_int_range(env.get("LOGS_MAX_SOCKETS"), 50, 1, 1024),
             worker_timeout=parse_int_range(env.get("LOGS_WORKER_TIMEOUT"), 30_000, 1000, 300_000),
+            enable_structured_metadata=parse_bool(
+                env.get("LOGS_ENABLE_STRUCTURED_METADATA"), False
+            ),
         ),
         app_name=env.get("LOGS_APP_NAME", ""),
         version=env.get("LOGS_APP_VERSION", "1.0.0"),

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/tests/unit/test_config_service.py

@@ -47,6 +47,7 @@ def test_resolve_applies_defaults() -> None:
 
     assert resolved.transport.timeout == 10_000
     assert resolved.transport.max_retries == 3
+    assert resolved.transport.enable_structured_metadata is False
     assert resolved.buffer.max_size == 100
     assert resolved.filter.sampling_rate == 1.0
     assert "httpx" in resolved.filter.exclude_logger_prefixes
@@ -55,6 +56,21 @@ def test_resolve_applies_defaults() -> None:
     assert resolved.performance.max_concurrent_flushes == 3
 
 
+def test_resolve_enables_structured_metadata_only_when_requested() -> None:
+    resolved = ConfigService.resolve(
+        LogsInterceptorConfig(
+            transport=TransportConfig(
+                url="https://loki.example.com/loki/api/v1/push",
+                tenant_id="tenant",
+                enable_structured_metadata=True,
+            ),
+            app_name="app",
+        )
+    )
+
+    assert resolved.transport.enable_structured_metadata is True
+
+
 def test_validate_extended_ranges() -> None:
     config = LogsInterceptorConfig(
         transport=TransportConfig(

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/tests/unit/test_loki_json_transport.py

@@ -20,7 +20,10 @@ class _Response:
     text: str = ""
 
 
-def _config(compression: str = "gzip") -> ResolvedTransportConfig:
+def _config(
+    compression: str = "gzip",
+    enable_structured_metadata: bool = False,
+) -> ResolvedTransportConfig:
     return ResolvedTransportConfig(
         url="https://loki.example.com/loki/api/v1/push",
         tenant_id="tenant",
@@ -36,6 +39,7 @@ def _config(compression: str = "gzip") -> ResolvedTransportConfig:
         worker_timeout=100,
         enable_connection_pooling=False,
         max_sockets=10,
+        enable_structured_metadata=enable_structured_metadata,
     )
 
 
@@ -92,7 +96,7 @@ def test_loki_json_transport_suppresses_internal_capture_during_request(
     assert observed == [True]
 
 
-def test_loki_json_transport_uses_structured_metadata_for_correlation_ids() -> None:
+def test_loki_json_transport_keeps_correlation_metadata_in_log_line_by_default() -> None:
     transport = LokiJsonTransport(_config())
     payload = transport._format_for_loki(
         [
@@ -121,6 +125,38 @@ def test_loki_json_transport_uses_structured_metadata_for_correlation_ids() -> N
     stream = payload["streams"][0]
     assert stream["stream"] == {"service": "billing"}
     value = stream["values"][0]
+    assert len(value) == 2
+
+    line = json.loads(value[1])
+    assert line["traceId"] == "trace-123"
+    assert line["spanId"] == "span-123"
+    assert line["requestId"] == "req-123"
+    assert line["metadata"]["trace_id"] == "trace-123"
+    assert line["metadata"]["span_id"] == "span-123"
+    assert line["metadata"]["request_id"] == "req-123"
+
+
+def test_loki_json_transport_uses_structured_metadata_when_explicitly_enabled() -> None:
+    transport = LokiJsonTransport(_config(enable_structured_metadata=True))
+    payload = transport._format_for_loki(
+        [
+            LogEntryEntity(
+                id="1",
+                timestamp="2026-01-01T00:00:00.000000+00:00",
+                level="info",
+                message="hello",
+                labels={"service": "billing"},
+                metadata={
+                    "trace_id": "trace-123",
+                    "span_id": "span-123",
+                    "request_id": "req-123",
+                    "ignored": None,
+                },
+            )
+        ]
+    )
+
+    value = payload["streams"][0]["values"][0]
     assert value[2] == {
         "trace_id": "trace-123",
         "span_id": "span-123",

{elven_logs_interceptor_python-0.1.8 → elven_logs_interceptor_python-0.1.9}/tests/unit/test_utils_extra.py

@@ -207,9 +207,11 @@ def test_env_levels_and_env_loader_branches(monkeypatch: pytest.MonkeyPatch) ->
     monkeypatch.setenv("LOGS_APP_NAME", "app")
     monkeypatch.setenv("LOGS_COMPRESSION", "invalid")
     monkeypatch.setenv("LOGS_DLQ_TYPE", "invalid")
+    monkeypatch.setenv("LOGS_ENABLE_STRUCTURED_METADATA", "true")
 
     cfg = load_config_from_env()
     assert cfg.transport.compression == "gzip"
+    assert cfg.transport.enable_structured_metadata is True
     assert cfg.dead_letter_queue is not None
     assert cfg.dead_letter_queue.type == "memory"