netra-sdk 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

netra/instrumentation/instruments.py

@@ -13,6 +13,54 @@ class CustomInstruments(Enum):
     WEAVIATEDB = "weaviate_db"
     GOOGLE_GENERATIVEAI = "google_genai"
     FASTAPI = "fastapi"
+    AIO_PIKA = "aio_pika"
+    AIOHTTP_SERVER = "aiohttp_server"
+    AIOKAFKA = "aiokafka"
+    AIOPG = "aiopg"
+    ASGI = "asgi"
+    ASYNCCLICK = "asyncclick"
+    ASYNCIO = "asyncio"
+    ASYNCPG = "asyncpg"
+    AWS_LAMBDA = "aws_lambda"
+    BOTO = "boto"
+    BOTO3SQS = "boto3sqs"
+    BOTOCORE = "botocore"
+    CASSANDRA = "cassandra"
+    CELERY = "celery"
+    CLICK = "click"
+    CONFLUENT_KAFKA = "confluent_kafka"
+    DBAPI = "dbapi"
+    DJANGO = "django"
+    ELASTICSEARCH = "elasticsearch"
+    FALCON = "falcon"
+    FLASK = "flask"
+    GRPC = "grpc"
+    JINJA2 = "jinja2"
+    KAFKA_PYTHON = "kafka_python"
+    LOGGING = "logging"
+    MYSQL = "mysql"
+    MYSQLCLIENT = "mysqlclient"
+    PIKA = "pika"
+    PSYCOPG = "psycopg"
+    PSYCOPG2 = "psycopg2"
+    PYMEMCACHE = "pymemcache"
+    PYMONGO = "pymongo"
+    PYMSSQL = "pymssql"
+    PYMYSQL = "pymysql"
+    PYRAMID = "pyramid"
+    REDIS = "redis"
+    REMOULADE = "remoulade"
+    REQUESTS = "requests"
+    SQLALCHEMY = "sqlalchemy"
+    SQLITE3 = "sqlite3"
+    STARLETTE = "starlette"
+    SYSTEM_METRICS = "system_metrics"
+    THREADING = "threading"
+    TORNADO = "tornado"
+    TORTOISEORM = "tortoiseorm"
+    URLLIB = "urllib"
+    URLLIB3 = "urllib3"
+    WSGI = "wsgi"
 
 
 class NetraInstruments(Enum):
@@ -42,37 +90,81 @@ NetraInstruments follows the given structure. Refer this for usage within Netra
 
 class InstrumentSet(Enum):
     AIOHTTP = "aiohttp"
+    AIOHTTP_SERVER = "aiohttp_server"
+    AIO_PIKA = "aio_pika"
+    AIOKAFKA = "aiokafka"
+    AIOPG = "aiopg"
     ALEPHALPHA = "alephalpha"
     ANTHROPIC = "anthropic"
+    ASGI = "asgi"
+    ASYNCCLICK = "asyncclick"
+    ASYNCIO = "asyncio"
+    ASYNCPG = "asyncpg"
+    AWS_LAMBDA = "aws_lambda"
     BEDROCK = "bedrock"
+    BOTO = "boto"
+    BOTO3SQS = "boto3sqs"
+    BOTOCORE = "botocore"
+    CASSANDRA = "cassandra"
+    CELERY = "celery"
     CHROMA = "chroma"
+    CLICK = "click"
     COHEREAI = "cohere_ai"
+    CONFLUENT_KAFKA = "confluent_kafka"
     CREW = "crew"
+    DBAPI = "dbapi"
+    DJANGO = "django"
+    ELASTICSEARCH = "elasticsearch"
+    FALCON = "falcon"
     FASTAPI = "fastapi"
+    FLASK = "flask"
     GOOGLE_GENERATIVEAI = "google_genai"
     GROQ = "groq"
+    GRPC = "grpc"
     HAYSTACK = "haystack"
     HTTPX = "httpx"
+    JINJA2 = "jinja2"
+    KAFKA_PYTHON = "kafka_python"
     LANCEDB = "lancedb"
     LANGCHAIN = "langchain"
     LLAMA_INDEX = "llama_index"
+    LOGGING = "logging"
     MARQO = "marqo"
     MCP = "mcp"
     MILVUS = "milvus"
     MISTRALAI = "mistral_ai"
+    MYSQL = "mysql"
+    MYSQLCLIENT = "mysqlclient"
     OLLAMA = "ollama"
     OPENAI = "openai"
+    PIKA = "pika"
     PINECONE = "pinecone"
+    PSYCOPG = "psycopg"
+    PSYCOPG2 = "psycopg2"
+    PYMEMCACHE = "pymemcache"
+    PYMONGO = "pymongo"
+    PYMSSQL = "pymssql"
     PYMYSQL = "pymysql"
+    PYRAMID = "pyramid"
     QDRANTDB = "qdrant_db"
     REDIS = "redis"
+    REMOULADE = "remoulade"
     REPLICATE = "replicate"
     REQUESTS = "requests"
     SAGEMAKER = "sagemaker"
+    SQLALCHEMY = "sqlalchemy"
+    SQLITE3 = "sqlite3"
+    STARLETTE = "starlette"
+    SYSTEM_METRICS = "system_metrics"
+    THREADING = "threading"
     TOGETHER = "together"
+    TORNADO = "tornado"
+    TORTOISEORM = "tortoiseorm"
     TRANSFORMERS = "transformers"
+    URLLIB = "urllib"
     URLLIB3 = "urllib3"
     VERTEXAI = "vertexai"
     WATSONX = "watsonx"
     WEAVIATEDB = "weaviate_db"
+    WSGI = "wsgi"
 """

netra/pii.py

@@ -26,7 +26,6 @@ DEFAULT_PII_PATTERNS: Dict[str, Pattern[str]] = {
 DEFAULT_ENTITIES: List[str] = [
     "CREDIT_CARD",
     "CRYPTO",
-    "DATE_TIME",
     "EMAIL_ADDRESS",
     "IBAN_CODE",
     "IP_ADDRESS",
@@ -42,16 +41,6 @@ DEFAULT_ENTITIES: List[str] = [
     "US_SSN",
     "UK_NHS",
     "UK_NINO",
-    "ES_NIF",
-    "ES_NIE",
-    "IT_FISCAL_CODE",
-    "IT_DRIVER_LICENSE",
-    "IT_VAT_CODE",
-    "IT_PASSPORT",
-    "IT_IDENTITY_CARD",
-    "PL_PESEL",
-    "SG_NRIC_FIN",
-    "SG_UEN",
     "AU_ABN",
     "AU_ACN",
     "AU_TFN",
@@ -61,7 +50,6 @@ DEFAULT_ENTITIES: List[str] = [
     "IN_VEHICLE_REGISTRATION",
     "IN_VOTER",
     "IN_PASSPORT",
-    "FI_PERSONAL_IDENTITY_CODE",
 ]
 
 

netra/session.py

@@ -7,6 +7,8 @@ from opentelemetry import trace
 from opentelemetry.trace import SpanKind, Status, StatusCode
 from opentelemetry.trace.propagation import set_span_in_context
 
+from netra.config import Config
+
 # Configure logging
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
@@ -19,9 +21,15 @@ class ATTRIBUTE:
     NEGATIVE_PROMPT = "negative_prompt"
     IMAGE_HEIGHT = "image_height"
     IMAGE_WIDTH = "image_width"
-    TOKENS = "tokens"
     CREDITS = "credits"
-    COST = "cost"
+    TOTAL_COST = "total_cost"
+    TOTAL_TOKENS = "total_tokens"
+    PROMPT_TOKENS_COST = "prompt_tokens_cost"
+    PROMPT_TOKENS = "prompt_tokens"
+    COMPLETION_TOKENS_COST = "completion_tokens_cost"
+    COMPLETION_TOKENS = "completion_tokens"
+    CACHED_TOKENS_COST = "cached_tokens_cost"
+    CACHED_TOKENS = "cached_tokens"
     STATUS = "status"
     DURATION_MS = "duration_ms"
     ERROR_MESSAGE = "error_message"
@@ -76,7 +84,7 @@ class Session:
 
         # Set duration
         if duration_ms is not None:
-            self.set_attribute(ATTRIBUTE.DURATION_MS, str(round(duration_ms, 2)))
+            self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.DURATION_MS}", str(round(duration_ms, 2)))
 
         # Handle status and errors
         if exc_type is None and self.status == "pending":
@@ -86,14 +94,14 @@ class Session:
         elif exc_type is not None:
             self.status = "error"
             self.error_message = str(exc_val)
-            self.set_attribute(ATTRIBUTE.ERROR_MESSAGE, self.error_message)
+            self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.ERROR_MESSAGE}", self.error_message)
             if self.span:
                 self.span.set_status(Status(StatusCode.ERROR, self.error_message))
                 if exc_val is not None:
                     self.span.record_exception(exc_val)
             logger.error(f"Session {self.name} failed: {self.error_message}")
 
-        self.set_attribute(ATTRIBUTE.STATUS, self.status)
+        self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.STATUS}", self.status)
 
         # Update span attributes with final values
         if self.span:
@@ -125,39 +133,63 @@ class Session:
 
     def set_prompt(self, prompt: str) -> "Session":
         """Set the input prompt."""
-        return self.set_attribute(ATTRIBUTE.PROMPT, prompt)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.PROMPT}", prompt)
 
     def set_negative_prompt(self, negative_prompt: str) -> "Session":
         """Set the negative prompt."""
-        return self.set_attribute(ATTRIBUTE.NEGATIVE_PROMPT, negative_prompt)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.NEGATIVE_PROMPT}", negative_prompt)
 
     def set_image_height(self, height: str) -> "Session":
         """Set the image height."""
-        return self.set_attribute(ATTRIBUTE.IMAGE_HEIGHT, height)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.IMAGE_HEIGHT}", height)
 
     def set_image_width(self, width: str) -> "Session":
         """Set the image width."""
-        return self.set_attribute(ATTRIBUTE.IMAGE_WIDTH, width)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.IMAGE_WIDTH}", width)
+
+    def set_total_tokens(self, tokens: str) -> "Session":
+        """Set the number of tokens used."""
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.TOTAL_TOKENS}", tokens)
+
+    def set_prompt_tokens_cost(self, cost: str) -> "Session":
+        """Set the number of tokens used."""
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.PROMPT_TOKENS_COST}", cost)
+
+    def set_prompt_tokens(self, tokens: str) -> "Session":
+        """Set the number of tokens used."""
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.PROMPT_TOKENS}", tokens)
+
+    def set_completion_tokens_cost(self, cost: str) -> "Session":
+        """Set the number of tokens used."""
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.COMPLETION_TOKENS_COST}", cost)
+
+    def set_completion_tokens(self, tokens: str) -> "Session":
+        """Set the number of tokens used."""
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.COMPLETION_TOKENS}", tokens)
+
+    def set_cached_tokens_cost(self, cost: str) -> "Session":
+        """Set the number of tokens used."""
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.CACHED_TOKENS_COST}", cost)
 
-    def set_tokens(self, tokens: str) -> "Session":
+    def set_cached_tokens(self, tokens: str) -> "Session":
         """Set the number of tokens used."""
-        return self.set_attribute(ATTRIBUTE.TOKENS, tokens)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.CACHED_TOKENS}", tokens)
 
     def set_credits(self, credits: str) -> "Session":
         """Set the number of credits used."""
-        return self.set_attribute(ATTRIBUTE.CREDITS, credits)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.CREDITS}", credits)
 
-    def set_cost(self, cost: str) -> "Session":
+    def set_total_cost(self, cost: str) -> "Session":
         """Set the cost of the operation."""
-        return self.set_attribute(ATTRIBUTE.COST, cost)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.TOTAL_COST}", cost)
 
     def set_model(self, model: str) -> "Session":
         """Set the model used."""
-        return self.set_attribute(ATTRIBUTE.MODEL, model)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.MODEL}", model)
 
     def set_llm_system(self, system: str) -> "Session":
         """Set the LLM system used."""
-        return self.set_attribute(ATTRIBUTE.LLM_SYSTEM, system)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.LLM_SYSTEM}", system)
 
     def set_error(self, error_message: str) -> "Session":
         """Manually set an error message."""
@@ -165,7 +197,7 @@ class Session:
         self.error_message = error_message
         if self.span:
             self.span.set_status(Status(StatusCode.ERROR, error_message))
-        return self.set_attribute(ATTRIBUTE.ERROR_MESSAGE, error_message)
+        return self.set_attribute(f"{Config.LIBRARY_NAME}.{ATTRIBUTE.ERROR_MESSAGE}", error_message)
 
     def set_success(self) -> "Session":
         """Manually mark the session as successful."""

netra/version.py

@@ -1 +1 @@
-__version__ = "0.1.0"
+__version__ = "0.1.2"

{netra_sdk-0.1.0.dist-info → netra_sdk-0.1.2.dist-info}/LICENCE

@@ -198,4 +198,4 @@
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License.
+   limitations under the License.

{netra_sdk-0.1.0.dist-info → netra_sdk-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: netra-sdk
-Version: 0.1.0
+Version: 0.1.2
 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
@@ -20,9 +20,54 @@ Classifier: Typing :: Typed
 Provides-Extra: llm-guard
 Requires-Dist: llm-guard (>=0.3.16,<0.4.0) ; extra == "llm-guard"
 Requires-Dist: opentelemetry-api (>=1.34.0,<2.0.0)
+Requires-Dist: opentelemetry-instrumentation-aio-pika (>=0.55b1,<1.0.0)
 Requires-Dist: opentelemetry-instrumentation-aiohttp-client (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-aiohttp-server (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-aiokafka (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-aiopg (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-asyncclick (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-asyncio (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-asyncpg (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-aws-lambda (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-boto (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-boto3sqs (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-botocore (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-cassandra (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-celery (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-click (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-confluent-kafka (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-django (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-elasticsearch (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-falcon (>=0.55b1,<1.0.0)
 Requires-Dist: opentelemetry-instrumentation-fastapi (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-flask (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-grpc (>=0.55b1,<1.0.0)
 Requires-Dist: opentelemetry-instrumentation-httpx (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-jinja2 (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-kafka-python (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-logging (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-mysql (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-mysqlclient (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pika (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-psycopg (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-psycopg2 (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pymemcache (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pymongo (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pymssql (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pymysql (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pyramid (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-redis (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-remoulade (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-requests (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-sqlalchemy (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-sqlite3 (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-starlette (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-system-metrics (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-threading (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-tornado (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-tortoiseorm (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-urllib (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-urllib3 (>=0.55b1,<1.0.0)
 Requires-Dist: opentelemetry-sdk (>=1.34.0,<2.0.0)
 Requires-Dist: presidio-analyzer (>=2.2.358,<3.0.0)
 Requires-Dist: traceloop-sdk (>=0.40.7,<0.41.0)
@@ -180,16 +225,47 @@ class CustomerSupportAgent:
 - **AIOHTTP** - Asynchronous HTTP client/server
 - **FastAPI** - Modern web framework for APIs
 - **Requests** - Popular HTTP library for Python
-- **urllib3** - Low-level HTTP client library
+- **Django** - High-level Python web framework
+- **Flask** - Lightweight WSGI web application framework
+- **Falcon** - High-performance Python web framework
+- **Pyramid** - Small, fast, down-to-earth Python web framework
+- **Starlette** - Lightweight ASGI framework/toolkit
+- **Tornado** - Asynchronous networking library and web framework
+- **gRPC** - High-performance, open-source universal RPC framework
+- **Urllib** - Standard Python HTTP client library
+- **Urllib3** - Powerful, user-friendly HTTP client for Python
 
 ### 🗄️ Database Clients
 
 - **PyMySQL** - Pure Python MySQL client
 - **Redis** - In-memory data structure store
+- **SQLAlchemy** - SQL toolkit and Object-Relational Mapper
+- **Psycopg** - Modern PostgreSQL database adapter for Python
+- **Pymongo** - Python driver for MongoDB
+- **Elasticsearch** - Distributed, RESTful search and analytics engine
+- **Cassandra** - Distributed NoSQL database
+- **PyMSSQL** - Simple Microsoft SQL Server client
+- **MySQL Connector** - Official MySQL driver
+- **Sqlite3** - Built-in SQL database engine
+- **Aiopg** - Asynchronous PostgreSQL client
+- **Asyncpg** - Fast asynchronous PostgreSQL client
+- **Pymemcache** - Comprehensive Memcached client
+- **Tortoise ORM** - Easy-to-use asyncio ORM
+
+### 📨 Messaging & Task Queues
+
+- **Celery** - Distributed task queue
+- **Pika** - Pure-Python implementation of the AMQP 0-9-1 protocol
+- **AIO Pika** - Asynchronous AMQP client
+- **Kafka-Python** - Python client for Apache Kafka
+- **AIOKafka** - Asynchronous Python client for Kafka
+- **Confluent-Kafka** - Confluent's Python client for Apache Kafka
+- **Boto3 SQS** - Amazon SQS client via Boto3
 
 ### 🔧 AI Frameworks & Orchestration
 
 - **LangChain** - Framework for developing LLM applications
+- **LangGraph** - Modern framework for LLM applications
 - **LlamaIndex** - Data framework for LLM applications
 - **Haystack** - End-to-end NLP framework
 - **CrewAI** - Multi-agent AI systems
@@ -364,6 +440,72 @@ with Netra.start_session("video_generation_task") as session:
 
 ## 🔧 Advanced Configuration
 
+### Environment Variables
+
+Netra SDK can be configured using the following environment variables:
+
+#### Netra-specific Variables
+
+| Variable Name | Description | Default |
+|---------------|-------------|---------|
+| `NETRA_APP_NAME` | Logical name for your service | Falls back to `OTEL_SERVICE_NAME` or `llm_tracing_service` |
+| `NETRA_OTLP_ENDPOINT` | URL for OTLP collector | Falls back to `OTEL_EXPORTER_OTLP_ENDPOINT` |
+| `NETRA_API_KEY` | API key for authentication | `None` |
+| `NETRA_HEADERS` | Additional headers in W3C Correlation-Context format | `None` |
+| `NETRA_DISABLE_BATCH` | Disable batch span processor (`true`/`false`) | `false` |
+| `NETRA_TRACE_CONTENT` | Whether to capture prompt/completion content (`true`/`false`) | `true` |
+| `NETRA_ENV` | Deployment environment (e.g., `prod`, `staging`, `dev`) | `local` |
+| `NETRA_RESOURCE_ATTRS` | JSON string of custom resource attributes | `{}` |
+
+#### Standard OpenTelemetry Variables
+
+| Variable Name | Description | Used When |
+|---------------|-------------|-----------|
+| `OTEL_SERVICE_NAME` | Logical name for your service | When `NETRA_APP_NAME` is not set |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | URL for OTLP collector | When `NETRA_OTLP_ENDPOINT` is not set |
+| `OTEL_EXPORTER_OTLP_HEADERS` | Additional headers for OTLP exporter | When `NETRA_HEADERS` is not set |
+| `OTEL_RESOURCE_ATTRIBUTES` | Additional resource attributes | When `NETRA_RESOURCE_ATTRS` is not set |
+
+### Configuration Precedence
+
+Configuration values are resolved in the following order (highest to lowest precedence):
+
+1. **Code Parameters**: Values passed directly to `Netra.init()`
+2. **Netra Environment Variables**: `NETRA_*` variables
+3. **OpenTelemetry Environment Variables**: Standard `OTEL_*` variables
+4. **Default Values**: Fallback values defined in the SDK
+
+This allows you to:
+- Override any setting directly in code for maximum control
+- Use Netra-specific environment variables for Netra-specific settings
+- Fall back to standard OpenTelemetry variables for compatibility
+- Rely on sensible defaults when no other configuration is provided
+
+**Example**:
+```bash
+export NETRA_APP_NAME="my-ai-service"
+export NETRA_OTLP_ENDPOINT="https://collector.example.com:4318"
+export NETRA_API_KEY="your-api-key-here"
+export NETRA_ENV="production"
+export NETRA_RESOURCE_ATTRS='{"team":"ai", "version":"1.0.0"}'
+```
+
+### Programmatic Configuration
+
+You can also configure the SDK programmatically when initializing:
+
+```python
+from netra import Netra
+
+Netra.init(
+    app_name="my-ai-service",
+    environment="production",
+    resource_attributes={"team": "ai", "version": "1.0.0"},
+    trace_content=True,
+    disable_batch=False
+)
+```
+
 ### Custom Instrumentation Selection
 
 Control which instrumentations are enabled:
@@ -434,6 +576,7 @@ Netra.init(app_name="Your App")
 - **📈 Rich Ecosystem**: Leverage the entire OpenTelemetry ecosystem
 
 
+
 ## 📚 Examples
 
 The SDK includes comprehensive examples in the `examples/` directory:
@@ -446,61 +589,52 @@ The SDK includes comprehensive examples in the `examples/` directory:
 
 ## 🧪 Tests
 
-The Netra SDK includes a comprehensive testing suite in the `tests/` directory. The tests are built using pytest and cover all major components of the SDK.
-
-### Test Structure
-
-- **conftest.py**: Contains shared fixtures, test utilities, and configuration for all tests
-- **test_netra_init.py**: Tests for the main Netra SDK initialization and configuration
-- **test_decorators.py**: Tests for workflow, agent, and task decorators
-- **test_input_scanner.py**: Tests for prompt injection scanning and security features
+Our test suite is built on `pytest` and is designed to ensure the reliability and stability of the Netra SDK. We follow comprehensive testing standards, including unit, integration, and thread-safety tests.
 
 ### Running Tests
 
-To run the full test suite:
+To run the complete test suite, use the following command from the root of the project:
 
 ```bash
 poetry run pytest
 ```
 
-To run specific test modules:
 
+### Run Specific Test File
+To run a specific test file, use the following command from the root of the project:
 ```bash
 poetry run pytest tests/test_netra_init.py
-poetry run pytest tests/test_decorators.py
 ```
 
-To run tests with coverage reporting:
+### Test Coverage
+
+To generate a test coverage report, you can run:
 
 ```bash
 poetry run pytest --cov=netra --cov-report=html
 ```
 
-### Test Fixtures
+This will create an `htmlcov` directory with a detailed report.
 
-The testing framework provides several useful fixtures:
+### Running Specific Test Categories
 
-- **reset_netra_state**: Automatically resets Netra state before and after each test
-- **clean_environment**: Provides a clean environment by temporarily clearing relevant environment variables
-- **mock_config**, **mock_tracer**, **mock_init_instrumentations**: Mock objects for testing components in isolation
-- **sample_config_params**, **sample_session_data**: Sample data for testing configuration and sessions
-
-### Test Categories
-
-Tests are organized using pytest markers:
-
-- **unit**: Unit tests for individual components
-- **integration**: Integration tests for component interactions
-- **thread_safety**: Tests for thread safety and concurrency
-
-To run tests by category:
+Tests are organized using `pytest` markers. You can run specific categories of tests as follows:
 
 ```bash
+# Run only unit tests (default)
 poetry run pytest -m unit
+
+# Run only integration tests
 poetry run pytest -m integration
+
+# Run only thread-safety tests
 poetry run pytest -m thread_safety
 ```
 
+For more detailed information on our testing strategy, fixtures, and best practices, please refer to the `README.md` file in the `tests` directory.
+
+
+
 ## 🛠️ Development Setup
 
 To set up your development environment for the Netra SDK, run the provided setup script:

{netra_sdk-0.1.0.dist-info → netra_sdk-0.1.2.dist-info}/RECORD

@@ -3,13 +3,13 @@ netra/anonymizer/__init__.py,sha256=KeGPPZqKVZbtkbirEKYTYhj6aZHlakjdQhD7QHqBRio,
 netra/anonymizer/anonymizer.py,sha256=1VeYAsFpF_tYDlqJF-Q82-ZXGOR4YWBqrKUsRw3qOrA,3539
 netra/anonymizer/base.py,sha256=ytPxHCUD2OXlEY6fNTuMmwImNdIjgj294I41FIgoXpU,5946
 netra/anonymizer/fp_anonymizer.py,sha256=_6svIYmE0eejdIMkhKBUWCNjGtGimtrGtbLvPSOp8W4,6493
-netra/config.py,sha256=TINQdJkl42-VRTj4Y1e5B2xGJz2J6I5_OvRNLyWesTc,4761
+netra/config.py,sha256=6aUG-BWWDOyptnTlEjOpB41n9xLmuo-XBAgs5GE5Tbg,4761
 netra/decorators.py,sha256=WX3EAvcZ_b-wUHO6UFXN07_J4H9shmrLSYPidYvTL5w,6257
 netra/exceptions/__init__.py,sha256=uDgcBxmC4WhdS7HRYQk_TtJyxH1s1o6wZmcsnSHLAcM,174
 netra/exceptions/injection.py,sha256=ke4eUXRYUFJkMZgdSyPPkPt5PdxToTI6xLEBI0hTWUQ,1332
 netra/exceptions/pii.py,sha256=MT4p_x-zH3VtYudTSxw1Z9qQZADJDspq64WrYqSWlZc,2438
 netra/input_scanner.py,sha256=bzP3s7YudGHQrIbUgQGrcIBEJ6CmOewzuYNSu75cVXM,4988
-netra/instrumentation/__init__.py,sha256=BxPhnyDKIdv-KZ2Y5dM5r8XD-xCXuMRLfvWkedtP07o,8985
+netra/instrumentation/__init__.py,sha256=CvoAQF_tHzDph-CAypPL-eBvaM53JDtJwDTHZ7XPPeE,41170
 netra/instrumentation/aiohttp/__init__.py,sha256=M1kuF0R3gKY5rlbhEC1AR13UWHelmfokluL2yFysKWc,14398
 netra/instrumentation/aiohttp/version.py,sha256=Zy-0Aukx-HS_Mo3NKPWg-hlUoWKDzS0w58gLoVtJec8,24
 netra/instrumentation/cohere/__init__.py,sha256=3XwmCAZwZiMkHdNN3YvcBOLsNCx80ymbU31TyMzv1IY,17685
@@ -20,23 +20,23 @@ netra/instrumentation/google_genai/utils.py,sha256=2OeSN5jUaMKF4x5zWiW65R1LB_a44
 netra/instrumentation/google_genai/version.py,sha256=Hww1duZrC8kYK7ThBSQVyz0HNOb0ys_o8Pln-wVQ1hI,23
 netra/instrumentation/httpx/__init__.py,sha256=w1su_eQP_w5ZJHq0Lf-4miF5zM4OOW0ItmRp0wi85Ew,19388
 netra/instrumentation/httpx/version.py,sha256=ZRQKbgDaGz_yuLk-cUKuk6ZBKCSRKZC8nQd041NRNXk,23
-netra/instrumentation/instruments.py,sha256=OjOURFfMKAEt1sWAORnys0XrI28-Ufn5ZmiQw6mUil8,1995
+netra/instrumentation/instruments.py,sha256=5U4r9XMMfjccd9BWHAbHMo1WcCUClnbU2oWTLAAqMw4,4345
 netra/instrumentation/mistralai/__init__.py,sha256=RE0b-rS6iXdoynJMFKHL9s97eYo5HghrJa013fR4ZhI,18910
 netra/instrumentation/mistralai/config.py,sha256=XCyo3mk30qkvqyCqeTrKwROahu0gcOEwmbDLOo53J5k,121
 netra/instrumentation/mistralai/utils.py,sha256=nhdIer5gJFxuGwg8FCT222hggDHeMQDhJctnDSwLqcc,894
 netra/instrumentation/mistralai/version.py,sha256=d6593s-XBNvVxri9lr2qLUDZQ3Zk3-VXHEwdb4pj8qA,22
 netra/instrumentation/weaviate/__init__.py,sha256=EOlpWxobOLHYKqo_kMct_7nu26x1hr8qkeG5_h99wtg,4330
 netra/instrumentation/weaviate/version.py,sha256=PiCZHjonujPbnIn0KmD3Yl68hrjPRG_oKe5vJF3mmG8,24
-netra/pii.py,sha256=yJK5rXPJaT8y0kecK7YWJMD2cCegH7RBjW76_8CNOrU,27259
+netra/pii.py,sha256=S7GnVzoNJEzKiUWnqN9bOCKPeNLsriztgB2E6Rx-yJU,27023
 netra/processors/__init__.py,sha256=f8Ck-uCdDwNgEvm3hm6I9wFSVlnRYjmSfrEIQkdBaZQ,218
 netra/processors/session_span_processor.py,sha256=uv-KL5lwil3C3wQGdYWiYQMHLBsXrt8hTy_ql6kUWXE,2171
 netra/processors/span_aggregation_processor.py,sha256=eOBAHTi5pgBCrnNthWGby0IY6b7iSUPAIFkDDmwLKOY,15579
 netra/scanner.py,sha256=wqjMZnEbVvrGMiUSI352grUyHpkk94oBfHfMiXPhpGU,3866
-netra/session.py,sha256=JuKwiIAw_jVfVK2RR2w1LZh4hmsvejg3DuA0krDVTTo,6812
+netra/session.py,sha256=Lsd7yps2YtjN7P10HsGN3bRZxufoeUnGxAH6Us8_l-Y,8734
 netra/session_manager.py,sha256=UusP3MRZlLeU4NtBVlXQ_sCgRg-LGleVdYPq5MwLvi8,3555
 netra/tracer.py,sha256=WZDBIpPp3oL8MkKBhlw0gxAXXSd1FY3bicLUKt2GNxc,3540
-netra/version.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
-netra_sdk-0.1.0.dist-info/LICENCE,sha256=tH_nFX38gvU3d7GmYORP4nIGi-4nUCHhdAtAuMiOIFU,11358
-netra_sdk-0.1.0.dist-info/METADATA,sha256=UNsQP5xIKz0NfsERaD2mRVD3-K51mKAci0CAWOTZ4vs,17655
-netra_sdk-0.1.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-netra_sdk-0.1.0.dist-info/RECORD,,
+netra/version.py,sha256=YvuYzWnKtqBb-IqG8HAu-nhIYAsgj9Vmc_b9o7vO-js,22
+netra_sdk-0.1.2.dist-info/LICENCE,sha256=8B_UoZ-BAl0AqiHAHUETCgd3I2B9yYJ1WEQtVb_qFMA,11359
+netra_sdk-0.1.2.dist-info/METADATA,sha256=0gBniDy_OiHTa27cSm0sZxWO68qF4ieLt5TKugq1Pbk,24630
+netra_sdk-0.1.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+netra_sdk-0.1.2.dist-info/RECORD,,