netra-sdk 0.1.46__py3-none-any.whl → 0.1.47__py3-none-any.whl

netra/__init__.py

@@ -183,11 +183,12 @@ class Netra:
             session_id: Session identifier
         """
         if not isinstance(session_id, str):
-            raise TypeError(f"session_id must be a string, got {type(session_id)}")
+            logger.error(f"set_session_id: session_id must be a string, got {type(session_id)}")
+            return
         if session_id:
             SessionManager.set_session_context("session_id", session_id)
         else:
-            logger.warning("Session ID must be provided for setting session_id.")
+            logger.warning("set_session_id: Session ID must be provided for setting session_id.")
 
     @classmethod
     def set_user_id(cls, user_id: str) -> None:
@@ -198,11 +199,12 @@ class Netra:
             user_id: User identifier
         """
         if not isinstance(user_id, str):
-            raise TypeError(f"user_id must be a string, got {type(user_id)}")
+            logger.error(f"set_user_id: user_id must be a string, got {type(user_id)}")
+            return
         if user_id:
             SessionManager.set_session_context("user_id", user_id)
         else:
-            logger.warning("User ID must be provided for setting user_id.")
+            logger.warning("set_user_id: User ID must be provided for setting user_id.")
 
     @classmethod
     def set_tenant_id(cls, tenant_id: str) -> None:
@@ -213,11 +215,12 @@ class Netra:
             user_account_id: User account identifier
         """
         if not isinstance(tenant_id, str):
-            raise TypeError(f"tenant_id must be a string, got {type(tenant_id)}")
+            logger.error(f"set_tenant_id: tenant_id must be a string, got {type(tenant_id)}")
+            return
         if tenant_id:
             SessionManager.set_session_context("tenant_id", tenant_id)
         else:
-            logger.warning("Tenant ID must be provided for setting tenant_id.")
+            logger.warning("set_tenant_id: Tenant ID must be provided for setting tenant_id.")
 
     @classmethod
     def set_custom_attributes(cls, key: str, value: Any) -> None:

netra/decorators.py

@@ -285,7 +285,8 @@ def _create_function_wrapper(
             # Set span type if provided
 
             if not isinstance(as_type, SpanType):
-                raise ValueError(f"Invalid span type: {as_type}")
+                logger.error("Invalid span type: %s", as_type)
+                return
             try:
                 span.set_attribute("netra.span.type", as_type.value)
             except Exception:
@@ -344,7 +345,8 @@ def _create_function_wrapper(
             # Set span type if provided
             if as_type is not None:
                 if not isinstance(as_type, SpanType):
-                    raise ValueError(f"Invalid span type: {as_type}")
+                    logger.error("Invalid span type: %s", as_type)
+                    return
                 try:
                     span.set_attribute("netra.span.type", as_type.value)
                 except Exception:

netra/span_wrapper.py

@@ -98,7 +98,8 @@ class SpanWrapper:
         if isinstance(as_type, SpanType):
             self.attributes["netra.span.type"] = as_type.value
         else:
-            raise ValueError(f"Invalid span type: {as_type}")
+            logger.error("Invalid span type: %s", as_type)
+            return
 
     def __enter__(self) -> "SpanWrapper":
         """Start the span wrapper, begin time tracking, and create OpenTelemetry span."""

netra/tracer.py

@@ -5,10 +5,12 @@ including exporter setup and span processor configuration.
 """
 
 import logging
+import threading
 from typing import Any, Dict
 
 from opentelemetry import trace
 from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
+from opentelemetry.sdk import trace as sdk_trace
 from opentelemetry.sdk.resources import DEPLOYMENT_ENVIRONMENT, SERVICE_NAME, Resource
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import (
@@ -22,6 +24,8 @@ from netra.exporters import FilteringSpanExporter
 
 logger = logging.getLogger(__name__)
 
+_provider_install_lock = threading.Lock()
+
 
 class Tracer:
     """
@@ -55,57 +59,66 @@ class Tracer:
         resource = Resource(attributes=resource_attrs)
 
         # Build TracerProvider
-        provider = TracerProvider(resource=resource)
-
-        # Configure exporter based on configuration
-        if not self.cfg.otlp_endpoint:
-            logger.warning("OTLP endpoint not provided, falling back to console exporter")
-            exporter = ConsoleSpanExporter()
+        current_provider = trace.get_tracer_provider()
+        if isinstance(current_provider, sdk_trace.TracerProvider):
+            provider = current_provider
+            logger.info("Reusing existing TracerProvider. Possible loss of Resource attributes")
         else:
-            exporter = OTLPSpanExporter(
-                endpoint=self._format_endpoint(self.cfg.otlp_endpoint),
-                headers=self.cfg.headers,
+            provider = TracerProvider(resource=resource)
+            trace.set_tracer_provider(provider)
+            logger.info("Using Netra TracerProvider")
+
+        with _provider_install_lock:
+            if getattr(provider, "_netra_processors_installed", False):
+                logger.info("Netra processors already installed on provider; skipping setup")
+                return
+
+            if not self.cfg.otlp_endpoint:
+                logger.warning("OTLP endpoint not provided, falling back to console exporter")
+                exporter = ConsoleSpanExporter()
+            else:
+                exporter = OTLPSpanExporter(
+                    endpoint=self._format_endpoint(self.cfg.otlp_endpoint),
+                    headers=self.cfg.headers,
+                )
+            original_exporter = exporter
+            try:
+                patterns = getattr(self.cfg, "blocked_spans", None) or []
+                exporter = FilteringSpanExporter(exporter, patterns)
+                if patterns:
+                    logger.info("Enabled FilteringSpanExporter with %d global pattern(s)", len(patterns))
+                else:
+                    logger.info("Enabled FilteringSpanExporter with local-only rules")
+            except (ValueError, TypeError) as e:
+                logger.warning("Failed to enable FilteringSpanExporter: %s; using unwrapped exporter", e)
+                exporter = original_exporter
+
+            from netra.processors import (
+                InstrumentationSpanProcessor,
+                LocalFilteringSpanProcessor,
+                ScrubbingSpanProcessor,
+                SessionSpanProcessor,
             )
-        # Wrap exporter with filtering to support both global and local (baggage-based) rules
-        try:
-            patterns = getattr(self.cfg, "blocked_spans", None) or []
-            exporter = FilteringSpanExporter(exporter, patterns)
-            if patterns:
-                logger.info("Enabled FilteringSpanExporter with %d global pattern(s)", len(patterns))
+
+            provider.add_span_processor(LocalFilteringSpanProcessor())
+            provider.add_span_processor(InstrumentationSpanProcessor())
+            provider.add_span_processor(SessionSpanProcessor())
+
+            if self.cfg.enable_scrubbing:
+                provider.add_span_processor(ScrubbingSpanProcessor())  # type: ignore[no-untyped-call]
+
+            if self.cfg.disable_batch:
+                provider.add_span_processor(SimpleSpanProcessor(exporter))
             else:
-                logger.info("Enabled FilteringSpanExporter with local-only rules")
-        except Exception as e:
-            logger.warning("Failed to enable FilteringSpanExporter: %s", e)
-        # Add span processors: first instrumentation wrapper, then session processor
-        from netra.processors import (
-            InstrumentationSpanProcessor,
-            LocalFilteringSpanProcessor,
-            ScrubbingSpanProcessor,
-            SessionSpanProcessor,
-        )
-
-        # Apply local filtering propagation first so later processors and spans see attributes
-        provider.add_span_processor(LocalFilteringSpanProcessor())
-        provider.add_span_processor(InstrumentationSpanProcessor())
-        provider.add_span_processor(SessionSpanProcessor())
-
-        # Add scrubbing processor if enabled
-        if self.cfg.enable_scrubbing:
-            provider.add_span_processor(ScrubbingSpanProcessor())  # type: ignore[no-untyped-call]
-
-        # Install appropriate span processor
-        if self.cfg.disable_batch:
-            provider.add_span_processor(SimpleSpanProcessor(exporter))
-        else:
-            provider.add_span_processor(BatchSpanProcessor(exporter))
-
-        # Set global tracer provider
-        trace.set_tracer_provider(provider)
-        logger.info(
-            "Netra TracerProvider initialized: endpoint=%s, disable_batch=%s",
-            self.cfg.otlp_endpoint,
-            self.cfg.disable_batch,
-        )
+                provider.add_span_processor(BatchSpanProcessor(exporter))
+
+            setattr(provider, "_netra_processors_installed", True)
+
+            logger.info(
+                "Netra initialized: endpoint=%s, disable_batch=%s",
+                self.cfg.otlp_endpoint,
+                self.cfg.disable_batch,
+            )
 
     def _format_endpoint(self, endpoint: str) -> str:
         """Format the OTLP endpoint URL to ensure it ends with '/v1/traces'.

netra/version.py

@@ -1 +1 @@
-__version__ = "0.1.46"
+__version__ = "0.1.47"

{netra_sdk-0.1.46.dist-info → netra_sdk-0.1.47.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: netra-sdk
-Version: 0.1.46
+Version: 0.1.47
 Summary: A Python SDK for AI application observability that provides OpenTelemetry-based monitoring, tracing, and PII protection for LLM and vector database applications. Enables easy instrumentation, session tracking, and privacy-focused data collection for AI systems in production environments.
 License-Expression: Apache-2.0
 License-File: LICENCE

{netra_sdk-0.1.46.dist-info → netra_sdk-0.1.47.dist-info}/RECORD

@@ -1,10 +1,10 @@
-netra/__init__.py,sha256=tbj0UsUHKMG8RHJ58Y0tCvPVDS_XkGb7sF_xM1lxJEY,10454
+netra/__init__.py,sha256=vH9J2iPKtx8j9-dWhDroUqRq10qfqHaBurMl11c4g6Q,10590
 netra/anonymizer/__init__.py,sha256=KeGPPZqKVZbtkbirEKYTYhj6aZHlakjdQhD7QHqBRio,133
 netra/anonymizer/anonymizer.py,sha256=IcrYkdwWrFauGWUeAW-0RwrSUM8VSZCFNtoywZhvIqU,3778
 netra/anonymizer/base.py,sha256=ytPxHCUD2OXlEY6fNTuMmwImNdIjgj294I41FIgoXpU,5946
 netra/anonymizer/fp_anonymizer.py,sha256=_6svIYmE0eejdIMkhKBUWCNjGtGimtrGtbLvPSOp8W4,6493
 netra/config.py,sha256=RqLul2vlNHHKGU31OQIJTUpcKMSmVse9IlGFwImW6sE,7032
-netra/decorators.py,sha256=NHJZeZo3LEuOxCz-lfz3j74o6CS0jS8JBRw2LvoeeWE,18389
+netra/decorators.py,sha256=b6cNRJVUvroGv97NVE-psMZzL-Upl0X2m63_l_-VBdQ,18433
 netra/exceptions/__init__.py,sha256=uDgcBxmC4WhdS7HRYQk_TtJyxH1s1o6wZmcsnSHLAcM,174
 netra/exceptions/injection.py,sha256=ke4eUXRYUFJkMZgdSyPPkPt5PdxToTI6xLEBI0hTWUQ,1332
 netra/exceptions/pii.py,sha256=MT4p_x-zH3VtYudTSxw1Z9qQZADJDspq64WrYqSWlZc,2438
@@ -49,11 +49,11 @@ netra/processors/scrubbing_span_processor.py,sha256=dJ86Ncmjvmrhm_uAdGTwcGvRpZbV
 netra/processors/session_span_processor.py,sha256=qcsBl-LnILWefsftI8NQhXDGb94OWPc8LvzhVA0JS_c,2432
 netra/scanner.py,sha256=kyDpeZiscCPb6pjuhS-sfsVj-dviBFRepdUWh0sLoEY,11554
 netra/session_manager.py,sha256=jxA62zAgiTsuTyV_UuPkVb2W1Uieb7I5jWsYiJ6jSxk,13897
-netra/span_wrapper.py,sha256=80-0MkAw7AOQg0u7dj2YfXfnuUQDE8ymsGNzh6y6JtA,10102
-netra/tracer.py,sha256=IPVYMc4x74XZJeKvCfV6b0X9mUHGvsssUzLnRvFPV6M,4629
+netra/span_wrapper.py,sha256=x5ejtMwD40eMRbeYOfsE2GQGrqZcjZz_sZOuLIeZ__8,10118
+netra/tracer.py,sha256=BXlEEOQ7ou5zd2Bf5cUFp6vLoMJLgBywtxfUBr9Di-Q,5175
 netra/utils.py,sha256=FblSzI8qMTfEbusakGBKE9CNELW0GEBHl09mPPxgI-w,2521
-netra/version.py,sha256=X3e_85I7oZGwZD8nW9SBKEUbQU7-_3W9FXuicrfxHjc,23
-netra_sdk-0.1.46.dist-info/METADATA,sha256=QWfOewRPrRyNlamWqdvuS-1U01UocBvxcRZQ_H6Qmvw,28208
-netra_sdk-0.1.46.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-netra_sdk-0.1.46.dist-info/licenses/LICENCE,sha256=8B_UoZ-BAl0AqiHAHUETCgd3I2B9yYJ1WEQtVb_qFMA,11359
-netra_sdk-0.1.46.dist-info/RECORD,,
+netra/version.py,sha256=BqdH88p7_x5NtwJCtqUPLKt1fAJF1mVKUoKH7vlX5dQ,23
+netra_sdk-0.1.47.dist-info/METADATA,sha256=JbzzZzE-IzVy2h8fNa0QT5doUkjgpvJXHgnxf44zj0Y,28208
+netra_sdk-0.1.47.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+netra_sdk-0.1.47.dist-info/licenses/LICENCE,sha256=8B_UoZ-BAl0AqiHAHUETCgd3I2B9yYJ1WEQtVb_qFMA,11359
+netra_sdk-0.1.47.dist-info/RECORD,,