Merge pull request #50651 from lootle1/MR108

JamesJBarnett · web-flow · commit 3d2cbe3770d9 · 2025-05-30T09:09:31.000-07:00
Technical Review 1055058: Implement observability in a cloud-native .…
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/1-introduction.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/1-introduction.yml
@@ -4,7 +4,7 @@ title: Introduction
 metadata:
   title: Introduction
   description: Learn how to build observability into your cloud-native application by including OpenTelemetry packages and analyzing the data in Application Insights or third-party tools.
-  ms.date: 12/20/2023
+  ms.date: 05/27/2025
   author: codemillmatt  
   ms.author: masoucou
   ms.topic: unit
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/2-whats-observability.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/2-whats-observability.yml
@@ -4,7 +4,7 @@ title: What is observability?
 metadata:
   title: What is observability?
   description: "Explore the three pillars of observability and how they help monitor applications."
-  ms.date: 12/20/2023
+  ms.date: 05/27/2025
   author: codemillmatt  
   ms.author: masoucou
   ms.topic: unit
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/3-add-observability-cloud-native-app.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/3-add-observability-cloud-native-app.yml
@@ -4,7 +4,7 @@ title: Add observability to a cloud-native application
 metadata:
   title: Add observability to a cloud-native application
   description: "Learn about how to add observability to a cloud-native application by using OpenTelemetry."
-  ms.date: 12/20/2023
+  ms.date: 05/27/2025
   author: codemillmatt  
   ms.author: masoucou
   ms.topic: unit
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/4-exercise-add-observability-cloud-native-app.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/4-exercise-add-observability-cloud-native-app.yml
@@ -4,7 +4,7 @@ title: Exercise - Add OpenTelemetry to a cloud-native application
 metadata:
   title: Exercise - Add OpenTelemetry to a cloud-native application
   description: "Exercise to update a cloud-native application to use OpenTelemetry to output logs, metrics, and tracing data to the console."
-  ms.date: 12/20/2023
+  ms.date: 05/27/2025
   author: codemillmatt  
   ms.author: masoucou
   ms.topic: unit
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/5-view-telemetry-data.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/5-view-telemetry-data.yml
@@ -4,7 +4,7 @@ title: View telemetry with Azure Monitor and third-party tools
 metadata:
   title: View telemetry with Azure Monitor and third-party tools
   description: "View the telemetry data generated by OpenTelemetry in Application Insights and third-party tools."
-  ms.date: 12/20/2023
+  ms.date: 05/27/2025
   author: codemillmatt  
   ms.author: masoucou
   ms.topic: unit
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/6-exercise-use-opentelemetry-data-cloud-native-application.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/6-exercise-use-opentelemetry-data-cloud-native-application.yml
@@ -4,7 +4,7 @@ title: Exercise - Use OpenTelemetry data in a cloud-native application
 metadata:
   title: Exercise - Use OpenTelemetry data in a cloud-native application
   description: "Exercise to add Prometheus, Grafana, Zipkin, and Application Insights to a cloud-native application to view telemetry data."
-  ms.date: 12/20/2023
+  ms.date: 05/27/2025
   author: codemillmatt  
   ms.author: masoucou
   ms.topic: unit
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/7-exercise-extend-telemetry.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/7-exercise-extend-telemetry.yml
@@ -4,7 +4,7 @@ title: Exercise - Extend telemetry in .NET 8
 metadata:
   title: Exercise - Extend telemetry in .NET 8
   description: "Exercise to add a custom metric to a cloud-native application by using OpenTelemetry."
-  ms.date: 12/20/2023
+  ms.date: 05/27/2025
   author: codemillmatt  
   ms.author: masoucou
   ms.topic: unit
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/8-knowledge-check.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/8-knowledge-check.yml
@@ -4,7 +4,7 @@ title: Module assessment
 metadata:
   title: Module assessment
   description: Check your knowledge.
-  ms.date: 12/20/2023
+  ms.date: 05/27/2025
   author: codemillmatt  
   ms.author: masoucou
   ms.topic: unit
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/9-summary.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/9-summary.yml
@@ -4,7 +4,7 @@ title: Summary
 metadata:
   title: Summary
   description: Summary
-  ms.date: 12/20/2023
+  ms.date: 05/27/2025
   author: codemillmatt  
   ms.author: masoucou
   ms.topic: unit
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/1-introduction.md b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/1-introduction.md
@@ -1,4 +1,4 @@
-Because of the distributed nature of cloud-native applications, they should be closely monitored to ensure they're healthy and that their behavior is fast and reliable. If problems develop, you need to know before users do. You can achieve observability by including a telemetry package such as OpenTelemetry.
+Because of the distributed nature of cloud-native applications, they should be closely monitored to ensure they're healthy, and their behavior is fast and reliable. If problems develop, you need to know before users do. You can achieve observability by including a telemetry package such as OpenTelemetry.
 
 Imagine you work for an online outdoor clothing retailer that has a microservice-based web app it uses for stock management. While testing the cloud-native app, you're asked to ensure that its behavior can be monitored. You want to see how .NET supports observability.
 
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/4-exercise-add-observability-cloud-native-app.md b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/4-exercise-add-observability-cloud-native-app.md
@@ -10,28 +10,29 @@ This step takes several minutes while GitHub creates and configures the codespac
 
 To use **Visual Studio Code**, clone the [https://github.com/MicrosoftDocs/mslearn-dotnet-cloudnative](https://github.com/MicrosoftDocs/mslearn-dotnet-cloudnative) repository to your local machine. Then:
 
-1. Install any [system requiements](https://code.visualstudio.com/docs/devcontainers/containers) to run Dev Container in Visual Studio Code.
-1. Make sure Docker is running. 
-1. In a new Visual Studio Code window open the folder of the cloned repository
+1. Install any [system requirements](https://code.visualstudio.com/docs/devcontainers/containers) to run Dev Container in Visual Studio Code.
+1. Make sure Docker is running.
+1. In a new Visual Studio Code window, open the folder of the cloned repository.
 1. Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> to open the command palette.
-1. Search: **>Dev Containers: Rebuild and Reopen in Container**
+1. Search: **>Dev Containers: Rebuild and Reopen in Container**.
 1. Select **eShopLite - dotnet-observability** from the drop down. Visual Studio Code creates your development container locally.
+
 ### Add a diagnostic project to the solution
 
 The first step to adding observability to the **:::no-loc text="eShopLite":::** app is to introduce a new diagnostic project to the solution. This project contains all the OpenTelemetry packages and configurations that you'll use to add observability to the app.
 
-1. In the Visual Studio Code command palette, enter **>.NET: Open Solution**.
+1. In the Codespace command palette, enter **>.NET: Open Solution**.
 1. Select **dotnet-observability/eShopLite/eShopLite.sln**.
-1. In the **Solution Explorer**, at the bottom of the **EXPLORER** pane, right-click the **eShopLite** solution and then select **New Project**.
+1. In the **Solution Explorer**, at the bottom of the **EXPLORER** pane, right-click the **eShopLite** solution, and then select **New Project**.
 1. In the **Select a template to create a new .NET project** dialog, select **Class Library (Common, Library)**.
 1. In the **Name** field, enter **Diagnostics**.
-1. In the **Project will be created in** dropdown, select **Default directory**.
+1. In the **Project will be created in** dropdown, ensure the file path directory is */workspaces/mslearn-dotnet-cloudnative/dotnet-observability/eShopLite/*.
 
 ### Add OpenTelemetry packages
 
 Now add the OpenTelemetry packages to the new diagnostic project.
 
-1. By using the **TERMINAL** pane at the bottom of Visual Studio Code, go to the *Diagnostics* project folder:
+1. By using the **TERMINAL** pane at the bottom of Codespace, go to the *Diagnostics* project folder:
 
     ```bash
     cd dotnet-observability/eShopLite/Diagnostics
@@ -69,7 +70,7 @@ Now add the OpenTelemetry packages to the new diagnostic project.
 
 With the OpenTelemetry packages added, you now introduce the code to make use of them.
 
-1. On the **EXPLORER** pane, right-click the *Class1.cs* file and then select **Rename**.
+1. On the **EXPLORER** pane, right-click the *Class1.cs* file, and then select **Rename**.
 1. Rename the file to **DiagnosticServiceCollectionExtensions.cs**.
 1. Replace the code in the file with the following code:
 
@@ -140,11 +141,11 @@ With the OpenTelemetry packages added, you now introduce the code to make use of
         0 Warning(s)
         0 Error(s)
     ```
-    
+
 1. The **Diagnostics** project is now ready to be used by the **Products** service.
-1. On the **EXPLORER** pane, under **SOLUTION EXPLORER**, right-click the **Products** project and then select **Add Project Reference**.
+1. On the **EXPLORER** pane, under **SOLUTION EXPLORER**, right-click the **Products** project, and then select **Add Project Reference**.
 1. Select **Diagnostics**.
-1. On the **EXPLORER** pane, expand the *Products* folder and then select **Program.cs**.
+1. On the **EXPLORER** pane, expand the *Products* folder, and then select **Program.cs**.
 1. Under the code comment `// Add observability code here`, add a call to the Diagnostics method:
 
     ```csharp
@@ -197,7 +198,7 @@ With the OpenTelemetry packages added, you now introduce the code to make use of
 
     :::image type="content" source="../media/eshoplite-products.png" alt-text="A screenshot that shows the Products page in the eShopLite app. The page shows a list of products with a name, description, and price and a button to update the stock." lightbox="../media/eshoplite-products.png":::
 
-1. Select **Update Stock** for several of the products. Then, in the dialog, change the stock value and select **Update**.
+1. Select **Update Stock** for several of the products. Then, in the dialog, change the stock value, and select **Update**.
 
 1. Select the **TERMINAL** tab and scroll through the messages. Note there are messages from OpenTelemetry like:
 
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/5-view-telemetry-data.md b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/5-view-telemetry-data.md
@@ -1,12 +1,12 @@
-Your app is collecting telemetry data and you now need a more comprehensive way to view it. In this unit, you'll see how to view telemetry data in many different tools.
+Your app is collecting telemetry data, and you now need a more comprehensive way to view it. In this unit, you'll see how to view telemetry data in many different tools.
 
 ## Monitor and view telemetry data
 
 A common way to view telemetry data is to use Prometheus and Grafana together. Prometheus is an open-source monitoring system that collects metrics from your cloud-native app. Grafana is an open-source visualization tool that you use to create dashboards to view the metrics collected by Prometheus.
 
 ### Prometheus
 
-The first step is to add a Prometheus container and configure it to collect data from each microservice in your app. You then add the Prometheus .NET client library to collect metrics from the app.
+The first step is to add a Prometheus container, and configure it to collect data from each microservice in your app. You then add the Prometheus .NET client library to collect metrics from the app.
 
 :::image type="content" source="../media/prometheus.png" alt-text="Screenshot that shows the configured Prometheus app showing the health of the eShopLite app." lightbox="../media/prometheus.png":::
 
@@ -29,7 +29,7 @@ scrape_configs:
 
 ### Grafana
 
-Grafana is an open-source visualization tool that you can use to create dashboards to view the metrics collected by Prometheus. You can configure Grafana to connect to Prometheus and display the metrics in a dashboard. Like before, you add a Grafana container to your app and configure it to connect to Prometheus.
+Grafana is an open-source visualization tool that you can use to create dashboards to view the metrics collected by Prometheus. You can configure Grafana to connect to Prometheus, and display the metrics in a dashboard. Like before, you add a Grafana container to your app, and configure it to connect to Prometheus.
 
 :::image type="content" source="../media/grafana.png" alt-text="Screenshot that shows an ASP.NET dashboard in Grafana." lightbox="../media/grafana.png":::
 
@@ -57,8 +57,8 @@ In your diagnostics project, you need to add support for Zipkin via the `OpenTel
 
 ### Go deeper with Application Insights
 
-There's a tool that can combine looking at metrics and viewing distributed tracing and then merge it with data from logs. Application Insights is an extensible Application Performance Management (APM) service. You can use it to monitor your live web application. Application Insights automatically detects performance anomalies. It includes powerful analytics tools to help you diagnose issues and understand what users actually do with your app.
+There's a tool that can combine looking at metrics and viewing distributed tracing, and then merge it with data from logs. Application Insights is an extensible Application Performance Management (APM) service. You can use it to monitor your live web application. Application Insights automatically detects performance anomalies. It includes powerful analytics tools to help you diagnose issues and understand what users actually do with your app.
 
 :::image type="content" source="../media/app-insights.png" alt-text="Screenshot that shows Application Insights showing the health of the eShopLite app." lightbox="../media/app-insights.png":::
 
-Like the preceding tools, you need to add a NuGet package to your solution `Azure.Monitor.OpenTelemetry.AspNetCore` and then introduce Azure Monitor as an exporter to your diagnostics project.
+Like the preceding tools, you need to add a NuGet package to your solution `Azure.Monitor.OpenTelemetry.AspNetCore`, and then introduce Azure Monitor as an exporter to your diagnostics project.
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/6-exercise-use-opentelemetry-data-cloud-native-application.md b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/6-exercise-use-opentelemetry-data-cloud-native-application.md
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/7-exercise-extend-telemetry.md b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/7-exercise-extend-telemetry.md
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/9-summary.md b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/includes/9-summary.md
diff --git a/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/index.yml b/learn-pr/aspnetcore/implement-observability-cloud-native-app-with-opentelemetry/index.yml

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-Because of the distributed nature of cloud-native applications, they should be closely monitored to ensure they're healthy and that their behavior is fast and reliable. If problems develop, you need to know before users do. You can achieve observability by including a telemetry package such as OpenTelemetry.`
	`1`	`+Because of the distributed nature of cloud-native applications, they should be closely monitored to ensure they're healthy, and their behavior is fast and reliable. If problems develop, you need to know before users do. You can achieve observability by including a telemetry package such as OpenTelemetry.`
`2`	`2`
`3`	`3`	`Imagine you work for an online outdoor clothing retailer that has a microservice-based web app it uses for stock management. While testing the cloud-native app, you're asked to ensure that its behavior can be monitored. You want to see how .NET supports observability.`
`4`	`4`