Python: [BREAKING] Observability updates (#2782)

* fixes Python: Add env_file_path parameter to setup_observability() similar to AzureOpenAIChatClient
Fixes #2186

* WIP on updates using configure_azure_monitor

* improved setup and clarity

* fixed root .env.example

* revert changes

* updated files

* updated sample

* updated zero code

* test fixes and fixed links

* fix devui

* removed planning docs

* added enable method and updated readme and samples

* clarified docstring

* add return annotation

* updated naming

* update capatilized version

* updated readme and some fixes

* updated decorator name inline with the rest

* feedback from comments addressed

python/samples/getting_started/observability/advanced_zero_code.py

@@ -19,12 +19,23 @@ This sample shows how you can configure observability of an application with zer
 It relies on the OpenTelemetry auto-instrumentation capabilities, and the observability setup
 is done via environment variables.
 
-This sample requires the `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable to be set.
+Follow the install guidance from https://opentelemetry.io/docs/zero-code/python/ to install the OpenTelemetry CLI tool.
 
-Run the sample with the following command:
-```
-uv run --env-file=.env opentelemetry-instrument python advanced_zero_code.py
+And setup a local OpenTelemetry Collector instance to receive the traces and metrics (and update the endpoint below).
+
+Then you can run:
+```bash
+opentelemetry-enable_instrumentation \
+    --traces_exporter otlp \
+    --metrics_exporter otlp \
+    --service_name agent_framework \
+    --exporter_otlp_endpoint http://localhost:4317 \
+    python samples/getting_started/observability/advanced_zero_code.py
 ```
+(or use uv run in front when you have did the install within your uv virtual environment)
+
+You can also set the environment variables instead of passing them as CLI arguments.
+
 """