genai-otel-instrument 0.1.1.dev0__tar.gz → 0.1.2.dev0__tar.gz

genai_otel_instrument-0.1.2.dev0/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

{genai_otel_instrument-0.1.1.dev0 → genai_otel_instrument-0.1.2.dev0}/CHANGELOG.md

@@ -6,6 +6,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.1] - 2025-01-22
+
+### Added
+
+- **GPU Power Consumption Metric**
+  - Added `gen_ai.gpu.power` observable gauge metric to track real-time GPU power consumption
+  - Metric reports power usage in Watts with `gpu_id` and `gpu_name` attributes
+  - Automatically collected alongside existing GPU metrics (utilization, memory, temperature)
+  - Implementation in `genai_otel/gpu_metrics.py:97-102, 195-220`
+  - Added test coverage in `tests/test_gpu_metrics.py:244-266`
+  - Completes the GPU metrics suite with 5 total metrics: utilization, memory, temperature, power, and CO2 emissions
+
+### Fixed
+
+- **Test Fixes for HuggingFace and MistralAI Instrumentors**
+  - Fixed HuggingFace instrumentor tests (2 failures) - corrected tracer mocking to use `instrumentor.tracer.start_span()` instead of `config.tracer.start_as_current_span()`
+  - Fixed HuggingFace instrumentor tests - added `instrumentor.request_counter` mock for proper metrics assertion
+  - Fixed MistralAI instrumentor test - corrected wrapt module mocking by adding to `sys.modules` instead of invalid module-level patch
+  - All 395 tests now passing with zero failures
+  - Tests modified: `tests/instrumentors/test_huggingface_instrumentor.py`, `tests/instrumentors/test_mistralai_instrumentor.py`
+
 ## [0.1.0] - 2025-01-20
 
 **First Beta Release** 🎉
@@ -251,5 +272,6 @@ This is the first public release of genai-otel-instrument, a comprehensive OpenT
 - Fixed tests for base/redis and auto instrument (a701603)
 - Updated `test_auto_instrument.py` assertions to match new OTLP exporter configuration (exporters now read endpoint from environment variables instead of direct parameters)
 
-[Unreleased]: https://github.com/Mandark-droid/genai_otel_instrument/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/Mandark-droid/genai_otel_instrument/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/Mandark-droid/genai_otel_instrument/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/Mandark-droid/genai_otel_instrument/releases/tag/v0.1.0

{genai_otel_instrument-0.1.1.dev0 → genai_otel_instrument-0.1.2.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: genai-otel-instrument
-Version: 0.1.1.dev0
+Version: 0.1.2.dev0
 Summary: Comprehensive OpenTelemetry auto-instrumentation for LLM/GenAI applications
 Author-email: Kshitij Thakkar <kshitijthakkar@rocketmail.com>
 License: Apache-2.0
@@ -180,6 +180,26 @@ Dynamic: license-file
 
 # GenAI OpenTelemetry Auto-Instrumentation
 
+[![PyPI version](https://badge.fury.io/py/genai-otel-instrument.svg)](https://badge.fury.io/py/genai-otel-instrument)
+[![Python Versions](https://img.shields.io/pypi/pyversions/genai-otel-instrument.svg)](https://pypi.org/project/genai-otel-instrument/)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Downloads](https://static.pepy.tech/badge/genai-otel-instrument)](https://pepy.tech/project/genai-otel-instrument)
+[![Downloads/Month](https://static.pepy.tech/badge/genai-otel-instrument/month)](https://pepy.tech/project/genai-otel-instrument)
+
+[![GitHub Stars](https://img.shields.io/github/stars/Mandark-droid/genai_otel_instrument?style=social)](https://github.com/Mandark-droid/genai_otel_instrument)
+[![GitHub Forks](https://img.shields.io/github/forks/Mandark-droid/genai_otel_instrument?style=social)](https://github.com/Mandark-droid/genai_otel_instrument)
+[![GitHub Issues](https://img.shields.io/github/issues/Mandark-droid/genai_otel_instrument)](https://github.com/Mandark-droid/genai_otel_instrument/issues)
+[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/Mandark-droid/genai_otel_instrument)](https://github.com/Mandark-droid/genai_otel_instrument/pulls)
+
+[![Code Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen.svg)](https://github.com/Mandark-droid/genai_otel_instrument)
+[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)
+[![Type Checked: mypy](https://img.shields.io/badge/type%20checked-mypy-blue.svg)](http://mypy-lang.org/)
+
+[![OpenTelemetry](https://img.shields.io/badge/OpenTelemetry-1.20%2B-blueviolet)](https://opentelemetry.io/)
+[![Semantic Conventions](https://img.shields.io/badge/OTel%20Semconv-GenAI%20v1.28-orange)](https://opentelemetry.io/docs/specs/semconv/gen-ai/)
+[![CI/CD](https://img.shields.io/badge/CI%2FCD-GitHub%20Actions-2088FF?logo=github-actions&logoColor=white)](https://github.com/Mandark-droid/genai_otel_instrument/actions)
+
 Production-ready OpenTelemetry instrumentation for GenAI/LLM applications with zero-code setup.
 
 ## Features
@@ -188,7 +208,7 @@ Production-ready OpenTelemetry instrumentation for GenAI/LLM applications with z
 🤖 **15+ LLM Providers** - OpenAI, Anthropic, Google, AWS, Azure, and more
 🔧 **MCP Tool Support** - Auto-instrument databases, APIs, caches, vector DBs
 💰 **Cost Tracking** - Automatic cost calculation per request
-🎮 **GPU Metrics** - Real-time GPU utilization, memory, temperature
+🎮 **GPU Metrics** - Real-time GPU utilization, memory, temperature, power
 📊 **Complete Observability** - Traces, metrics, and rich span attributes
 ➕ **Service Instance ID & Environment** - Identify your services and environments
 ⏱️ **Configurable Exporter Timeout** - Set timeout for OTLP exporter
@@ -268,7 +288,7 @@ Every LLM call, database query, API request, and vector search is traced with fu
 ### Metrics
 
 **GenAI Metrics:**
-- `gen_ai.requests` - Request counts by provider/model
+- `gen_ai.requests` - Request counts by provider and model
 - `gen_ai.client.token.usage` - Token usage (prompt/completion)
 - `gen_ai.client.operation.duration` - Request latency histogram (optimized buckets for LLM workloads)
 - `gen_ai.usage.cost` - Total estimated costs in USD
@@ -278,7 +298,7 @@ Every LLM call, database query, API request, and vector search is traced with fu
 - `gen_ai.usage.cost.cache_read` - Cache read cost (Anthropic)
 - `gen_ai.usage.cost.cache_write` - Cache write cost (Anthropic)
 - `gen_ai.client.errors` - Error counts by operation and type
-- `gen_ai.gpu.*` - GPU utilization, memory, temperature (ObservableGauges)
+- `gen_ai.gpu.*` - GPU utilization, memory, temperature, power (ObservableGauges)
 - `gen_ai.co2.emissions` - CO2 emissions tracking (opt-in)
 - `gen_ai.server.ttft` - Time to First Token for streaming responses (histogram, 1ms-10s buckets)
 - `gen_ai.server.tbt` - Time Between Tokens for streaming responses (histogram, 10ms-2.5s buckets)
@@ -459,5 +479,168 @@ genai-otel-instrument/
         └── (other mcp files)
 ```
 
+## Roadmap
+
+### Next Release (v0.2.0) - Q1 2026
+
+We're planning significant enhancements for the next major release, focusing on evaluation metrics and safety guardrails alongside completing OpenTelemetry semantic convention compliance.
+
+#### 🎯 Evaluation & Monitoring
+
+**LLM Output Quality Metrics**
+- **Bias Detection** - Automatically detect and measure bias in LLM responses
+  - Gender, racial, political, and cultural bias detection
+  - Bias score metrics with configurable thresholds
+  - Integration with fairness libraries (e.g., Fairlearn, AIF360)
+
+- **Toxicity Detection** - Monitor and alert on toxic or harmful content
+  - Perspective API integration for toxicity scoring
+  - Custom toxicity models support
+  - Real-time toxicity metrics and alerts
+  - Configurable severity levels
+
+- **Hallucination Detection** - Track factual accuracy and groundedness
+  - Fact-checking against provided context
+  - Citation validation for RAG applications
+  - Confidence scoring for generated claims
+  - Hallucination rate metrics by model and use case
+
+**Implementation:**
+```python
+import genai_otel
+
+# Enable evaluation metrics
+genai_otel.instrument(
+    enable_bias_detection=True,
+    enable_toxicity_detection=True,
+    enable_hallucination_detection=True,
+
+    # Configure thresholds
+    bias_threshold=0.7,
+    toxicity_threshold=0.5,
+    hallucination_threshold=0.8
+)
+```
+
+**Metrics Added:**
+- `gen_ai.eval.bias_score` - Bias detection scores (histogram)
+- `gen_ai.eval.toxicity_score` - Toxicity scores (histogram)
+- `gen_ai.eval.hallucination_score` - Hallucination probability (histogram)
+- `gen_ai.eval.violations` - Count of threshold violations by type
+
+#### 🛡️ Safety Guardrails
+
+**Input/Output Filtering**
+- **Prompt Injection Detection** - Protect against prompt injection attacks
+  - Pattern-based detection (jailbreaking attempts)
+  - ML-based classifier for sophisticated attacks
+  - Real-time blocking with configurable policies
+  - Attack attempt metrics and logging
+
+- **Restricted Topics** - Block sensitive or inappropriate topics
+  - Configurable topic blacklists (legal, medical, financial advice)
+  - Industry-specific content filters
+  - Topic detection with confidence scoring
+  - Custom topic definition support
+
+- **Sensitive Information Protection** - Prevent PII leakage
+  - PII detection (emails, phone numbers, SSN, credit cards)
+  - Automatic redaction or blocking
+  - Compliance mode (GDPR, HIPAA, PCI-DSS)
+  - Data leak prevention metrics
+
+**Implementation:**
+```python
+import genai_otel
+
+# Configure guardrails
+genai_otel.instrument(
+    enable_prompt_injection_detection=True,
+    enable_restricted_topics=True,
+    enable_sensitive_info_detection=True,
+
+    # Custom configuration
+    restricted_topics=["medical_advice", "legal_advice", "financial_advice"],
+    pii_detection_mode="block",  # or "redact", "warn"
+
+    # Callbacks for custom handling
+    on_guardrail_violation=my_violation_handler
+)
+```
+
+**Metrics Added:**
+- `gen_ai.guardrail.prompt_injection_detected` - Injection attempts blocked
+- `gen_ai.guardrail.restricted_topic_blocked` - Restricted topic violations
+- `gen_ai.guardrail.pii_detected` - PII detection events
+- `gen_ai.guardrail.violations` - Total guardrail violations by type
+
+**Span Attributes:**
+- `gen_ai.guardrail.violation_type` - Type of violation detected
+- `gen_ai.guardrail.violation_severity` - Severity level (low, medium, high, critical)
+- `gen_ai.guardrail.blocked` - Whether request was blocked (boolean)
+- `gen_ai.eval.bias_categories` - Detected bias types (array)
+- `gen_ai.eval.toxicity_categories` - Toxicity categories (array)
+
+#### 📊 Enhanced OpenTelemetry Compliance
+
+Completing remaining items from [OTEL_SEMANTIC_GAP_ANALYSIS_AND_IMPLEMENTATION_PLAN.md](OTEL_SEMANTIC_GAP_ANALYSIS_AND_IMPLEMENTATION_PLAN.md):
+
+**Phase 4: Optional Enhancements**
+- ✅ Session & User Tracking - Track sessions and users across requests
+  ```python
+  genai_otel.instrument(
+      session_id_extractor=lambda ctx: ctx.get("session_id"),
+      user_id_extractor=lambda ctx: ctx.get("user_id")
+  )
+  ```
+
+- ✅ RAG/Embedding Attributes - Enhanced observability for retrieval-augmented generation
+  - `embedding.model_name` - Embedding model used
+  - `embedding.vector_dimensions` - Vector dimensions
+  - `retrieval.documents.{i}.document.id` - Retrieved document IDs
+  - `retrieval.documents.{i}.document.score` - Relevance scores
+  - `retrieval.documents.{i}.document.content` - Document content (truncated)
+
+- ✅ Agent Workflow Tracking - Better support for agentic workflows
+  - `agent.name` - Agent identifier
+  - `agent.iteration` - Current iteration number
+  - `agent.action` - Action taken
+  - `agent.observation` - Observation received
+
+#### 🔄 Migration Support
+
+**Backward Compatibility:**
+- All new features are opt-in via configuration
+- Existing instrumentation continues to work unchanged
+- Gradual migration path for new semantic conventions
+
+**Version Support:**
+- Python 3.9+ (evaluation features require 3.10+)
+- OpenTelemetry SDK 1.20.0+
+- Backward compatible with existing dashboards
+
+### Future Releases
+
+**v0.3.0 - Advanced Analytics**
+- Custom metric aggregations
+- Cost optimization recommendations
+- Automated performance regression detection
+- A/B testing support for prompts
+
+**v0.4.0 - Enterprise Features**
+- Multi-tenancy support
+- Role-based access control for telemetry
+- Advanced compliance reporting
+- SLA monitoring and alerting
+
+**Community Feedback**
+
+We welcome feedback on our roadmap! Please:
+- Open issues for feature requests
+- Join discussions on prioritization
+- Share your use cases and requirements
+
+See [Contributing.md](Contributing.md) for how to get involved.
+
 ## License
 Apache-2.0 license

{genai_otel_instrument-0.1.1.dev0 → genai_otel_instrument-0.1.2.dev0}/README.md

@@ -1,5 +1,25 @@
 # GenAI OpenTelemetry Auto-Instrumentation
 
+[![PyPI version](https://badge.fury.io/py/genai-otel-instrument.svg)](https://badge.fury.io/py/genai-otel-instrument)
+[![Python Versions](https://img.shields.io/pypi/pyversions/genai-otel-instrument.svg)](https://pypi.org/project/genai-otel-instrument/)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Downloads](https://static.pepy.tech/badge/genai-otel-instrument)](https://pepy.tech/project/genai-otel-instrument)
+[![Downloads/Month](https://static.pepy.tech/badge/genai-otel-instrument/month)](https://pepy.tech/project/genai-otel-instrument)
+
+[![GitHub Stars](https://img.shields.io/github/stars/Mandark-droid/genai_otel_instrument?style=social)](https://github.com/Mandark-droid/genai_otel_instrument)
+[![GitHub Forks](https://img.shields.io/github/forks/Mandark-droid/genai_otel_instrument?style=social)](https://github.com/Mandark-droid/genai_otel_instrument)
+[![GitHub Issues](https://img.shields.io/github/issues/Mandark-droid/genai_otel_instrument)](https://github.com/Mandark-droid/genai_otel_instrument/issues)
+[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/Mandark-droid/genai_otel_instrument)](https://github.com/Mandark-droid/genai_otel_instrument/pulls)
+
+[![Code Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen.svg)](https://github.com/Mandark-droid/genai_otel_instrument)
+[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)
+[![Type Checked: mypy](https://img.shields.io/badge/type%20checked-mypy-blue.svg)](http://mypy-lang.org/)
+
+[![OpenTelemetry](https://img.shields.io/badge/OpenTelemetry-1.20%2B-blueviolet)](https://opentelemetry.io/)
+[![Semantic Conventions](https://img.shields.io/badge/OTel%20Semconv-GenAI%20v1.28-orange)](https://opentelemetry.io/docs/specs/semconv/gen-ai/)
+[![CI/CD](https://img.shields.io/badge/CI%2FCD-GitHub%20Actions-2088FF?logo=github-actions&logoColor=white)](https://github.com/Mandark-droid/genai_otel_instrument/actions)
+
 Production-ready OpenTelemetry instrumentation for GenAI/LLM applications with zero-code setup.
 
 ## Features
@@ -8,7 +28,7 @@ Production-ready OpenTelemetry instrumentation for GenAI/LLM applications with z
 🤖 **15+ LLM Providers** - OpenAI, Anthropic, Google, AWS, Azure, and more
 🔧 **MCP Tool Support** - Auto-instrument databases, APIs, caches, vector DBs
 💰 **Cost Tracking** - Automatic cost calculation per request
-🎮 **GPU Metrics** - Real-time GPU utilization, memory, temperature
+🎮 **GPU Metrics** - Real-time GPU utilization, memory, temperature, power
 📊 **Complete Observability** - Traces, metrics, and rich span attributes
 ➕ **Service Instance ID & Environment** - Identify your services and environments
 ⏱️ **Configurable Exporter Timeout** - Set timeout for OTLP exporter
@@ -88,7 +108,7 @@ Every LLM call, database query, API request, and vector search is traced with fu
 ### Metrics
 
 **GenAI Metrics:**
-- `gen_ai.requests` - Request counts by provider/model
+- `gen_ai.requests` - Request counts by provider and model
 - `gen_ai.client.token.usage` - Token usage (prompt/completion)
 - `gen_ai.client.operation.duration` - Request latency histogram (optimized buckets for LLM workloads)
 - `gen_ai.usage.cost` - Total estimated costs in USD
@@ -98,7 +118,7 @@ Every LLM call, database query, API request, and vector search is traced with fu
 - `gen_ai.usage.cost.cache_read` - Cache read cost (Anthropic)
 - `gen_ai.usage.cost.cache_write` - Cache write cost (Anthropic)
 - `gen_ai.client.errors` - Error counts by operation and type
-- `gen_ai.gpu.*` - GPU utilization, memory, temperature (ObservableGauges)
+- `gen_ai.gpu.*` - GPU utilization, memory, temperature, power (ObservableGauges)
 - `gen_ai.co2.emissions` - CO2 emissions tracking (opt-in)
 - `gen_ai.server.ttft` - Time to First Token for streaming responses (histogram, 1ms-10s buckets)
 - `gen_ai.server.tbt` - Time Between Tokens for streaming responses (histogram, 10ms-2.5s buckets)
@@ -279,5 +299,168 @@ genai-otel-instrument/
         └── (other mcp files)
 ```
 
+## Roadmap
+
+### Next Release (v0.2.0) - Q1 2026
+
+We're planning significant enhancements for the next major release, focusing on evaluation metrics and safety guardrails alongside completing OpenTelemetry semantic convention compliance.
+
+#### 🎯 Evaluation & Monitoring
+
+**LLM Output Quality Metrics**
+- **Bias Detection** - Automatically detect and measure bias in LLM responses
+  - Gender, racial, political, and cultural bias detection
+  - Bias score metrics with configurable thresholds
+  - Integration with fairness libraries (e.g., Fairlearn, AIF360)
+
+- **Toxicity Detection** - Monitor and alert on toxic or harmful content
+  - Perspective API integration for toxicity scoring
+  - Custom toxicity models support
+  - Real-time toxicity metrics and alerts
+  - Configurable severity levels
+
+- **Hallucination Detection** - Track factual accuracy and groundedness
+  - Fact-checking against provided context
+  - Citation validation for RAG applications
+  - Confidence scoring for generated claims
+  - Hallucination rate metrics by model and use case
+
+**Implementation:**
+```python
+import genai_otel
+
+# Enable evaluation metrics
+genai_otel.instrument(
+    enable_bias_detection=True,
+    enable_toxicity_detection=True,
+    enable_hallucination_detection=True,
+
+    # Configure thresholds
+    bias_threshold=0.7,
+    toxicity_threshold=0.5,
+    hallucination_threshold=0.8
+)
+```
+
+**Metrics Added:**
+- `gen_ai.eval.bias_score` - Bias detection scores (histogram)
+- `gen_ai.eval.toxicity_score` - Toxicity scores (histogram)
+- `gen_ai.eval.hallucination_score` - Hallucination probability (histogram)
+- `gen_ai.eval.violations` - Count of threshold violations by type
+
+#### 🛡️ Safety Guardrails
+
+**Input/Output Filtering**
+- **Prompt Injection Detection** - Protect against prompt injection attacks
+  - Pattern-based detection (jailbreaking attempts)
+  - ML-based classifier for sophisticated attacks
+  - Real-time blocking with configurable policies
+  - Attack attempt metrics and logging
+
+- **Restricted Topics** - Block sensitive or inappropriate topics
+  - Configurable topic blacklists (legal, medical, financial advice)
+  - Industry-specific content filters
+  - Topic detection with confidence scoring
+  - Custom topic definition support
+
+- **Sensitive Information Protection** - Prevent PII leakage
+  - PII detection (emails, phone numbers, SSN, credit cards)
+  - Automatic redaction or blocking
+  - Compliance mode (GDPR, HIPAA, PCI-DSS)
+  - Data leak prevention metrics
+
+**Implementation:**
+```python
+import genai_otel
+
+# Configure guardrails
+genai_otel.instrument(
+    enable_prompt_injection_detection=True,
+    enable_restricted_topics=True,
+    enable_sensitive_info_detection=True,
+
+    # Custom configuration
+    restricted_topics=["medical_advice", "legal_advice", "financial_advice"],
+    pii_detection_mode="block",  # or "redact", "warn"
+
+    # Callbacks for custom handling
+    on_guardrail_violation=my_violation_handler
+)
+```
+
+**Metrics Added:**
+- `gen_ai.guardrail.prompt_injection_detected` - Injection attempts blocked
+- `gen_ai.guardrail.restricted_topic_blocked` - Restricted topic violations
+- `gen_ai.guardrail.pii_detected` - PII detection events
+- `gen_ai.guardrail.violations` - Total guardrail violations by type
+
+**Span Attributes:**
+- `gen_ai.guardrail.violation_type` - Type of violation detected
+- `gen_ai.guardrail.violation_severity` - Severity level (low, medium, high, critical)
+- `gen_ai.guardrail.blocked` - Whether request was blocked (boolean)
+- `gen_ai.eval.bias_categories` - Detected bias types (array)
+- `gen_ai.eval.toxicity_categories` - Toxicity categories (array)
+
+#### 📊 Enhanced OpenTelemetry Compliance
+
+Completing remaining items from [OTEL_SEMANTIC_GAP_ANALYSIS_AND_IMPLEMENTATION_PLAN.md](OTEL_SEMANTIC_GAP_ANALYSIS_AND_IMPLEMENTATION_PLAN.md):
+
+**Phase 4: Optional Enhancements**
+- ✅ Session & User Tracking - Track sessions and users across requests
+  ```python
+  genai_otel.instrument(
+      session_id_extractor=lambda ctx: ctx.get("session_id"),
+      user_id_extractor=lambda ctx: ctx.get("user_id")
+  )
+  ```
+
+- ✅ RAG/Embedding Attributes - Enhanced observability for retrieval-augmented generation
+  - `embedding.model_name` - Embedding model used
+  - `embedding.vector_dimensions` - Vector dimensions
+  - `retrieval.documents.{i}.document.id` - Retrieved document IDs
+  - `retrieval.documents.{i}.document.score` - Relevance scores
+  - `retrieval.documents.{i}.document.content` - Document content (truncated)
+
+- ✅ Agent Workflow Tracking - Better support for agentic workflows
+  - `agent.name` - Agent identifier
+  - `agent.iteration` - Current iteration number
+  - `agent.action` - Action taken
+  - `agent.observation` - Observation received
+
+#### 🔄 Migration Support
+
+**Backward Compatibility:**
+- All new features are opt-in via configuration
+- Existing instrumentation continues to work unchanged
+- Gradual migration path for new semantic conventions
+
+**Version Support:**
+- Python 3.9+ (evaluation features require 3.10+)
+- OpenTelemetry SDK 1.20.0+
+- Backward compatible with existing dashboards
+
+### Future Releases
+
+**v0.3.0 - Advanced Analytics**
+- Custom metric aggregations
+- Cost optimization recommendations
+- Automated performance regression detection
+- A/B testing support for prompts
+
+**v0.4.0 - Enterprise Features**
+- Multi-tenancy support
+- Role-based access control for telemetry
+- Advanced compliance reporting
+- SLA monitoring and alerting
+
+**Community Feedback**
+
+We welcome feedback on our roadmap! Please:
+- Open issues for feature requests
+- Join discussions on prioritization
+- Share your use cases and requirements
+
+See [Contributing.md](Contributing.md) for how to get involved.
+
 ## License
 Apache-2.0 license

genai_otel_instrument-0.1.2.dev0/examples/demo/docker-compose.yml

@@ -0,0 +1,120 @@
+version: '3.8'
+
+services:
+  # OpenTelemetry Collector - Central telemetry pipeline
+  otel-collector:
+    image: otel/opentelemetry-collector-contrib:latest
+    container_name: genai-otel-collector
+    command: ["--config=/etc/otel-collector-config.yml"]
+    volumes:
+      - ./otel-collector-config.yml:/etc/otel-collector-config.yml
+    ports:
+      - "4317:4317"    # OTLP gRPC receiver
+      - "4318:4318"    # OTLP HTTP receiver
+      - "8888:8888"    # Prometheus metrics (collector internal)
+      - "8889:8889"    # Prometheus exporter
+    networks:
+      - genai-otel-network
+    depends_on:
+      - jaeger
+      - prometheus
+
+  # Jaeger - Distributed tracing backend
+  jaeger:
+    image: jaegertracing/all-in-one:latest
+    container_name: genai-otel-jaeger
+    environment:
+      - COLLECTOR_OTLP_ENABLED=true
+      - METRICS_STORAGE_TYPE=prometheus
+      - PROMETHEUS_SERVER_URL=http://prometheus:9090
+    ports:
+      - "16686:16686"  # Jaeger UI
+      - "14250:14250"  # Model.proto gRPC
+    networks:
+      - genai-otel-network
+
+  # Prometheus - Metrics storage and querying
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: genai-otel-prometheus
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+      - '--storage.tsdb.path=/prometheus'
+      - '--web.console.libraries=/usr/share/prometheus/console_libraries'
+      - '--web.console.templates=/usr/share/prometheus/consoles'
+      - '--web.enable-lifecycle'
+      - '--storage.tsdb.retention.time=7d'
+    volumes:
+      - ./prometheus.yml:/etc/prometheus/prometheus.yml
+      - prometheus-data:/prometheus
+    ports:
+      - "9090:9090"    # Prometheus UI
+    networks:
+      - genai-otel-network
+
+  # Grafana - Visualization and dashboards
+  grafana:
+    image: grafana/grafana:latest
+    container_name: genai-otel-grafana
+    environment:
+      - GF_AUTH_ANONYMOUS_ENABLED=true
+      - GF_AUTH_ANONYMOUS_ORG_ROLE=Admin
+      - GF_AUTH_DISABLE_LOGIN_FORM=true
+      - GF_FEATURE_TOGGLES_ENABLE=traceqlEditor
+    volumes:
+      - ./grafana/provisioning:/etc/grafana/provisioning
+      - ./grafana/dashboards:/var/lib/grafana/dashboards
+      - grafana-data:/var/lib/grafana
+    ports:
+      - "3000:3000"    # Grafana UI
+    networks:
+      - genai-otel-network
+    depends_on:
+      - prometheus
+      - jaeger
+
+  # Demo Application
+  demo-app:
+    build:
+      context: ../..
+      dockerfile: examples/demo/Dockerfile
+    container_name: genai-otel-demo-app
+    environment:
+      # OpenTelemetry Configuration
+      - OTEL_SERVICE_NAME=genai-demo-app
+      - OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
+      - OTEL_SERVICE_INSTANCE_ID=demo-instance-1
+      - OTEL_ENVIRONMENT=demo
+      - OTEL_EXPORTER_OTLP_TIMEOUT=10.0
+
+      # Semantic Conventions
+      - OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai
+      - GENAI_ENABLE_CONTENT_CAPTURE=false
+
+      # Feature Flags
+      - GENAI_ENABLE_GPU_METRICS=false
+      - GENAI_ENABLE_COST_TRACKING=true
+      - GENAI_ENABLE_MCP_INSTRUMENTATION=true
+      - GENAI_ENABLE_CO2_TRACKING=true
+
+      # API Keys (pass from host environment)
+      - OPENAI_API_KEY=${OPENAI_API_KEY}
+      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
+      - GOOGLE_API_KEY=${GOOGLE_API_KEY}
+
+      # Logging
+      - GENAI_OTEL_LOG_LEVEL=INFO
+      - GENAI_FAIL_ON_ERROR=false
+    depends_on:
+      - otel-collector
+    networks:
+      - genai-otel-network
+    restart: unless-stopped
+
+networks:
+  genai-otel-network:
+    driver: bridge
+
+volumes:
+  prometheus-data:
+  grafana-data:

{genai_otel_instrument-0.1.1.dev0 → genai_otel_instrument-0.1.2.dev0}/genai_otel/__version__.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.1.1.dev0'
-__version_tuple__ = version_tuple = (0, 1, 1, 'dev0')
+__version__ = version = '0.1.2.dev0'
+__version_tuple__ = version_tuple = (0, 1, 2, 'dev0')
 
-__commit_id__ = commit_id = 'g20f877652'
+__commit_id__ = commit_id = 'g3d504c1d4'

{genai_otel_instrument-0.1.1.dev0 → genai_otel_instrument-0.1.2.dev0}/genai_otel/gpu_metrics.py

@@ -43,6 +43,7 @@ class GPUMetricsCollector:
         self.gpu_utilization_counter: Optional[ObservableCounter] = None
         self.gpu_memory_used_gauge: Optional[ObservableGauge] = None
         self.gpu_temperature_gauge: Optional[ObservableGauge] = None
+        self.gpu_power_gauge: Optional[ObservableGauge] = None
         self.config = config
         self.interval = interval  # seconds
         self.gpu_available = False
@@ -93,6 +94,12 @@ class GPUMetricsCollector:
                 description="GPU temperature in Celsius",
                 unit="Cel",
             )
+            self.gpu_power_gauge = self.meter.create_observable_gauge(
+                "gen_ai.gpu.power",  # Fixed metric name
+                callbacks=[self._observe_gpu_power],
+                description="GPU power consumption in Watts",
+                unit="W",
+            )
         except Exception as e:
             logger.error("Failed to create GPU metrics instruments: %s", e, exc_info=True)
 
@@ -185,6 +192,33 @@ class GPUMetricsCollector:
         except Exception as e:
             logger.error("Error observing GPU temperature: %s", e)
 
+    def _observe_gpu_power(self, options):
+        """Observable callback for GPU power consumption."""
+        if not NVML_AVAILABLE or not self.gpu_available:
+            return
+
+        try:
+            pynvml.nvmlInit()
+            device_count = pynvml.nvmlDeviceGetCount()
+
+            for i in range(device_count):
+                handle = pynvml.nvmlDeviceGetHandleByIndex(i)
+                device_name = self._get_device_name(handle, i)
+
+                try:
+                    # Power usage is returned in milliwatts, convert to watts
+                    power_mw = pynvml.nvmlDeviceGetPowerUsage(handle)
+                    power_w = power_mw / 1000.0
+                    yield Observation(
+                        value=power_w, attributes={"gpu_id": str(i), "gpu_name": device_name}
+                    )
+                except Exception as e:
+                    logger.debug("Failed to get GPU power for GPU %d: %s", i, e)
+
+            pynvml.nvmlShutdown()
+        except Exception as e:
+            logger.error("Error observing GPU power: %s", e)
+
     def start(self):
         """Starts the GPU metrics collection.