Merge pull request #113724 from mrbullwinkle/mrb_05_04_2020_change_analysis_updates

change analysis updates

Author: denrea

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

@@ -4,7 +4,7 @@ description: Use Application Change Analysis in Azure Monitor to troubleshoot ap
 ms.topic: conceptual
 author: cawams
 ms.author: cawa
-ms.date: 05/07/2019
+ms.date: 05/04/2020
 
 ---
 
@@ -25,19 +25,21 @@ The following diagram illustrates the architecture of Change Analysis:
 
 ![Architecture diagram of how Change Analysis gets change data and provides it to client tools](./media/change-analysis/overview.png)
 
-Currently Change Analysis is integrated into the **Diagnose and solve problems** experience in the App Service web app, as well as available as a standalone tab in Azure portal.
-See the *Viewing changes for all resources in Azure* section to access Change Analysis blade and the *Change Analysis for the Web Apps feature* section for using it within Web App portal later in this article.
+## Data sources
+
+Application change analysis queries for Azure Resource Manager tracked properties, proxied configurations and web app in-guest changes. In addition, the service tracks resource dependency changes to diagnose and monitor an application end-to-end.
 
 ### Azure Resource Manager tracked properties changes
 
 Using [Azure Resource Graph](https://docs.microsoft.com/azure/governance/resource-graph/overview), Change Analysis provides a historical record of how the Azure resources that host your application have changed over time. Tracked settings such as managed identities, Platform OS upgrade, and hostnames can be detected.
 
 ### Azure Resource Manager proxied setting changes
-Settings such as IP Configuration rule, TLS settings, and extension versions are not yet available in ARG, so Change Analysis queries and computes these changes securely to provide more details in what changed in the app. This information is not available yet in Azure Resource Graph but will be available soon.
+
+Settings such as IP Configuration rule, TLS settings, and extension versions are not yet available in Azure Resource Graph, so Change Analysis queries and computes these changes securely to provide more details in what changed in the app.
 
 ### Changes in web app deployment and configuration (in-guest changes)
 
-Change Analysis captures the deployment and configuration state of an application every 4 hours. It can detect, for example, changes in the application environment variables. The tool computes the differences and presents what has changed. Unlike Resource Manager changes, code deployment change information might not be available immediately in the tool. To view the latest changes in Change Analysis, select **Scan changes now**.
+Change Analysis captures the deployment and configuration state of an application every 4 hours. It can detect, for example, changes in the application environment variables. The tool computes the differences and presents what has changed. Unlike Resource Manager changes, code deployment change information might not be available immediately in the tool. To view the latest changes in Change Analysis, select **Refresh**.
 
 ![Screenshot of the "Scan changes now" button](./media/change-analysis/scan-changes.png)
 
@@ -49,70 +51,71 @@ Currently the following dependencies are supported:
 - Azure Storage
 - Azure SQL
 
-### Enablement
-"Microsoft.ChangeAnalysis" resource provider needs to be registered with a subscription for the Azure Resource Manager tracked properties and proxied settings change data to be available. As you enter the Web App diagnose and solve problems tool or bring up the Change Analysis standalone tab, this resource provider is automatically registered. It does not have any performance and cost implementations for your subscription. When you enable Change Analysis for web apps (or enabling in the Diagnose and Solve problems tool), it will have negligible performance impact on the web app and no billing cost.
-For web app in-guest changes, separate enablement is required for scanning code files within a web app. For more information, see [Enable Change Analysis in the Diagnose and solve problems tool](https://docs.microsoft.com/azure/azure-monitor/app/change-analysis#enable-change-analysis-in-the-diagnose-and-solve-problems-tool) section later in this article for more details.
+## Application Change Analysis service
+
+The Application Change Analysis service computes and aggregates change data from the data sources mentioned above. It provides a set of analytics for users to easily navigate through all resource changes and to identify which change is relevant in the troubleshooting or monitoring context.
+"Microsoft.ChangeAnalysis" resource provider needs to be registered with a subscription for the Azure Resource Manager tracked properties and proxied settings change data to be available. As you enter the Web App diagnose and solve problems tool or bring up the Change Analysis standalone tab, this resource provider is automatically registered. It does not have any performance or cost implementations for your subscription. When you enable Change Analysis for web apps (or enable the Diagnose and Solve problems tool), it will have negligible performance impact on the web app and no billing cost.
+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](https://docs.microsoft.com/azure/azure-monitor/app/change-analysis#application-change-analysis-in-the-diagnose-and-solve-problems-tool) section later in this article for more details.
 
+## Visualizations for Application Change Analysis
 
-## Viewing changes for all resources in Azure
-In Azure Monitor, there is a standalone blade for Change Analysis to view all changes with insights and application dependencies resources.
+### Standalone UI
 
-Search for Change Analysis in the search bar on Azure portal to launch the blade.
+In Azure Monitor, there is a standalone pane for Change Analysis to view all changes with insights into application dependencies and resources.
+
+Search for Change Analysis in the search bar on Azure portal to launch the experience.
 
 ![Screenshot of searching Change Analysis in Azure portal](./media/change-analysis/search-change-analysis.png)
 
-Select Resource Group and resources to start viewing changes.
+All resources under a selected subscription are displayed with changes from the past 24 hours. To optimize for the page load performance the service is displaying 10 resources at a time. Click on next pages to view more resources. We are working on removing this limitation.
 
 ![Screenshot of Change Analysis blade in Azure portal](./media/change-analysis/change-analysis-standalone-blade.png)
 
-You can see Insights and related dependencies resources that host your application. This view is designed to be application-centric for developers to troubleshoot issues.
+Clicking into a resource to view all its changes. If needed, drill down into a change to view json formatted change details and insights.
 
-Currently supported resources include:
-- Virtual Machines
-- Virtual Machine Scale Set
-- Azure Networking resources
-- Web app with in-guest file tracking and environment variables changes
+![Screenshot of change details](./media/change-analysis/change-details.png)
 
 For any feedback, use the send feedback button in the blade or email [email protected].
 
 ![Screenshot of feedback button in Change Analysis blade](./media/change-analysis/change-analysis-feedback.png)
 
-## Change Analysis for the Web Apps feature
+### Web App Diagnose and Solve Problems
 
 In Azure Monitor, Change Analysis is also built into the self-service **Diagnose and solve problems** experience. Access this experience from the **Overview** page of your App Service application.
 
 ![Screenshot of the "Overview" button and the "Diagnose and solve problems" button](./media/change-analysis/change-analysis.png)
 
-### Enable Change Analysis in the Diagnose and solve problems tool
+### Application Change Analysis in the Diagnose and solve problems tool
+
+Application Change Analysis is a standalone detector in the Web App diagnose and solve problems tools. It is also aggregated in **Application Crashes** and **Web App Down detectors**. As you enter the Diagnose and Solve Problems tool, the **Microsoft.ChangeAnalysis** resource provider will automatically be registered. Follow these instructions to enable web app in-guest change tracking.
 
 1. Select **Availability and Performance**.
 
     ![Screenshot of the "Availability and Performance" troubleshooting options](./media/change-analysis/availability-and-performance.png)
 
-1. Select **Application Changes**. Not that the feature is also available in **Application Crashes**.
+2. Select **Application Changes**. The feature is also available in **Application Crashes**.
 
    ![Screenshot of the "Application Crashes" button](./media/change-analysis/application-changes.png)
 
-1. To enable Change Analysis, select **Enable now**.
+3. To enable Change Analysis, select **Enable now**.
 
    ![Screenshot of "Application Crashes" options](./media/change-analysis/enable-changeanalysis.png)
 
-1. Turn on **Change Analysis** and select **Save**. The tool displays all web apps under an App Service plan. You can use the plan level switch to turn on Change Analysis for all web apps under a plan.
+4. Turn on **Change Analysis** and select **Save**. The tool displays all web apps under an App Service plan. You can use the plan level switch to turn on Change Analysis for all web apps under a plan.
 
     ![Screenshot of the "Enable Change Analysis" user interface](./media/change-analysis/change-analysis-on.png)
 
-
-1. To access Change Analysis, select **Diagnose and solve problems** > **Availability and Performance** > **Application Crashes**. You'll see a graph that summarizes the type of changes over time along with details on those changes. By default, changes in the past 24 hours are displayed to help with immediate problems.
+5. To access Change Analysis, select **Diagnose and solve problems** > **Availability and Performance** > **Application Crashes**. You'll see a graph that summarizes the type of changes over time along with details on those changes. By default, changes in the past 24 hours are displayed to help with immediate problems.
 
      ![Screenshot of the change diff view](./media/change-analysis/change-view.png)
 
-
 ### Enable Change Analysis at scale
 
 If your subscription includes numerous web apps, enabling the service at the level of the web app would be inefficient. Run the following script to enable all web apps in your subscription.
 
 Pre-requisites:
-* PowerShell Az Module. Follow instructions at [Install the Azure PowerShell module](https://docs.microsoft.com/powershell/azure/install-az-ps?view=azps-2.6.0)
+
+- PowerShell Az Module. Follow instructions at [Install the Azure PowerShell module](https://docs.microsoft.com/powershell/azure/install-az-ps?view=azps-2.6.0)
 
 Run the following script:
 
@@ -129,7 +132,6 @@ Set-AzContext -SubscriptionId $SubscriptionId
 # Register resource provider
 Register-AzResourceProvider -ProviderNamespace "Microsoft.ChangeAnalysis"
 
-
 # Enable each web app
 $webapp_list = Get-AzWebApp | Where-Object {$_.kind -eq 'app'}
 foreach ($webapp in $webapp_list)
@@ -141,7 +143,13 @@ foreach ($webapp in $webapp_list)
 
 ```
 
+### Virtual Machine Diagnose and Solve Problems
+
+Go to Diagnose and Solve Problems tool for a Virtual Machine.  Go to **Troubleshooting Tools**, browse down the page and select **Analyze recent changes** to view changes on the Virtual Machine.
+
+![Screenshot of the VM Diagnose and Solve Problems](./media/change-analysis/vm-dnsp-troubleshootingtools.png)
 
+![Screenshot of the VM Diagnose and Solve Problems](./media/change-analysis/analyze-recent-changes.png)
 
 ## Next steps