Merge pull request #284956 from hhunter-ms/hh-297521

[Profiler] Freshness pass

Author: v-regandowner

articles/azure-monitor/profiler/profiler-aspnetcore-linux.md

@@ -4,7 +4,7 @@ description: Learn how to enable Profiler on your ASP.NET Core web application h
 ms.topic: how-to
 ms.devlang: csharp
 ms.custom: devx-track-csharp, linux-related-content
-ms.date: 09/22/2023
+ms.date: 08/19/2024
 ms.reviewer: charles.weininger
 # Customer Intent: As a .NET developer, I'd like to enable Application Insights Profiler for my .NET web application hosted in Linux
 ---
@@ -14,9 +14,9 @@ ms.reviewer: charles.weininger
 By using Profiler, you can track how much time is spent in each method of your live ASP.NET Core web apps that are hosted in Linux on Azure App Service. This article focuses on web apps hosted in Linux. You can also experiment by using Linux, Windows, and Mac development environments.
 
 In this article, you:
-
-- Set up and deploy an ASP.NET Core web application hosted on Linux.
-- Add Application Insights Profiler to the ASP.NET Core web application.
+> [!div class="checklist"]
+> - Set up and deploy an ASP.NET Core web application hosted on Linux.
+> - Add Application Insights Profiler to the ASP.NET Core web application.
 
 ## Prerequisites
 

articles/azure-monitor/profiler/profiler-azure-functions.md

@@ -1,13 +1,13 @@
 ---
-title: Profile Azure Functions app with Application Insights Profiler
+title: Enable Profiler for Azure Functions apps
 description: Enable Application Insights Profiler for Azure Functions app.
 ms.contributor: charles.weininger
-ms.topic: conceptual
-ms.date: 09/22/2023
+ms.topic: how-to
+ms.date: 08/16/2024
 ms.reviewer: ryankahng
 ---
 
-# Profile live Azure Functions app with Application Insights
+# Enable Profiler for Azure Functions apps
 
 In this article, you'll use the Azure portal to:
 - View the current app settings for your Functions app. 
@@ -67,7 +67,7 @@ From your Functions app overview page in the Azure portal:
 
 The app settings now show up in the table:
 
-   :::image type="content" source="./media/profiler-azure-functions/app-settings-table.png" alt-text="Screenshot showing the two new app settings in the table on the configuration pane.":::
+:::image type="content" source="./media/profiler-azure-functions/app-settings-table.png" alt-text="Screenshot showing the two new app settings in the table on the configuration pane.":::
 
 
 > [!NOTE]

articles/azure-monitor/profiler/profiler-bring-your-own-storage.md

@@ -5,8 +5,8 @@ ms.author: hannahhunter
 author: hhunter-ms
 ms.reviewer: charles.weininger
 reviewer: cweining
-ms.topic: conceptual
-ms.date: 09/22/2023
+ms.topic: how-to
+ms.date: 08/19/2024
 ms.custom: devdivchpfy22, devx-track-azurepowershell, engagement
 ---
 
@@ -17,7 +17,7 @@ When you use [Application Insights Profiler](./profiler-overview.md) or [Snapsho
 - Processing and analysis.
 - Encryption-at-rest and lifetime management policies.
 
-Meanwhile, when you configure your own storage account (BYOS), artifacts are uploaded into a storage account that only you control and cover the cost for:
+Meanwhile, when you "bring your own storage" (BYOS), artifacts are uploaded into a storage account that only you control and cover the cost for:
 
 - The encryption-at-rest policy and the Lifetime management policy.
 - Network access.
@@ -36,8 +36,8 @@ In this guide, you learn how to:
 
 ## Prerequisites
 
-- Verify you've created your storage account in the same location as your Application Insights resource.
-- If you've enabled [Private Link](../logs/private-link-security.md), allow connection to our Trusted Microsoft Service from your virtual network.
+- Verify you created your storage account in the same location as your Application Insights resource.
+- If you enabled [Private Link](../logs/private-link-security.md), allow connection to our Trusted Microsoft Service from your virtual network.
 
 ## Grant Diagnostic Services access to your storage account
 
@@ -55,7 +55,7 @@ A BYOS storage account is linked to an Application Insights resource. Start by g
     | Assign access to | User, group, or service principal |
     | Members | Diagnostic Services Trusted Storage Access |
 
-    :::image type="content" source="media/profiler-bring-your-own-storage/add-role-assignment-page.png" alt-text="Screenshot that shows the Add role assignment page in the Azure portal.":::
+    :::image type="content" source="media/profiler-bring-your-own-storage/add-role-assignment-page.png" alt-text="Screenshot that shows the role assignment page in the Azure portal.":::
 
    Once assigned, you can see the role under the **Role assignments** section.
        :::image type="content" source="media/profiler-bring-your-own-storage/figure-11.png" alt-text="Screenshot that shows the IAM screen after Role assignments.":::
@@ -242,14 +242,14 @@ Before you begin, [install the Azure CLI](/cli/azure/install-azure-cli).
 
 ## Troubleshooting
 
-This section offers troubleshooting tips for common issues in configuring BYOS. 
+Troubleshoot common issues in configuring BYOS. 
 
 - For general Profiler troubleshooting, see the [Profiler troubleshooting documentation](profiler-troubleshooting.md).
 - For general Snapshot Debugger troubleshooting, see the [Snapshot Debugger troubleshooting documentation](/troubleshoot/azure/azure-monitor/app-insights/snapshot-debugger-troubleshoot).
 
 ### Scenario: Template schema '{schema_uri}' isn't supported
 
-You've received an error similar to the following example:
+You received an error similar to the following example:
 
 ```powershell
 New-AzResourceGroupDeployment : 11:53:49 AM - Error: Code=InvalidTemplate; Message=Deployment template validation failed: 'Template schema
@@ -268,7 +268,7 @@ New-AzResourceGroupDeployment : 11:53:49 AM - Error: Code=InvalidTemplate; Messa
 
 ### Scenario: No registered resource provider found for location '{location}'
 
-You've received an error similar to the following example:
+You received an error similar to the following example:
 
 ```powershell
 New-AzResourceGroupDeployment : 6:18:03 PM - Resource microsoft.insights/components 'byos-test-westus2-ai' failed with message '{
@@ -289,7 +289,7 @@ australiasoutheast'."
 
 ### Scenario: Storage account location should match Application Insights component location
 
-You've received an error similar to the following example:
+You received an error similar to the following example:
 
 ```powershell
 New-AzResourceGroupDeployment : 1:01:12 PM - Resource microsoft.insights/components/linkedStorageAccounts 'byos-test-centralus-ai/serviceprofiler' failed with message '{
@@ -313,7 +313,7 @@ Make sure that the location of the Application Insights resource is the same as
 
 This section provides answers to common questions about configuring BYOS for Profiler and Snapshot Debugger.
 
-### If I've enabled Profiler/Snapshot Debugger and BYOS, is my data migrated into my storage account?
+### If I enabled Profiler/Snapshot Debugger and BYOS, is my data migrated into my storage account?
 
   No, it won't.
 
@@ -329,7 +329,7 @@ This section provides answers to common questions about configuring BYOS for Pro
 
   Yes, it's possible.
 
-### If I've enabled BYOS, can I go back to using Diagnostic Services storage accounts to store my collected data?
+### If I enabled BYOS, can I go back to using Diagnostic Services storage accounts to store my collected data?
 
   Yes, you can, but we don't currently support data migration from your BYOS.
 

articles/azure-monitor/profiler/profiler-cloudservice.md

@@ -1,9 +1,9 @@
 ---
-title: Enable Profiler for Azure Cloud Services | Microsoft Docs
+title: Enable Profiler for Azure Cloud Services
 description: Profile Azure Cloud Services in real time with Application Insights Profiler.
-ms.topic: conceptual
+ms.topic: how-to
 ms.custom: engagement
-ms.date: 09/22/2023
+ms.date: 08/16/2024
 ---
 
 # Enable Profiler for Azure Cloud Services

articles/azure-monitor/profiler/profiler-containers.md

@@ -3,7 +3,7 @@ title: Profile Azure containers with Application Insights Profiler
 description: Learn how to enable the Application Insights Profiler for your ASP.NET Core application running in Azure containers.
 ms.contributor: charles.weininger
 ms.topic: how-to
-ms.date: 09/22/2023
+ms.date: 08/19/2024
 ms.reviewer: ryankahng
 # Customer Intent: As a .NET developer, I'd like to learn how to enable Profiler on my ASP.NET Core application running in my container.
 ---
@@ -17,10 +17,10 @@ You can enable the Application Insights Profiler for ASP.NET Core application ru
 - Set up the Application Insights instrumentation key.
 
 In this article, you learn about the various ways that you can:
-
-- Install the NuGet package in the project.
-- Set the environment variable via the orchestrator (like Kubernetes).
-- Learn security considerations around production deployment, like protecting your Application Insights instrumentation key.
+> [!div class="checklist"]
+> - Install the NuGet package in the project.
+> - Set the environment variable via the orchestrator (like Kubernetes).
+> - Learn security considerations around production deployment, like protecting your Application Insights instrumentation key.
 
 ## Prerequisites
 

articles/azure-monitor/profiler/profiler-servicefabric.md

@@ -1,21 +1,21 @@
 ---
 title: Enable Profiler for Azure Service Fabric applications
 description: Profile live Azure Service Fabric apps with Application Insights.
-ms.topic: conceptual
+ms.topic: how-to
 ms.custom:
-ms.date: 09/22/2023
+ms.date: 08/16/2024
 ---
 
 # Enable Profiler for Azure Service Fabric applications
 
 Application Insights Profiler is included with Azure Diagnostics. You can install the Azure Diagnostics extension by using an Azure Resource Manager template (ARM template) for your Azure Service Fabric cluster. Get a [template that installs Azure Diagnostics on a Service Fabric cluster](https://github.com/Azure/azure-docs-json-samples/blob/master/application-insights/ServiceFabricCluster.json).
 
-In this article, you:
-
-- Add the Application Insights Profiler property to your ARM template.
-- Deploy your Service Fabric cluster with the Application Insights Profiler instrumentation key.
-- Enable Application Insights on your Service Fabric application.
-- Redeploy your Service Fabric cluster to enable Profiler.
+In this guide, you learn how to:
+> [!div class="checklist"]
+> - Add the Application Insights Profiler property to your ARM template.
+> - Deploy your Service Fabric cluster with the Application Insights Profiler instrumentation key.
+> - Enable Application Insights on your Service Fabric application.
+> - Redeploy your Service Fabric cluster to enable Profiler.
 
 ## Prerequisites
 

articles/azure-monitor/profiler/profiler-trackrequests.md

@@ -1,9 +1,9 @@
 ---
 title: Write code to track requests with Application Insights | Microsoft Docs
 description: Write code to track requests with Application Insights so you can get profiles for your requests.
-ms.topic: conceptual
+ms.topic: how-to
 ms.custom: devx-track-csharp
-ms.date: 09/22/2023
+ms.date: 08/19/2024
 ms.reviewer: charles.weininger
 ---
 
@@ -15,71 +15,71 @@ For other applications (like Azure Cloud Services worker roles and Azure Service
 
 To manually track requests:
 
-  1. Early in the application lifetime, add the following code:
+1. Early in the application lifetime, add the following code:
 
-        ```csharp
-        using Microsoft.ApplicationInsights.Extensibility;
-        ...
-        // Replace with your own Application Insights instrumentation key.
-        TelemetryConfiguration.Active.InstrumentationKey = "00000000-0000-0000-0000-000000000000";
-        ```
+   ```csharp
+   using Microsoft.ApplicationInsights.Extensibility;
+   ...
+   // Replace with your own Application Insights instrumentation key.
+   TelemetryConfiguration.Active.InstrumentationKey = "00000000-0000-0000-0000-000000000000";
+   ```
 
-      For more information about this global instrumentation key configuration, see [Use Service Fabric with Application Insights](https://github.com/Azure-Samples/service-fabric-dotnet-getting-started/blob/dev/appinsights/ApplicationInsights.md).
+   For more information about this global instrumentation key configuration, see [Use Service Fabric with Application Insights](https://github.com/Azure-Samples/service-fabric-dotnet-getting-started/blob/dev/appinsights/ApplicationInsights.md).
 
-  1. For any piece of code that you want to instrument, add a `StartOperation<RequestTelemetry>` **using** statement around it, as shown in the following example:
+1. For any piece of code that you want to instrument, add a `StartOperation<RequestTelemetry>` **using** statement around it, as shown in the following example:
 
-        ```csharp
-        using Microsoft.ApplicationInsights;
-        using Microsoft.ApplicationInsights.DataContracts;
-        ...
-        var client = new TelemetryClient();
-        ...
-        using (var operation = client.StartOperation<RequestTelemetry>("Insert_Your_Custom_Event_Unique_Name"))
-        {
-          // ... Code I want to profile.
-        }
-        ```
+   ```csharp
+   using Microsoft.ApplicationInsights;
+   using Microsoft.ApplicationInsights.DataContracts;
+   ...
+   var client = new TelemetryClient();
+   ...
+   using (var operation = client.StartOperation<RequestTelemetry>("Insert_Your_Custom_Event_Unique_Name"))
+   {
+     // ... Code I want to profile.
+   }
+   ```
 
-      Calling `StartOperation<RequestTelemetry>` within another `StartOperation<RequestTelemetry>` scope isn't supported. You can use `StartOperation<DependencyTelemetry>` in the nested scope instead. For example:
+1. Calling `StartOperation<RequestTelemetry>` within another `StartOperation<RequestTelemetry>` scope isn't supported. You can use `StartOperation<DependencyTelemetry>` in the nested scope instead. For example:
 
-        ```csharp
-        using (var getDetailsOperation = client.StartOperation<RequestTelemetry>("GetProductDetails"))
-        {
-        try
-        {
-          ProductDetail details = new ProductDetail() { Id = productId };
-          getDetailsOperation.Telemetry.Properties["ProductId"] = productId.ToString();
-        
-          // By using DependencyTelemetry, 'GetProductPrice' is correctly linked as part of the 'GetProductDetails' request.
-          using (var getPriceOperation = client.StartOperation<DependencyTelemetry>("GetProductPrice"))
-          {
-              double price = await _priceDataBase.GetAsync(productId);
-              if (IsTooCheap(price))
-              {
-                  throw new PriceTooLowException(productId);
-              }
-              details.Price = price;
-          }
-        
-          // Similarly, note how 'GetProductReviews' doesn't establish another RequestTelemetry.
-          using (var getReviewsOperation = client.StartOperation<DependencyTelemetry>("GetProductReviews"))
-          {
-              details.Reviews = await _reviewDataBase.GetAsync(productId);
-          }
-        
-          getDetailsOperation.Telemetry.Success = true;
-          return details;
-        }
-        catch(Exception ex)
-        {
-          getDetailsOperation.Telemetry.Success = false;
-        
-          // This exception gets linked to the 'GetProductDetails' request telemetry.
-          client.TrackException(ex);
-          throw;
-        }
-        }
-        ```
+   ```csharp
+   using (var getDetailsOperation = client.Operation<RequestTelemetry>("GetProductDetails"))
+   {
+     try
+     {
+       ProductDetail details = new ProductDetail() { Id = productId };
+       getDetailsOperation.Telemetry.Properties["ProductId"] = productId.ToString();
+          
+       // By using DependencyTelemetry, 'GetProductPrice' is correctly linked as part of the 'GetProductDetails' request.
+       using (var getPriceOperation = client.StartOperation<DependencyTelemetry>("GetProductPrice"))
+       {
+           double price = await _priceDataBase.GetAsync(productId);
+           if (IsTooCheap(price))
+           {
+               throw new PriceTooLowException(productId);
+           }
+           details.Price = price;
+       }
+          
+       // Similarly, note how 'GetProductReviews' doesn't establish another RequestTelemetry.
+       using (var getReviewsOperation = client.StartOperation<DependencyTelemetry>("GetProductReviews"))
+       {
+           details.Reviews = await _reviewDataBase.GetAsync(productId);
+       }
+          
+       getDetailsOperation.Telemetry.Success = true;
+       return details;
+     }
+     catch(Exception ex)
+     {
+       getDetailsOperation.Telemetry.Success = false;
+          
+       // This exception gets linked to the 'GetProductDetails' request telemetry.
+       client.TrackException(ex);
+       throw;
+     }
+   }
+   ```
 
 [!INCLUDE [azure-monitor-log-analytics-rebrand](~/reusable-content/ce-skilling/azure/includes/azure-monitor-instrumentation-key-deprecation.md)]
 

articles/azure-monitor/profiler/profiler-troubleshooting.md

@@ -2,7 +2,7 @@
 title: Troubleshoot Application Insights Profiler
 description: Walk through troubleshooting steps and information to enable and use Application Insights Profiler.
 ms.topic: conceptual
-ms.date: 07/10/2023
+ms.date: 08/19/2024
 ms.reviewer: charles.weininger
 ---
 

articles/azure-monitor/profiler/profiler-vm.md

@@ -1,8 +1,8 @@
 ---
 title: Enable Profiler for web apps on an Azure virtual machine
 description: Profile web apps running on an Azure virtual machine or a virtual machine scale set by using Application Insights Profiler
-ms.topic: conceptual
-ms.date: 09/22/2023
+ms.topic: how-to
+ms.date: 08/19/2024
 ms.reviewer: charles.weininger
 ---
 
@@ -16,12 +16,14 @@ In this article, you learn how to run Application Insights Profiler on your Azur
 - PowerShell
 - Azure Resource Explorer
 
-With any of these methods, you:
+Select your preferred method tab to:
 
-- Configure the Azure Diagnostics extension to run Profiler.
-- Install the Application Insights SDK on a VM.
-- Deploy your application.
-- View Profiler traces via the Application Insights instance in the Azure portal.
+In this guide, you learn how to:
+> [!div class="checklist"]
+> - Configure the Azure Diagnostics extension to run Profiler.
+> - Install the Application Insights SDK on a VM.
+> - Deploy your application.
+> - View Profiler traces via the Application Insights instance in the Azure portal.
 
 ## Prerequisites