netra-sdk 0.1.27__tar.gz → 0.1.28__tar.gz

{netra_sdk-0.1.27 → netra_sdk-0.1.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: netra-sdk
-Version: 0.1.27
+Version: 0.1.28
 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: Apache-2.0
 Keywords: netra,tracing,observability,sdk,ai,llm,vector,database

{netra_sdk-0.1.27 → netra_sdk-0.1.28}/netra/__init__.py

@@ -12,7 +12,10 @@ from .session_manager import SessionManager
 from .span_wrapper import ActionModel, SpanWrapper, UsageModel
 from .tracer import Tracer
 
+# Package-level logger. Attach NullHandler by default so library does not emit logs
+# unless explicitly enabled by the user via debug_mode.
 logger = logging.getLogger(__name__)
+logger.addHandler(logging.NullHandler())
 
 
 class Netra:
@@ -42,6 +45,7 @@ class Netra:
         headers: Optional[str] = None,
         disable_batch: Optional[bool] = None,
         trace_content: Optional[bool] = None,
+        debug_mode: Optional[bool] = None,
         resource_attributes: Optional[Dict[str, Any]] = None,
         environment: Optional[str] = None,
         instruments: Optional[Set[NetraInstruments]] = None,
@@ -61,10 +65,31 @@ class Netra:
                 headers=headers,
                 disable_batch=disable_batch,
                 trace_content=trace_content,
+                debug_mode=debug_mode,
                 resource_attributes=resource_attributes,
                 environment=environment,
             )
 
+            # Configure package logging based on debug mode
+            pkg_logger = logging.getLogger("netra")
+            # Prevent propagating to root to avoid duplicate logs
+            pkg_logger.propagate = False
+            # Clear existing handlers to avoid duplicates across repeated init attempts
+            pkg_logger.handlers.clear()
+            if cfg.debug_mode:
+                pkg_logger.setLevel(logging.DEBUG)
+                handler = logging.StreamHandler()
+                formatter = logging.Formatter(
+                    fmt="%(asctime)s | %(levelname)s | %(name)s | %(message)s",
+                    datefmt="%Y-%m-%d %H:%M:%S",
+                )
+                handler.setFormatter(formatter)
+                pkg_logger.addHandler(handler)
+            else:
+                # Silence SDK logs entirely unless debug is enabled
+                pkg_logger.setLevel(logging.CRITICAL)
+                pkg_logger.addHandler(logging.NullHandler())
+
             # Initialize tracer (OTLP exporter, span processor, resource)
             Tracer(cfg)
 

{netra_sdk-0.1.27 → netra_sdk-0.1.28}/netra/config.py

@@ -16,6 +16,7 @@ class Config:
       - headers:                 Additional headers (W3C Correlation-Context format)
       - disable_batch:           Whether to disable batch span processor (bool)
       - trace_content:           Whether to capture prompt/completion content (bool)
+      - debug_mode:              Whether to enable SDK logging; default False (bool)
       - resource_attributes:     Custom resource attributes dict (e.g., {'env': 'prod', 'version': '1.0.0'})
     """
 
@@ -30,6 +31,7 @@ class Config:
         headers: Optional[str] = None,
         disable_batch: Optional[bool] = None,
         trace_content: Optional[bool] = None,
+        debug_mode: Optional[bool] = None,
         resource_attributes: Optional[Dict[str, Any]] = None,
         environment: Optional[str] = None,
     ):
@@ -91,6 +93,13 @@ class Config:
         else:
             os.environ["TRACELOOP_TRACE_CONTENT"] = "true"
 
+        # Debug mode: enable SDK logging only when True. Default False.
+        if debug_mode is not None:
+            self.debug_mode = debug_mode
+        else:
+            env_dbg = os.getenv("NETRA_DEBUG")
+            self.debug_mode = True if (env_dbg is not None and env_dbg.lower() in ("1", "true")) else False
+
         # 7. Environment: param override, else env
         if environment is not None:
             self.environment = environment

netra_sdk-0.1.28/netra/version.py

@@ -0,0 +1 @@
+__version__ = "0.1.28"

{netra_sdk-0.1.27 → netra_sdk-0.1.28}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "netra-sdk"
-version = "0.1.27"
+version = "0.1.28"
 description = "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."
 authors = [
     {name = "Sooraj Thomas",email = "sooraj@keyvalue.systems"}

netra_sdk-0.1.27/netra/version.py

@@ -1 +0,0 @@
-__version__ = "0.1.27"