Add telemetry documentation to README and SDK skill

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: tpellissier

README.md

@@ -41,6 +41,7 @@ A Python client library for Microsoft Dataverse that provides a unified interfac
 - **🔗 Relationship Management**: Create one-to-many and many-to-many relationships between tables with full metadata control
 - **📎 File Operations**: Upload files to Dataverse file columns with automatic chunking for large files
 - **🔐 Azure Identity**: Built-in authentication using Azure Identity credential providers with comprehensive support
+- **📡 Telemetry & Observability**: Opt-in telemetry hooks, OpenTelemetry tracing/metrics, and Python logging integration
 - **🛡️ Error Handling**: Structured exception hierarchy with detailed error context and retry guidance
 
 ## Getting started
@@ -386,6 +387,31 @@ client.files.upload(
 )
 ```
 
+### Telemetry & observability
+
+```python
+from PowerPlatform.Dataverse.core.telemetry import TelemetryConfig, TelemetryHook
+from PowerPlatform.Dataverse.core.config import DataverseConfig
+
+# Custom hook -- receives events for every HTTP request
+class MyHook(TelemetryHook):
+    def on_request_end(self, request, response):
+        print(f"{request.operation} -> {response.status_code} in {response.duration_ms:.0f}ms")
+        print(f"  service_request_id: {response.service_request_id}")
+
+config = DataverseConfig(telemetry=TelemetryConfig(hooks=[MyHook()]))
+client = DataverseClient(url, credential, config=config)
+
+# OpenTelemetry integration (pip install PowerPlatform-Dataverse-Client[telemetry])
+config = DataverseConfig(
+    telemetry=TelemetryConfig(
+        enable_tracing=True,   # OTel spans with semantic conventions
+        enable_metrics=True,   # duration/count/error counters
+        enable_logging=True,   # Python logging integration
+    )
+)
+```
+
 ## Next steps
 
 ### More sample code

src/PowerPlatform/Dataverse/claude_skill/dataverse-sdk-use/SKILL.md

@@ -310,6 +310,37 @@ client.files.upload(
 )
 ```
 
+### Telemetry & Observability
+
+The SDK supports opt-in telemetry via hooks, OpenTelemetry, and Python logging:
+
+```python
+from PowerPlatform.Dataverse.core.telemetry import TelemetryConfig, TelemetryHook
+from PowerPlatform.Dataverse.core.config import DataverseConfig
+
+# Custom hook -- receives on_request_start, on_request_end, on_request_error
+class MyHook(TelemetryHook):
+    def on_request_end(self, request, response):
+        print(f"{request.operation} -> {response.status_code} in {response.duration_ms:.0f}ms")
+
+config = DataverseConfig(telemetry=TelemetryConfig(hooks=[MyHook()]))
+client = DataverseClient(url, credential, config=config)
+
+# OpenTelemetry (pip install PowerPlatform-Dataverse-Client[telemetry])
+config = DataverseConfig(
+    telemetry=TelemetryConfig(enable_tracing=True, enable_metrics=True)
+)
+
+# Python logging
+config = DataverseConfig(
+    telemetry=TelemetryConfig(enable_logging=True, log_level="DEBUG")
+)
+```
+
+Hook data available per request: `operation`, `table_name`, `method`, `url`, `status_code`, `duration_ms`, `service_request_id`, `client_request_id`, `correlation_id`.
+
+Zero overhead when `TelemetryConfig` is not set.
+
 ## Error Handling
 
 The SDK provides structured exceptions with detailed error information: