elven-logs-interceptor-python 0.1.11__tar.gz → 0.1.13__tar.gz

{elven_logs_interceptor_python-0.1.11 → elven_logs_interceptor_python-0.1.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elven-logs-interceptor-python
-Version: 0.1.11
+Version: 0.1.13
 Summary: Production-grade logs interceptor for Python with Loki transport, resilience, batching, and framework integrations.
 Author: Elven Observability
 License: MIT
@@ -132,17 +132,19 @@ data is explicitly required and approved.
 The package supports the Python `LOGS_*` configuration surface aligned with
 the JS v3 design where applicable.
 
-Required:
+Required for direct Loki mode:
 
 - `LOGS_URL`
 - `LOGS_TENANT`
 - `LOGS_APP_NAME`
 
 For collector-first mode, set `LOGS_EXPORTER=otlp` (or `collector`) and use
-`OTEL_EXPORTER_OTLP_ENDPOINT` or `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`. In this
-mode `LOGS_TENANT` and `LOGS_TOKEN` are not required by the library; put tenant
-or auth headers in `OTEL_EXPORTER_OTLP_HEADERS`/`LOGS_OTLP_HEADERS` if your
-collector gateway requires them.
+`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`. In this mode `LOGS_URL`, `LOKI_URL`,
+`LOGS_TENANT` and `LOGS_TOKEN` are not required by the library. `LOGS_URL` is
+intentionally ignored in collector mode to avoid accidentally posting OTLP logs
+to a direct Loki `/loki/api/v1/push` endpoint. Put tenant or auth headers in
+`OTEL_EXPORTER_OTLP_HEADERS`/`LOGS_OTLP_HEADERS` if your collector gateway
+requires them.
 
 Core:
 
@@ -153,7 +155,7 @@ Core:
 Transport:
 
 - `LOGS_EXPORTER` (`loki|otlp`, aliases: `collector`, `otel`)
-- `LOGS_OTLP_ENDPOINT` (explicit OTLP logs endpoint, e.g. `http://collector:4318/v1/logs`)
+- `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` (collector logs endpoint, e.g. `http://collector:4318/v1/logs`)
 - `LOGS_OTLP_HEADERS` (comma-separated headers, e.g. `x-tenant=team-a`)
 - `LOGS_COMPRESSION` (`none|gzip|brotli|snappy`)
 - `LOGS_COMPRESSION_LEVEL`

{elven_logs_interceptor_python-0.1.11 → elven_logs_interceptor_python-0.1.13}/README.md

@@ -71,17 +71,19 @@ data is explicitly required and approved.
 The package supports the Python `LOGS_*` configuration surface aligned with
 the JS v3 design where applicable.
 
-Required:
+Required for direct Loki mode:
 
 - `LOGS_URL`
 - `LOGS_TENANT`
 - `LOGS_APP_NAME`
 
 For collector-first mode, set `LOGS_EXPORTER=otlp` (or `collector`) and use
-`OTEL_EXPORTER_OTLP_ENDPOINT` or `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`. In this
-mode `LOGS_TENANT` and `LOGS_TOKEN` are not required by the library; put tenant
-or auth headers in `OTEL_EXPORTER_OTLP_HEADERS`/`LOGS_OTLP_HEADERS` if your
-collector gateway requires them.
+`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`. In this mode `LOGS_URL`, `LOKI_URL`,
+`LOGS_TENANT` and `LOGS_TOKEN` are not required by the library. `LOGS_URL` is
+intentionally ignored in collector mode to avoid accidentally posting OTLP logs
+to a direct Loki `/loki/api/v1/push` endpoint. Put tenant or auth headers in
+`OTEL_EXPORTER_OTLP_HEADERS`/`LOGS_OTLP_HEADERS` if your collector gateway
+requires them.
 
 Core:
 
@@ -92,7 +94,7 @@ Core:
 Transport:
 
 - `LOGS_EXPORTER` (`loki|otlp`, aliases: `collector`, `otel`)
-- `LOGS_OTLP_ENDPOINT` (explicit OTLP logs endpoint, e.g. `http://collector:4318/v1/logs`)
+- `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` (collector logs endpoint, e.g. `http://collector:4318/v1/logs`)
 - `LOGS_OTLP_HEADERS` (comma-separated headers, e.g. `x-tenant=team-a`)
 - `LOGS_COMPRESSION` (`none|gzip|brotli|snappy`)
 - `LOGS_COMPRESSION_LEVEL`

{elven_logs_interceptor_python-0.1.11 → elven_logs_interceptor_python-0.1.13}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "elven-logs-interceptor-python"
-version = "0.1.11"
+version = "0.1.13"
 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.11 → elven_logs_interceptor_python-0.1.13}/src/logs_interceptor/infrastructure/interceptors/runtime_interceptor.py

@@ -14,6 +14,8 @@ from ..internal_capture_guard import is_internal_log_capture_suppressed
 from ..log_noise_filter import normalize_excluded_logger_prefixes, should_drop_log_record
 from ..log_record_extra import extract_log_record_extra
 
+_LOG_RECORD_CAPTURED_ATTR = "_elven_uo_captured"
+
 
 class _BridgeLoggingHandler(logging.Handler):
     def __init__(self, logger: ILogger, exclude_prefixes: list[str] | None = None) -> None:
@@ -23,6 +25,8 @@ class _BridgeLoggingHandler(logging.Handler):
 
     def emit(self, record: logging.LogRecord) -> None:
         try:
+            if getattr(record, _LOG_RECORD_CAPTURED_ATTR, False):
+                return
             if is_internal_log_capture_suppressed():
                 return
             if should_drop_log_record(

{elven_logs_interceptor_python-0.1.11 → elven_logs_interceptor_python-0.1.13}/src/logs_interceptor/integrations/logging_handler.py

@@ -13,6 +13,8 @@ from ..infrastructure.log_noise_filter import (
 from ..infrastructure.log_record_extra import extract_log_record_extra
 from ..types import LogLevel
 
+_LOG_RECORD_CAPTURED_ATTR = "_elven_uo_captured"
+
 
 class LoggingHandler(logging.Handler):
     def __init__(self, logger: ILogger, exclude_prefixes: list[str] | None = None) -> None:
@@ -22,6 +24,8 @@ class LoggingHandler(logging.Handler):
 
     def emit(self, record: logging.LogRecord) -> None:
         try:
+            if getattr(record, _LOG_RECORD_CAPTURED_ATTR, False):
+                return
             if is_internal_log_capture_suppressed():
                 return
             if should_drop_log_record(

{elven_logs_interceptor_python-0.1.11 → elven_logs_interceptor_python-0.1.13}/src/logs_interceptor/utils.py

@@ -96,26 +96,10 @@ def _parse_kv_csv(raw: str | None) -> dict[str, str]:
     return headers
 
 
-def _otlp_logs_endpoint_from_base(endpoint: str | None) -> str:
-    if not endpoint:
-        return ""
-    normalized = endpoint.rstrip("/")
-    if normalized.endswith("/v1/logs"):
-        return normalized
-    if normalized.endswith("/v1/traces") or normalized.endswith("/v1/metrics"):
-        return normalized.rsplit("/", 1)[0] + "/logs"
-    return normalized + "/v1/logs"
-
-
 def _resolve_logs_url(env: Mapping[str, str], exporter: str) -> str:
     if exporter != "otlp":
         return env.get("LOGS_URL", "")
-    return (
-        env.get("LOGS_URL")
-        or env.get("LOGS_OTLP_ENDPOINT")
-        or env.get("OTEL_EXPORTER_OTLP_LOGS_ENDPOINT")
-        or _otlp_logs_endpoint_from_base(env.get("OTEL_EXPORTER_OTLP_ENDPOINT"))
-    )
+    return env.get("OTEL_EXPORTER_OTLP_LOGS_ENDPOINT", "")
 
 
 def is_debug_enabled() -> bool: