Merge pull request MicrosoftDocs#48 from hhunter-ms/hh-256455

[Change Analysis] Update name to include "(classic)"

articles/azure-monitor/change/change-analysis-enable.md

@@ -1,42 +1,42 @@
 ---
-title: Enable Change Analysis | Microsoft Docs
-description: Use Change Analysis in Azure Monitor to track and troubleshoot issues on your live site.
+title: Enable Change Analysis (classic) | Microsoft Docs
+description: Use Change Analysis (classic) in Azure Monitor to track and troubleshoot issues on your live site.
 ms.topic: conceptual
 ms.author: hannahhunter
 author: hhunter-ms
-ms.date: 11/17/2023
+ms.date: 09/12/2024
 ms.subservice: change-analysis
 ---
 
-# Enable Change Analysis
+# Enable Change Analysis (classic)
 
 [!INCLUDE [transition](../includes/change/change-analysis-is-moving.md)]
 
-The Change Analysis service:
+The Change Analysis (classic) service:
 - Computes and aggregates change data from the data sources mentioned earlier. 
 - Provides a set of analytics for users to:
     - Easily navigate through all resource changes.
     - Identify relevant changes in the troubleshooting or monitoring context.
 
 Register the `Microsoft.ChangeAnalysis` resource provider with an Azure Resource Manager subscription to make the resource properties and configuration change data available. The `Microsoft.ChangeAnalysis` resource provider is automatically registered as you either: 
 - Enter any UI entry point, like the Web App **Diagnose and Solve Problems** tool, or 
-- Bring up the Change Analysis standalone tab.
+- Bring up the Change Analysis (classic) standalone tab.
 
-In this guide, you learn the two ways to enable Change Analysis for Azure Functions and web app in-guest changes:
-- For one or a few Azure Functions or web apps, [enable Change Analysis via the UI](#enable-azure-functions-and-web-app-in-guest-change-collection-via-the-change-analysis-portal).
-- For a large number of web apps (for example, 50+ web apps), [enable Change Analysis using the provided PowerShell script](#enable-change-analysis-at-scale-using-powershell).
+In this guide, you learn the two ways to enable Change Analysis (classic) for Azure Functions and web app in-guest changes:
+- For one or a few Azure Functions or web apps, [enable Change Analysis (classic) via the UI](#enable-azure-functions-and-web-app-in-guest-change-collection-via-the-change-analysis-classic-portal).
+- For a large number of web apps (for example, 50+ web apps), [enable Change Analysis (classic) using the provided PowerShell script](#enable-change-analysis-classic-at-scale-using-powershell).
 
 > [!NOTE]
 > Slot-level enablement for Azure Functions or web app is not supported at the moment.
 
-## Enable Azure Functions and web app in-guest change collection via the Change Analysis portal
+## Enable Azure Functions and web app in-guest change collection via the Change Analysis (classic) portal
 
-For web app in-guest changes, separate enablement is required for scanning code files within a web app. For more information, see [Change Analysis in the Diagnose and solve problems tool](change-analysis-visualizations.md#view-changes-using-the-diagnose-and-solve-problems-tool) section.
+For web app in-guest changes, separate enablement is required for scanning code files within a web app. For more information, see [Change Analysis (classic) in the Diagnose and solve problems tool](change-analysis-visualizations.md#view-changes-using-the-diagnose-and-solve-problems-tool) section.
 
 > [!NOTE]
 > You may not immediately see web app in-guest file changes and configuration changes. Prepare for downtime and restart your web app to view changes within 30 minutes. If you still can't see changes, refer to [the troubleshooting guide](./change-analysis-troubleshoot.md#cannot-see-in-guest-changes-for-newly-enabled-web-app).
 
-1. Navigate to Azure Monitor's Change Analysis UI in the portal. 
+1. Navigate to Change Analysis (classic) UI in the portal. 
 
 1. Enable web app in-guest change tracking by either:
 
@@ -48,15 +48,11 @@ For web app in-guest changes, separate enablement is required for scanning code
 
      :::image type="content" source="./media/change-analysis/configure-button.png" alt-text="Screenshot of the Application Changes options from the top menu."::: 
 
-1. Toggle on **Change Analysis** status and select **Save**.
+1. Toggle on **Change Analysis (classic)** status for applicable resources and select **Save**.
 
-   :::image type="content" source="./media/change-analysis/change-analysis-on.png" alt-text="Screenshot of the Enable Change Analysis user interface.":::   
+   :::image type="content" source="./media/change-analysis/change-analysis-on.png" alt-text="Screenshot of the Enable Change Analysis (classic) user interface.":::   
 
-    - The tool displays all web apps under an App Service plan, which you can toggle on and off individually. 
-
-      :::image type="content" source="./media/change-analysis/change-analysis-on-2.png" alt-text="Screenshot of the Enable Change Analysis user interface expanded.":::   
-
-## Enable Change Analysis at scale using PowerShell
+## Enable Change Analysis (classic) at scale using PowerShell
 
 If your subscription includes several web apps, run the following script to enable *all web apps* in your subscription.
 
@@ -93,13 +89,13 @@ foreach ($webapp in $webapp_list)
 
 This section provides answers to common questions.
 
-### How can I enable Change Analysis for a web application?
+### How can I enable Change Analysis (classic) for a web application?
 
-Enable Change Analysis for web application in guest changes by using the [Diagnose and solve problems tool](./change-analysis-visualizations.md#view-changes-using-the-diagnose-and-solve-problems-tool).
+Enable Change Analysis (classic) for web application in guest changes by using the [Diagnose and solve problems tool](./change-analysis-visualizations.md#view-changes-using-the-diagnose-and-solve-problems-tool).
 
 ## Next steps
 
-- Learn about [visualizations in Change Analysis](change-analysis-visualizations.md)
-- Learn how to [troubleshoot problems in Change Analysis](change-analysis-troubleshoot.md)
+- Learn about [visualizations in Change Analysis (classic)](change-analysis-visualizations.md)
+- Learn how to [troubleshoot problems in Change Analysis (classic)](change-analysis-troubleshoot.md)
 - Enable Application Insights for [Azure web apps](../../azure-monitor/app/azure-web-apps.md).
 - Enable Application Insights for [Azure VM and Azure virtual machine scale set IIS-hosted apps](../../azure-monitor/app/azure-vm-vmss-apps.md).

articles/azure-monitor/change/change-analysis-track-outages.md

@@ -1,25 +1,25 @@
 ---
-title: "Tutorial: Track a web app outage using Change Analysis"
-description: Describes how to identify the root cause of a web app outage using Azure Monitor Change Analysis.
+title: "Tutorial: Track a web app outage using Change Analysis (classic)"
+description: Describes how to identify the root cause of a web app outage using Azure Monitor Change Analysis (classic).
 ms.topic: how-to
 ms.author: hannahhunter
 author: hhunter-ms
-ms.date: 11/17/2023
+ms.date: 09/12/2024
 ms.subservice: change-analysis
 ---
 
-# Tutorial: Track a web app outage using Change Analysis
+# Tutorial: Track a web app outage using Change Analysis (classic)
 
 [!INCLUDE [transition](../includes/change/change-analysis-is-moving.md)]
 
-When your application runs into an issue, you need configurations and resources to triage breaking changes and discover root-cause issues. Change Analysis provides a centralized view of the changes in your subscriptions for up to 14 days prior to provide the history of changes for troubleshooting issues.  
+When your application runs into an issue, you need configurations and resources to triage breaking changes and discover root-cause issues. Change Analysis (classic) provides a centralized view of the changes in your subscriptions for up to 14 days prior to provide the history of changes for troubleshooting issues.  
 
 To track an outage, we will: 
 
 > [!div class="checklist"]
 > - Clone, create, and deploy a [sample web application](https://github.com/Azure-Samples/changeanalysis-webapp-storage-sample) with a storage account.
-> - Enable Change Analysis to track changes for Azure resources and for Azure Web App configurations
-> - Troubleshoot a Web App issue using Change Analysis
+> - Enable Change Analysis (classic) to track changes for Azure resources and for Azure Web App configurations
+> - Troubleshoot a Web App issue using Change Analysis (classic)
 
 ## Prerequisites
 
@@ -37,7 +37,7 @@ To track an outage, we will:
    az account set -s {azure-subscription-id}
    ```
 
-1. Clone the [sample web application with storage to test Change Analysis](https://github.com/Azure-Samples/changeanalysis-webapp-storage-sample).
+1. Clone the [sample web application with storage to test Change Analysis (classic)](https://github.com/Azure-Samples/changeanalysis-webapp-storage-sample).
 
    ```bash
    git clone https://github.com/Azure-Samples/changeanalysis-webapp-storage-sample.git
@@ -68,22 +68,18 @@ To track an outage, we will:
 ./Publish-WebApp.ps1
 ```
 
-## Enable Change Analysis
+## Enable Change Analysis (classic)
 
-In the Azure portal, [navigate to the Change Analysis standalone UI](./change-analysis-visualizations.md#access-change-analysis-screens). Page loading may take a few minutes as the `Microsoft.ChangeAnalysis` resource provider is registered. 
+In the Azure portal, [navigate to the Change Analysis (classic) standalone UI](./change-analysis-visualizations.md#access-change-analysis-classic-screens). Page loading may take a few minutes as the `Microsoft.ChangeAnalysis` resource provider is registered. 
 
-:::image type="content" source="./media/change-analysis/change-analysis-blade.png" alt-text="Screenshot of Change Analysis in Azure portal.":::
-
-Once the Change Analysis page loads, you can see resource changes in your subscriptions. To view detailed web app in-guest change data:
+Once the Change Analysis (classic) page loads, you can see resource changes in your subscriptions. To view detailed web app in-guest change data:
 
 - Select **Enable now** from the banner, or 
 - Select **Configure** from the top menu.
 
 In the web app in-guest enablement pane, select the web app you'd like to enable: 
 
-:::image type="content" source="./media/change-analysis/enablement-pane.png" alt-text="Screenshot of Change Analysis enablement pane.":::
-
-Now Change Analysis is fully enabled to track both resources and web app in-guest changes. 
+Now Change Analysis (classic) is fully enabled to track both resources and web app in-guest changes. 
 
 ## Simulate a web app outage
 
@@ -97,9 +93,9 @@ Visit the web app URL to view the following error:
 
 :::image type="content" source="./media/change-analysis/outage-example.png" alt-text="Screenshot of simulated web app outage.":::
 
-## Troubleshoot the outage using Change Analysis
+## Troubleshoot the outage using Change Analysis (classic)
 
-In the Azure portal, navigate to the Change Analysis overview page. Since you triggered a web app outage, you can see an entry of change for `AzureStorageConnection`:
+In the Azure portal, navigate to the Change Analysis (classic) overview page. Since you triggered a web app outage, you can see an entry of change for `AzureStorageConnection`:
 
 Since the connection string is a secret value, we hide it on the overview page for security purposes. With sufficient permission to read the web app, you can select the change to view details around the old and new values: 
 
@@ -111,15 +107,15 @@ Now that you discovered the web app in-guest change and understand next steps, y
 
 ## Virtual network changes
 
-Knowing what changed in your application's networking resources is critical due to their effect on connectivity, availability, and performance. Change Analysis supports all network resource changes and captures those changes immediately. Networking changes include:
+Knowing what changed in your application's networking resources is critical due to their effect on connectivity, availability, and performance. Change Analysis (classic) supports all network resource changes and captures those changes immediately. Networking changes include:
 
 - Firewalls created or edited
 - Network critical changes (for example, blocking port 22 for TCP connections)
 - Load balancer changes
 - Virtual network changes
 
-The sample application includes a virtual network to make sure the application remains secure. Via the Azure portal, you can view and assess the network changes captured by Change Analysis. 
+The sample application includes a virtual network to make sure the application remains secure. Via the Azure portal, you can view and assess the network changes captured by Change Analysis (classic). 
 
 ## Next steps
 
-Learn more about [Change Analysis](./change-analysis.md).
+Learn more about [Change Analysis (classic)](./change-analysis.md).

articles/azure-monitor/change/change-analysis-troubleshoot.md

@@ -1,20 +1,20 @@
 ---
-title: Troubleshoot Azure Monitor's Change Analysis
-description: Learn how to troubleshoot problems in Azure Monitor's Change Analysis.
+title: Troubleshoot Change Analysis (classic)
+description: Learn how to troubleshoot problems in Change Analysis (classic).
 ms.topic: conceptual
 ms.author: hannahhunter
 author: hhunter-ms
-ms.date: 11/17/2023 
+ms.date: 09/12/2024
 ms.subservice: change-analysis
 ---
 
-# Troubleshoot Azure Monitor's Change Analysis
+# Troubleshoot Change Analysis (classic)
 
 [!INCLUDE [transition](../includes/change/change-analysis-is-moving.md)]
 
 ## Trouble registering Microsoft.ChangeAnalysis resource provider from Change history tab.
 
-If you're viewing Change history after its first integration with Azure Monitor's Change Analysis, you'll see it automatically registering the **Microsoft.ChangeAnalysis** resource provider. The resource may fail and incur the following error messages: 
+If you're viewing change history after its first integration with Change Analysis (classic), you'll see it automatically registering the **Microsoft.ChangeAnalysis** resource provider. The resource may fail and incur the following error messages: 
 
 ### You don't have enough permissions to register Microsoft.ChangeAnalysis resource provider.  
 You're receiving this error message because your role in the current subscription isn't associated with the **Microsoft.Support/register/action** scope. For example, you aren't the owner of your subscription and instead received shared access permissions through a coworker (like view access to a resource group). 
@@ -51,13 +51,13 @@ Changes should show up within a few hours of app restart. If your changes still
 ### Failed to query Microsoft.ChangeAnalysis resource provider.
 Often, this message includes: `Azure Lighthouse subscription is not supported, the changes are only available in the subscription's home tenant`. 
 
-Azure Lighthouse allows for cross-tenant resource administration. However, cross-tenant support needs to be built for each resource provider. Currently, Change Analysis has not built this support. If you're signed into one tenant, you can't query for resource or subscription changes whose home is in another tenant.
+Azure Lighthouse allows for cross-tenant resource administration. However, cross-tenant support needs to be built for each resource provider. Currently, Change Analysis (classic) has not built this support. If you're signed into one tenant, you can't query for resource or subscription changes whose home is in another tenant.
 
-If this is a blocking issue for you, [submit an Azure support ticket](https://azure.microsoft.com/support/) to describe how you're trying to use Change Analysis.
+If this is a blocking issue for you, [submit an Azure support ticket](https://azure.microsoft.com/support/) to describe how you're trying to use Change Analysis (classic).
 
 ## An error occurred while getting changes. Please refresh this page or come back later to view changes.
 
-When changes can't be loaded, Azure Monitor's Change Analysis service presents this general error message. A few known causes are:
+When changes can't be loaded, Change Analysis service presents this general error message. A few known causes are:
 
 - Internet connectivity error from the client device.
 - Change Analysis service being temporarily unavailable.
@@ -66,7 +66,7 @@ Refreshing the page after a few minutes usually fixes this issue. If the error p
 
 ## Only partial data loaded.
 
-This error message may occur in the Azure portal when loading change data via the Change Analysis home page. Typically, the Change Analysis service calculates and returns all change data. However, in a network failure or a temporary outage of service, you may receive an error message indicating only partial data was loaded.
+This error message may occur in the Azure portal when loading change data via the Change Analysis (classic) home page. Typically, the Change Analysis service calculates and returns all change data. However, in a network failure or a temporary outage of service, you may receive an error message indicating only partial data was loaded.
 
 To load all change data, try waiting a few minutes and refreshing the page. If you are still only receiving partial data, [submit an Azure support ticket](https://azure.microsoft.com/support/).
 
@@ -93,23 +93,19 @@ To troubleshoot virtual machine issues using the troubleshooting tool in the Azu
 1. Select **Diagnose and solve problems** from the side menu.
 1. Browse and select the troubleshooting tool that fits your issue.
 
-:::image type="content" source="./media/change-analysis/vm-dnsp-troubleshootingtools.png" lightbox="./media/change-analysis/vm-dnsp-troubleshootingtools.png" alt-text="Screenshot of the Diagnose and Solve Problems tool for a Virtual Machine with Troubleshooting tools selected.":::
-<!-- convertborder later -->
-:::image type="content" source="./media/change-analysis/analyze-recent-changes.png" lightbox="./media/change-analysis/analyze-recent-changes.png" alt-text="Screenshot of the tile for the Analyze recent changes troubleshooting tool for a Virtual Machine." border="false":::
-
 ## Can't filter to your resource to view changes
 
-When filtering down to a particular resource in the Change Analysis standalone page, you may encounter a known limitation that only returns 1,000 resource results. To filter through and pinpoint changes for one of your 1,000+ resources:
+When filtering down to a particular resource in the Change Analysis (classic) standalone page, you may encounter a known limitation that only returns 1,000 resource results. To filter through and pinpoint changes for one of your 1,000+ resources:
 
 1. In the Azure portal, select **All resources**.
 1. Select the actual resource you want to view.
 1. In that resource's left side menu, select **Diagnose and solve problems**.
-1. In the Change Analysis card, select **View change details**.
+1. In the Change Analysis (classic) card, select **View change details**.
 
-   :::image type="content" source="./media/change-analysis/change-details-card.png" lightbox="./media/change-analysis/change-details-card.png" alt-text="Screenshot of viewing change details from the Change Analysis card in Diagnose and solve problems tool.":::
+   :::image type="content" source="./media/change-analysis/change-details-card.png" lightbox="./media/change-analysis/change-details-card.png" alt-text="Screenshot of viewing change details from the Change Analysis (classic) card in Diagnose and solve problems tool.":::
 
 From here, you'll be able to view all of the changes for that one resource.
 
 ## Next steps
 
-Learn more about [Azure Resource Graph](/azure/governance/resource-graph/overview), which helps power Change Analysis.
+Learn more about [Azure Resource Graph](/azure/governance/resource-graph/overview), which helps power Change Analysis (classic).