feat: implement otel tracing feature

Author: philipph-askui

docs/09_observability_telemetry_tracing.md

@@ -1,6 +1,6 @@
 # Observability, Telemetry, and Tracing
 
-Understanding what your AI agents are doing, debugging issues, and monitoring performance is critical for production deployments. Telemetry collects usage data to help improve AskUI Vision Agent. This data is used to detect bugs, understand usage patterns, and improve the user experience.
+Telemetry collects usage data to help improve AskUI Vision Agent. This data is used to detect bugs, understand usage patterns, and improve the user experience.
 
 ### What Data Is Collected
 
@@ -67,3 +67,69 @@ from askui import ComputerAgent
 ```
 
 When disabled, no usage data is collected or transmitted.
+
+## OpenTelemetry Tracing
+
+AskUI supports exporting traces via [OpenTelemetry](https://opentelemetry.io/) (OTLP/HTTP) for integration with observability backends like Grafana, Jaeger, or Datadog.
+
+### Setup
+
+To use OpenTelemetry Tracing, you first need to install the optional tracing dependencies
+```
+pip install askui[otel]
+```
+
+
+### Configuration via Environment Variables
+
+Set the following environment variables to configure tracing. All variables use the `ASKUI__OTEL_` prefix.
+
+| Environment Variable | Description | Default |
+|---|---|---|
+| `ASKUI__OTEL_ENABLED` | Enable or disable OpenTelemetry tracing | `False` |
+| `ASKUI__OTEL_B64_SECRET` | Base64-encoded secret for OTLP authentication (required when enabled) | — |
+| `ASKUI__OTEL_ENDPOINT` | OTLP HTTP endpoint URL | — |
+| `ASKUI__OTEL_SERVICE_NAME` | Service name reported in traces | `askui-python-sdk` |
+| `ASKUI__OTEL_SERVICE_VERSION` | Service version reported in traces | Current package version |
+| `ASKUI__OTEL_CLUSTER_NAME` | Cluster name reported in traces | `askui-dev` |
+
+#### Linux & MacOS
+```bash
+export ASKUI__OTEL_ENABLED=True
+export ASKUI__OTEL_B64_SECRET="your-base64-encoded-secret"
+export ASKUI__OTEL_ENDPOINT="https://your-otlp-endpoint/v1/traces"
+```
+
+#### Windows PowerShell
+```powershell
+$env:ASKUI__OTEL_ENABLED="True"
+$env:ASKUI__OTEL_B64_SECRET="your-base64-encoded-secret"
+$env:ASKUI__OTEL_ENDPOINT="https://your-otlp-endpoint/v1/traces"
+```
+
+### Usage
+
+Once environment variables are set, pass `OtelSettings` to the `act()` method. Settings are automatically read from the environment:
+
+```python
+from askui import ComputerAgent
+from askui.telemetry.otel import OtelSettings
+
+with ComputerAgent() as agent:
+    agent.act(
+        goal="Open Chrome and navigate to askui.com",
+        tracing_settings=OtelSettings(enabled=True),
+    )
+```
+
+You can also override individual settings in code:
+
+```python
+from askui.telemetry.otel import OtelSettings
+
+settings = OtelSettings(
+    enabled=True,
+    service_name="my-custom-service",
+    cluster_name="production",
+)
+```