Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into sasBk

Author: roygara

.openpublishing.redirection.azure-monitor.json

@@ -1,5 +1,10 @@
 {
     "redirections": [
+        {
+            "source_path_from_root": "/articles/azure-monitor/snapshot-debugger/snapshot-debugger-upgrade.md",
+            "redirect_url": "/azure/azure-monitor/snapshot-debugger/snapshot-debugger#upgrading-snapshot-debugger",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/azure-monitor/snapshot-debugger/snapshot-collector-release-notes.md",
             "redirect_url": "/azure/azure-monitor/snapshot-debugger/snapshot-debugger#release-notes-for-microsoftapplicationinsightssnapshotcollector",
@@ -6881,12 +6886,12 @@
         },
         {
           "source_path_from_root": "/articles/azure-monitor/containers/container-insights-private-link.md",
-          "redirect_url": "/previous-versions/azure/azure-monitor/containers/kubernetes-monitoring-private-link",
+          "redirect_url": "/azure/azure-monitor/containers/kubernetes-monitoring-private-link",
           "redirect_document_id": false
         },
         {
           "source_path_from_root": "/articles/azure-monitor/essentials/private-link-data-ingestion.md",
-          "redirect_url": "/previous-versions/azure/azure-monitor/containers/kubernetes-monitoring-private-link",
+          "redirect_url": "/azure/azure-monitor/containers/kubernetes-monitoring-private-link",
           "redirect_document_id": false
         }
     ]

articles/azure-fluid-relay/images/rotate-tenant-keys.png

@@ -31,9 +31,6 @@ Azure Functions supports C# and C# script programming languages. If you're looki
 
 ### Updating to target .NET 8
 
-> [!NOTE]
-> Targeting .NET 8 with the in-process model is not yet enabled for apps in sovereign clouds. Updates will be communicated on [this tracking thread on GitHub](https://github.com/Azure/azure-functions-host/issues/9951).
-
 Apps using the in-process model can target .NET 8 by following the steps outlined in this section. However, if you choose to exercise this option, you should still begin planning your [migration to the isolated worker model](./migrate-dotnet-to-isolated-model.md) in advance of [support ending for the in-process model on November 10, 2026](https://aka.ms/azure-functions-retirements/in-process-model).
 
 Many apps can change the configuration of the function app in Azure without updates to code or redeployment. To run .NET 8 with the in-process model, three configurations are required:

articles/azure-functions/functions-dotnet-class-library.md

@@ -7,7 +7,7 @@ ms.service: azure-government
 ms.topic: article
 ms.custom: references_regions
 recommendations: false
-ms.date: 05/09/2023
+ms.date: 08/15/2024
 ---
 
 # Department of Defense (DoD) in Azure Government
@@ -92,7 +92,7 @@ The following services are in scope for DoD IL5 PA in US DoD regions (US DoD Cen
 - [Microsoft Stream](/stream/overview)
 - [Network Watcher](https://azure.microsoft.com/services/network-watcher/)
 - [Power Apps](/powerapps/powerapps-overview)
-- [Power Apps portal](https://powerapps.microsoft.com/portals/)
+- [Power Pages](https://powerapps.microsoft.com/portals/)
 - [Power Automate](/power-automate/getting-started) (formerly Microsoft Flow)
 - [Power BI](https://powerbi.microsoft.com/)
 - [Power BI Embedded](https://azure.microsoft.com/services/power-bi-embedded/)

articles/azure-government/documentation-government-overview-dod.md

@@ -1,7 +1,7 @@
 ---
 title: Enable Snapshot Debugger for .NET apps in Azure App Service | Microsoft Docs
 description: Enable Snapshot Debugger for .NET apps in Azure App Service
-ms.topic: conceptual
+ms.topic: how-to
 ms.author: hannahhunter
 author: hhunter-ms
 ms.reviewer: charles.weininger
@@ -12,98 +12,51 @@ ms.custom: devdivchpfy22, devx-track-arm-template, devx-track-dotnet
 
 # Enable Snapshot Debugger for .NET apps in Azure App Service
 
-Snapshot Debugger currently supports ASP.NET and ASP.NET Core apps that are running on Azure App Service on Windows service plans.
-
 > [!NOTE]
-> We recommend that you run your application on the Basic service tier, or higher, when using Snapshot Debugger. For most applications, the Free and Shared service tiers don't have enough memory or disk space to save snapshots. The Consumption tier is not currently available for Snapshot Debugger.
+> If you're using a preview version of .NET Core, or your application references Application Insights SDK (directly or indirectly via a dependent assembly), follow the instructions for [Enable Snapshot Debugger for other environments](snapshot-debugger-vm.md) to include the [`Microsoft.ApplicationInsights.SnapshotCollector`](https://www.nuget.org/packages/Microsoft.ApplicationInsights.SnapshotCollector) NuGet package with the application.
 
-## <a id="installation"></a> Enable Snapshot Debugger
+Snapshot Debugger currently supports ASP.NET and ASP.NET Core apps running on Azure App Service on Windows service plans.
 
-Snapshot Debugger is pre-installed as part of the App Services runtime, but you need to turn it on to get snapshots for your App Service app. To enable Snapshot Debugger for an app, follow the instructions below:
+We recommend that you run your application on the Basic or higher service tiers when using Snapshot Debugger. For most applications:
+- The Free and Shared service tiers don't have enough memory or disk space to save snapshots. 
+- The Consumption tier isn't currently available for Snapshot Debugger.
 
-> [!NOTE]
-> If you're using a preview version of .NET Core, or your application references Application Insights SDK (directly or indirectly via a dependent assembly), follow the instructions for [Enable Snapshot Debugger for other environments](snapshot-debugger-vm.md) to include the [`Microsoft.ApplicationInsights.SnapshotCollector`](https://www.nuget.org/packages/Microsoft.ApplicationInsights.SnapshotCollector) NuGet package with the application.
+Although Snapshot Debugger is preinstalled as part of the App Services runtime, you need to turn it on to get snapshots for your App Service app. Codeless installation of Snapshot Debugger follows [the .NET Core support policy.](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).
 
-> [!NOTE]
-> Codeless installation of Application Insights Snapshot Debugger follows the .NET Core support policy.
-> For more information about supported runtimes, see [.NET Core Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).
+# [Azure portal](#tab/portal)
 
-After you've deployed your .NET app:
+After you've deployed your .NET App Services web app:
 
-1. Go to the Azure control panel for your App Service.
-1. Go to the **Settings** > **Application Insights** page.
+1. Navigate to your App Service in the Azure portal. 
+1. In the left-side menu, select **Settings** > **Application Insights**.
 
    :::image type="content" source="./media/snapshot-debugger/application-insights-app-services.png" alt-text="Screenshot showing the Enable App Insights on App Services portal.":::
 
-1. Either follow the instructions on the page to create a new resource or select an existing App Insights resource to monitor your app.
-1. Switch Snapshot Debugger toggles to **On**.
+1. Click **Turn on Application Insights**.
+   - If you have an existing Application Insights resource you'd rather use, select that option under **Change your resource**. 
+1. Under **Instrument your application**, select the **.NET** tab. 
+1. Switch both Snapshot Debugger toggles to **On**.
 
    :::image type="content" source="./media/snapshot-debugger/enablement-ui.png" alt-text="Screenshot showing how to add App Insights site extension.":::
 
-1. Snapshot Debugger is now enabled using an App Services App Setting.
+1. Snapshot Debugger is now enabled.
 
     :::image type="content" source="./media/snapshot-debugger/snapshot-debugger-app-setting.png" alt-text="Screenshot showing App Setting for Snapshot Debugger.":::
 
-If you're running a different type of Azure service, here are instructions for enabling Snapshot Debugger on other supported platforms:
-
-* [Azure Function](snapshot-debugger-function-app.md?toc=/azure/azure-monitor/toc.json)
-* [Azure Cloud Services](snapshot-debugger-vm.md?toc=/azure/azure-monitor/toc.json)
-* [Azure Service Fabric services](snapshot-debugger-vm.md?toc=/azure/azure-monitor/toc.json)
-* [Azure Virtual Machines and Virtual Machine Scale Sets](snapshot-debugger-vm.md?toc=/azure/azure-monitor/toc.json)
-* [On-premises virtual or physical machines](snapshot-debugger-vm.md?toc=/azure/azure-monitor/toc.json)
-  
-## Enable Snapshot Debugger for other clouds
-
-Currently the only regions that require endpoint modifications are [Azure Government](../../azure-government/compare-azure-government-global-azure.md#application-insights) and [Microsoft Azure operated by 21Vianet](/azure/china/resources-developer-guide) through the Application Insights Connection String.
-
-|Connection String Property    | US Government Cloud | China Cloud |  
-|---------------|---------------------|-------------|
-|SnapshotEndpoint         | `https://snapshot.monitor.azure.us`    | `https://snapshot.monitor.azure.cn` |
-
-For more information about other connection overrides, see [Application Insights documentation](../app/sdk-connection-string.md?tabs=net#connection-string-with-explicit-endpoint-overrides).
-
-<a name='enable-azure-active-directory-authentication-for-snapshot-ingestion'></a>
-
-## Enable Microsoft Entra authentication for snapshot ingestion
-
-Application Insights Snapshot Debugger supports Microsoft Entra authentication for snapshot ingestion. This means, for all snapshots of your application to be ingested, your application must be authenticated and provide the required application settings to the Snapshot Debugger agent.
-
-As of today, Snapshot Debugger only supports Microsoft Entra authentication when you reference and configure Microsoft Entra ID using the Application Insights SDK in your application.
-
-To turn-on Microsoft Entra ID for snapshot ingestion:
-
-1. Create and add the managed identity you want to use to authenticate against your Application Insights resource to your App Service.
-
-    1. For System-Assigned Managed identity, see the following [documentation](../../app-service/overview-managed-identity.md?tabs=portal%2chttp#add-a-system-assigned-identity).
-
-    1. For User-Assigned Managed identity, see the following [documentation](../../app-service/overview-managed-identity.md?tabs=portal%2chttp#add-a-user-assigned-identity).
-
-1. Configure and turn on Microsoft Entra ID in your Application Insights resource. For more information, see the following [documentation](../app/azure-ad-authentication.md?tabs=net#configure-and-enable-azure-ad-based-authentication)
-1. Add the following application setting, used to let Snapshot Debugger agent know which managed identity to use:
-
-For System-Assigned Identity:
-
-|App Setting    | Value    |
-|---------------|----------|
-|APPLICATIONINSIGHTS_AUTHENTICATION_STRING         | Authorization=AD    |
-
-For User-Assigned Identity:
-
-|App Setting    | Value    |
-|---------------|----------|
-|APPLICATIONINSIGHTS_AUTHENTICATION_STRING         | Authorization=AD;ClientID={Client ID of the User-Assigned Identity}    |
-
 ## Disable Snapshot Debugger
 
-To disable Snapshot Debugger, repeat the [steps for enabling](#installation). However, switch the Snapshot Debugger toggles to **Off**.
+To disable Snapshot Debugger for your App Services resource:
+1. Navigate to your App Service in the Azure portal. 
+1. In the left-side menu, select **Settings** > **Application Insights**.
+1. Switch the Snapshot Debugger toggles to **Off**.
 
-## Azure Resource Manager template
+# [Azure Resource Manager](#tab/arm)
 
-For an Azure App Service, you can set app settings within the Azure Resource Manager template to enable Snapshot Debugger and Profiler. For example:
+You can also set app settings within the Azure Resource Manager template to enable Snapshot Debugger and Profiler. For example:
 
 ```json
 {
-  "apiVersion": "2015-08-01",
+  "apiVersion": "2023-12-01",
   "name": "[parameters('webSiteName')]",
   "type": "Microsoft.Web/sites",
   "location": "[resourceGroup().location]",
@@ -129,7 +82,7 @@ For an Azure App Service, you can set app settings within the Azure Resource Man
       ],
       "properties": {
         "APPINSIGHTS_INSTRUMENTATIONKEY": "[reference(resourceId('Microsoft.Insights/components', concat('AppInsights', parameters('webSiteName'))), '2014-04-01').InstrumentationKey]",
-        "APPINSIGHTS_PROFILERFEATURE_VERSION": "1.0.0",
+        // "Turn on" a Snapshot Debugger version
         "APPINSIGHTS_SNAPSHOTFEATURE_VERSION": "1.0.0",
         "DiagnosticServices_EXTENSION_VERSION": "~3",
         "ApplicationInsightsAgent_EXTENSION_VERSION": "~2"
@@ -139,19 +92,63 @@ For an Azure App Service, you can set app settings within the Azure Resource Man
 },
 ```
 
-## Not Supported Scenarios
+---
+
+Generate traffic to your application that can trigger an exception. Then, wait 10 to 15 minutes for snapshots to be sent to the Application Insights instance.
+
+## Enable Snapshot Debugger for other cloud regions
+
+Currently the only regions that require endpoint modifications are [Azure Government](../../azure-government/compare-azure-government-global-azure.md#application-insights) and [Microsoft Azure operated by 21Vianet](/azure/china/resources-developer-guide) through the Application Insights Connection String.
+
+|Connection String Property    | US Government Cloud | China Cloud |  
+|---------------|---------------------|-------------|
+|SnapshotEndpoint         | `https://snapshot.monitor.azure.us`    | `https://snapshot.monitor.azure.cn` |
+
+For more information about other connection overrides, see [Application Insights documentation](../app/sdk-connection-string.md?tabs=net#connection-string-with-explicit-endpoint-overrides).
+
+## Configure Snapshot Debugger
+
+### Enable Microsoft Entra authentication for snapshot ingestion
+
+Snapshot Debugger supports Microsoft Entra authentication for snapshot ingestion. For all snapshots of your application to be ingested, your application must be authenticated and provide the required application settings to the Snapshot Debugger agent.
+
+As of today, Snapshot Debugger only supports Microsoft Entra authentication when you reference and configure Microsoft Entra ID using the Application Insights SDK in your application.
+
+To turn on Microsoft Entra ID for snapshot ingestion in your App Services resource:
+
+1. Add the managed identity that authenticates against your Application Insights resource to your App Service. You can create either:
+
+    - [Add a  System-Assigned Managed identity](../../app-service/overview-managed-identity.md?tabs=portal%2chttp#add-a-system-assigned-identity).
+    - [Add a User-Assigned Managed identity](../../app-service/overview-managed-identity.md?tabs=portal%2chttp#add-a-user-assigned-identity).
+
+1. Configure and turn on Microsoft Entra ID in your Application Insights resource. For more information, see the following [documentation](../app/azure-ad-authentication.md?tabs=net#configure-and-enable-azure-ad-based-authentication)
+
+1. Add the following application setting. This setting tells the Snapshot Debugger agent which managed identity to use:
+
+For System-Assigned Identity:
+
+|App Setting    | Value    |
+|---------------|----------|
+|APPLICATIONINSIGHTS_AUTHENTICATION_STRING         | Authorization=AD    |
+
+For User-Assigned Identity:
+
+|App Setting    | Value    |
+|---------------|----------|
+|APPLICATIONINSIGHTS_AUTHENTICATION_STRING         | Authorization=AD;ClientID={Client ID of the User-Assigned Identity}    |
+
+## Unsupported scenarios
 
 Below you can find scenarios where Snapshot Collector isn't supported:
 
 |Scenario    | Side Effects | Recommendation |
 |------------|--------------|----------------|
-|You're using the Snapshot Collector SDK in your application directly (*.csproj*) and have enabled the advanced option "Interop".| The local Application Insights SDK (including Snapshot Collector telemetry) will be lost and no Snapshots will be available. <br/> Your application could crash at startup with `System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor.` <br/> [Learn more about the Application Insights feature "Interop".](../app/azure-web-apps-net-core.md#troubleshooting) | If you're using the advanced option "Interop", use the codeless Snapshot Collector injection (enabled through the Azure portal). |
+|You're using the Snapshot Collector SDK in your application directly (*.csproj*) and enabled the advanced option "Interop".| The local Application Insights SDK (including Snapshot Collector telemetry) are lost and no Snapshots are available. <br/> Your application could crash at startup with `System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor.` <br/> [Learn more about the Application Insights feature "Interop".](../app/azure-web-apps-net-core.md#troubleshooting) | If you're using the advanced option "Interop", use the codeless Snapshot Collector injection (enabled through the Azure portal). |
 
 ## Next steps
 
-* Generate traffic to your application that can trigger an exception. Then, wait 10 to 15 minutes for snapshots to be sent to the Application Insights instance.
-* See [snapshots](snapshot-debugger-data.md?toc=/azure/azure-monitor/toc.json#view-snapshots-in-the-portal) in the Azure portal.
-* For help with troubleshooting Snapshot Debugger issues, see [Snapshot Debugger troubleshooting](snapshot-debugger-troubleshoot.md).
+- View [snapshots](snapshot-debugger-data.md?toc=/azure/azure-monitor/toc.json#access-debug-snapshots-in-the-portal) in the Azure portal.
+- [Troubleshoot Snapshot Debugger issues](snapshot-debugger-troubleshoot.md).
 
 [Enablement UI]: ./media/snapshot-debugger/enablement-ui.png
 [snapshot-debugger-app-setting]:./media/snapshot-debugger/snapshot-debugger-app-setting.png