[BREAKING] Python: Observability cleanup (#905)

* Further observability cleanup and update telemetry samples

* Add VS Code Extension config

* Fix unit tests

* Fix unit tests

* Add more comments

* Remove live metric

python/samples/getting_started/workflow/README.md

@@ -31,6 +31,7 @@ Once comfortable with these, explore the rest of the samples below.
 ## Samples Overview (by directory)
 
 ### agents
+
 | Sample | File | Concepts |
 |---|---|---|
 | Azure Chat Agents (Streaming) | [agents/azure_chat_agents_streaming.py](./agents/azure_chat_agents_streaming.py) | Add Azure agents as edges and handle streaming events |
@@ -40,12 +41,14 @@ Once comfortable with these, explore the rest of the samples below.
 | Workflow as Agent + HITL | [agents/workflow_as_agent_human_in_the_loop.py](./agents/workflow_as_agent_human_in_the_loop.py) | Extend workflow-as-agent with human-in-the-loop capability |
 
 ### checkpoint
+
 | Sample | File | Concepts |
 |---|---|---|
 | Checkpoint & Resume | [checkpoint/checkpoint_with_resume.py](./checkpoint/checkpoint_with_resume.py) | Create checkpoints, inspect them, and resume execution |
 | Checkpoint & HITL Resume | [checkpoint/checkpoint_with_human_in_the_loop.py](./checkpoint/checkpoint_with_human_in_the_loop.py) | Combine checkpointing with human approvals and resume pending HITL requests |
 
 ### composition
+
 | Sample | File | Concepts |
 |---|---|---|
 | Sub-Workflow (Basics) | [composition/sub_workflow_basics.py](./composition/sub_workflow_basics.py) | Wrap a workflow as an executor and orchestrate sub-workflows |
@@ -53,6 +56,7 @@ Once comfortable with these, explore the rest of the samples below.
 | Sub-Workflow: Parallel Requests | [composition/sub_workflow_parallel_requests.py](./composition/sub_workflow_parallel_requests.py) | Multiple specialized interceptors handling different request types from same sub-workflow |
 
 ### control-flow
+
 | Sample | File | Concepts |
 |---|---|---|
 | Sequential Executors | [control-flow/sequential_executors.py](./control-flow/sequential_executors.py) | Sequential workflow with explicit executor setup |
@@ -63,16 +67,19 @@ Once comfortable with these, explore the rest of the samples below.
 | Simple Loop | [control-flow/simple_loop.py](./control-flow/simple_loop.py) | Feedback loop where an agent judges ABOVE/BELOW/MATCHED |
 
 ### human-in-the-loop
+
 | Sample | File | Concepts |
 |---|---|---|
 | Human-In-The-Loop (Guessing Game) | [human-in-the-loop/guessing_game_with_human_input.py](./human-in-the-loop/guessing_game_with_human_input.py) | Interactive request/response prompts with a human |
 
 ### observability
+
 | Sample | File | Concepts |
 |---|---|---|
-| Tracing (Basics) | [observability/tracing_basics.py](./observability/tracing_basics.py) | Use basic tracing for workflow telemetry |
+| Tracing (Basics) | [observability/tracing_basics.py](./observability/tracing_basics.py) | Use basic tracing for workflow telemetry. Refer to this [directory](../observability/) to learn more about observability concepts. |
 
 ### orchestration
+
 | Sample | File | Concepts |
 |---|---|---|
 | Concurrent Orchestration (Default Aggregator) | [orchestration/concurrent_agents.py](./orchestration/concurrent_agents.py) | Fan-out to multiple agents; fan-in with default aggregator returning combined ChatMessages |
@@ -84,6 +91,7 @@ Once comfortable with these, explore the rest of the samples below.
 | Sequential Orchestration (Custom Executor) | [orchestration/sequential_custom_executors.py](./orchestration/sequential_custom_executors.py) | Mix agents with a summarizer that appends a compact summary |
 
 ### parallelism
+
 | Sample | File | Concepts |
 |---|---|---|
 | Concurrent (Fan-out/Fan-in) | [parallelism/fan_out_fan_in_edges.py](./parallelism/fan_out_fan_in_edges.py) | Dispatch to multiple executors and aggregate results |
@@ -91,16 +99,19 @@ Once comfortable with these, explore the rest of the samples below.
 | Map-Reduce with Visualization | [parallelism/map_reduce_and_visualization.py](./parallelism/map_reduce_and_visualization.py) | Fan-out/fan-in pattern with diagram export |
 
 ### state-management
+
 | Sample | File | Concepts |
 |---|---|---|
 | Shared States | [state-management/shared_states_with_agents.py](./state-management/shared_states_with_agents.py) | Store in shared state once and later reuse across agents |
 
 ### visualization
+
 | Sample | File | Concepts |
 |---|---|---|
 | Concurrent with Visualization | [visualization/concurrent_with_visualization.py](./visualization/concurrent_with_visualization.py) | Fan-out/fan-in workflow with diagram export |
 
 ### resources
+
 - Sample text inputs used by certain workflows:
   - [resources/long_text.txt](./resources/long_text.txt)
   - [resources/email.txt](./resources/email.txt)
@@ -108,9 +119,11 @@ Once comfortable with these, explore the rest of the samples below.
   - [resources/ambiguous_email.txt](./resources/ambiguous_email.txt)
 
 Notes
+
 - Agent-based samples use provider SDKs (Azure/OpenAI, etc.). Ensure credentials are configured, or adapt agents accordingly.
 
 Sequential orchestration uses a few small adapter nodes for plumbing:
+
 - "input-conversation" normalizes input to `list[ChatMessage]`
 - "to-conversation:<participant>" converts agent responses into the shared conversation
 - "complete" publishes the final `WorkflowOutputEvent`

python/samples/getting_started/workflow/observability/tracing_basics.py

@@ -1,9 +1,9 @@
 # Copyright (c) Microsoft. All rights reserved.
 
 import asyncio
-import os
 
 from agent_framework import Executor, WorkflowBuilder, WorkflowContext, get_logger, handler
+from agent_framework.observability import setup_observability
 
 """Basic tracing workflow sample.
 
@@ -23,30 +23,11 @@ Purpose:
 
 Prerequisites:
 - No external services required for the workflow itself.
-- To print spans to the console, install the OpenTelemetry SDK: pip install opentelemetry-sdk
-- Enable diagnostics:
-    configure your .env file with `ENABLE_OTEL=true` or run:
-    export ENABLE_OTEL=true
 """
 
 logger = get_logger()
 
 
-def _ensure_tracing_configured() -> None:
-    """Fail fast unless diagnostics are enabled and the SDK is present.
-
-    If the env var is set, attach a ConsoleSpanExporter so spans print to stdout.
-    """
-    env = os.getenv("ENABLE_OTEL", "").lower()
-    if env not in {"1", "true", "yes"}:
-        logger.info("Tracing diagnostics are disabled in the env. Setting this manually here.")
-
-    from agent_framework.observability import setup_observability
-    from opentelemetry.sdk.trace.export import ConsoleSpanExporter
-
-    setup_observability(exporters=[ConsoleSpanExporter()])
-
-
 class StartExecutor(Executor):
     @handler  # type: ignore[misc]
     async def handle_input(self, message: str, ctx: WorkflowContext[str]) -> None:
@@ -62,7 +43,9 @@ class EndExecutor(Executor):
 
 
 async def main() -> None:
-    _ensure_tracing_configured()  # Enforce tracing configuration before building or running the workflow.
+    # This will enable tracing and create the necessary tracing, logging and metrics providers
+    # based on environment variables.
+    setup_observability()
 
     # Build a two node graph: StartExecutor -> EndExecutor. The builder emits a workflow.build span.
     workflow = (