Merge pull request #780 from MicrosoftDocs/taochen/update-workflow-observability-doc

Update workflow observability doc

Author: TaoChenOSU

agent-framework/user-guide/agents/agent-observability.md

@@ -21,7 +21,7 @@ Agent Framework integrates with [OpenTelemetry](https://opentelemetry.io/), and
 
 ::: zone pivot="programming-language-csharp"
 
-## Enable Observability
+## Enable Observability (C#)
 
 To enable observability for your chat client, you need to build the chat client as follows:
 
@@ -165,7 +165,7 @@ See a full example of an agent with OpenTelemetry enabled in the [Agent Framewor
 
 ::: zone pivot="programming-language-python"
 
-## Enable Observability
+## Enable Observability (Python)
 
 To enable observability in your python application, in most cases you do not need to install anything extra, by default the following package are installed:
 

agent-framework/user-guide/workflows/observability.md

@@ -1,6 +1,7 @@
 ---
 title: Microsoft Agent Framework Workflows - Observability
 description: In-depth look at Observability in Microsoft Agent Framework Workflows.
+zone_pivot_groups: programming-languages
 author: TaoChenOSU
 ms.topic: tutorial
 ms.author: taochen
@@ -12,24 +13,24 @@ ms.service: agent-framework
 
 Observability provides insights into the internal state and behavior of workflows during execution. This includes logging, metrics, and tracing capabilities that help monitor and debug workflows.
 
+> [!TIP]
+> Observability is a framework-wide feature and is not limited to workflows. For more information, refer to [Agent Observability](../agents/agent-observability.md).
+
 Aside from the standard [GenAI telemetry](https://opentelemetry.io/docs/specs/semconv/gen-ai/), Agent Framework Workflows emits additional spans, logs, and metrics to provide deeper insights into workflow execution. These observability features help developers understand the flow of messages, the performance of executors, and any errors that may occur.
 
 ## Enable Observability
 
-Observability is enabled framework-wide by setting the `ENABLE_OTEL=true` environment variable or calling `setup_observability()` at the beginning of your application.
+::: zone pivot="programming-language-csharp"
+
+Please refer to [Enabling Observability](../agents/agent-observability.md#enable-observability-c) for instructions on enabling observability in your applications.
+
+::: zone-end
 
-```env
-# This is not required if you run `setup_observability()` in your code
-ENABLE_OTEL=true
-# Sensitive data (e.g., message content) will be included in logs and traces if this is set to true
-ENABLE_SENSITIVE_DATA=true
-```
+::: zone pivot="programming-language-python"
 
-```python
-from agent_framework.observability import setup_observability
+Please refer to [Enabling Observability](../agents/agent-observability.md#enable-observability-python) for instructions on enabling observability in your applications.
 
-setup_observability(enable_sensitive_data=True)
-```
+::: zone-end
 
 ## Workflow Spans
 

agent-framework/user-guide/workflows/visualization.md

@@ -1,6 +1,7 @@
 ---
 title: Microsoft Agent Framework Workflows - Visualization
 description: In-depth look at Visualization in Microsoft Agent Framework Workflows.
+zone_pivot_groups: programming-languages
 author: TaoChenOSU
 ms.topic: tutorial
 ms.author: taochen
@@ -12,6 +13,37 @@ ms.service: agent-framework
 
 Sometimes a workflow that has multiple executors and complex interactions can be hard to understand from just reading the code. Visualization can help you see the structure of the workflow more clearly, so that you can verify that it has the intended design.
 
+::: zone pivot="programming-language-csharp"
+
+Workflow visualization can be achieved via extension methods on the `Workflow` class: `ToMermaidString()`, and `ToDotString()`, which generate Mermaid diagram format and Graphviz DOT format respectively.
+
+```csharp
+using Microsoft.Agents.AI.Workflows;
+
+// Create a workflow with a fan-out and fan-in pattern
+var workflow = new WorkflowBuilder()
+    .SetStartExecutor(dispatcher)
+    .AddFanOutEdges(dispatcher, [researcher, marketer, legal])
+    .AddFanInEdges([researcher, marketer, legal], aggregator)
+    .Build();
+
+// Mermaid diagram
+Console.WriteLine(workflow.ToMermaidString());
+
+// DiGraph string
+Console.WriteLine(workflow.ToDotString());
+```
+
+To create an image file from the DOT format, you can use GraphViz tools with the following command:
+
+```bash
+dotnet run | tail -n +20 | dot -Tpng -o workflow.png
+```
+
+::: zone-end
+
+::: zone pivot="programming-language-python"
+
 Workflow visualization is done via a `WorkflowViz` object that can be instantiated with a `Workflow` object. The `WorkflowViz` object can then generate visualizations in different formats, such as Graphviz DOT format or Mermaid diagram format.
 
 > [!TIP]
@@ -45,6 +77,8 @@ print(viz.to_digraph())
 print(viz.export(format="svg"))
 ```
 
+::: zone-end
+
 The exported diagram will look similar to the following for the example workflow:
 
 ```mermaid