Merge pull request #184757 from hhunter-ms/hannah-changeanalysis-freshness

[change analysis] freshness pass

Author: jborsecnik

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

@@ -4,90 +4,126 @@ description: Learn how to use visualizations in Application Change Analysis in A
 ms.topic: conceptual
 author: cawams
 ms.author: cawa
-ms.date: 02/11/2021
+ms.date: 01/11/2022
 
 ---
 
 # Visualizations for Application Change Analysis (preview)
 
 ## Standalone UI
 
-In Azure Monitor, there is a standalone pane for Change Analysis to view all changes with insights into application dependencies and resources.
+Change Analysis lives in a standalone pane under Azure Monitor, where you can view all changes and application dependency/resource insights.
 
-Search for Change Analysis in the search bar on Azure portal to launch the experience.
+In the Azure portal, search for Change Analysis to launch the experience.
 
-![Screenshot of searching Change Analysis in Azure portal](./media/change-analysis/search-change-analysis.png)
+:::image type="content" source="./media/change-analysis/search-change-analysis.png" alt-text="Screenshot of searching Change Analysis in Azure portal":::
 
-All resources under a selected subscription are displayed with changes from the past 24 hours. All changes are displayed with old value and new value to provide insights at one glance.
+Select one or more subscriptions to view:
+- All of its resources' changes from the past 24 hours. 
+- Old and new values to provide insights at one glance.
 
-![Screenshot of Change Analysis blade in Azure portal](./media/change-analysis/change-analysis-standalone-blade.png)
+:::image type="content" source="./media/change-analysis/change-analysis-standalone-blade.png" alt-text="Screenshot of Change Analysis blade in Azure portal":::
 
-Clicking into a change to view full Resource Manager snippet and other properties.
+Click into a change to view full Resource Manager snippet and other properties.
 
-![Screenshot of change details](./media/change-analysis/change-details.png)
+:::image type="content" source="./media/change-analysis/change-details.png" alt-text="Screenshot of change details":::
 
-For any feedback, use the send feedback button or email [email protected].
+Send any feedback to the [Change Analysis team](mailto:[email protected]) from the Change Analysis blade:
 
-![Screenshot of feedback button in Change Analysis tab](./media/change-analysis/change-analysis-feedback.png)
+:::image type="content" source="./media/change-analysis/change-analysis-feedback.png" alt-text="Screenshot of feedback button in Change Analysis tab":::
 
 ### Multiple subscription support
 
 The UI supports selecting multiple subscriptions to view resource changes. Use the subscription filter:
 
-![Screenshot of subscription filter that supports selecting multiple subscriptions](./media/change-analysis/multiple-subscriptions-support.png)
-
+:::image type="content" source="./media/change-analysis/multiple-subscriptions-support.png" alt-text="Screenshot of subscription filter that supports selecting multiple subscriptions":::
 
 ## 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.
+Application Change Analysis is:
+- A standalone detector in the Web App **Diagnose and solve problems** tool. 
+- Aggregated in **Application Crashes** and **Web App Down detectors**. 
+
+From your app service's overview page in Azure portal, select **Diagnose and solve problems** the left menu. As you enter the Diagnose and Solve Problems tool, the **Microsoft.ChangeAnalysis** resource provider will automatically be registered. Enable web app in-guest change tracking with the following instructions:
 
 1. Select **Availability and Performance**.
 
-    ![Screenshot of the "Availability and Performance" troubleshooting options](./media/change-analysis/availability-and-performance.png)
+   :::image type="content" source="./media/change-analysis/availability-and-performance.png" alt-text="Screenshot of the Availability and Performance troubleshooting options":::
+    
+2. Select **Application Changes (Preview)**. The feature is also available in **Application Crashes**.
 
-2. Select **Application Changes**. The feature is also available in **Application Crashes**.
+   :::image type="content" source="./media/change-analysis/application-changes.png" alt-text="Screenshot of the Application Crashes button":::
 
-   ![Screenshot of the "Application Crashes" button](./media/change-analysis/application-changes.png)
+   The link leads to Application Change Analysis UI scoped to the web app. 
 
-3. The link leads to Application Change Analysis UI scoped to the web app. If web app in-guest change tracking is not enabled, follow the banner to get file and app settings changes.
+3. Enable web app in-guest change tracking if you haven't already.
 
-   ![Screenshot of "Application Crashes" options](./media/change-analysis/enable-changeanalysis.png)
+   :::image type="content" source="./media/change-analysis/enable-changeanalysis.png" alt-text="Screenshot of the Application Crashes options":::   
 
-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.
+4. Toggle on **Change Analysis** status and select **Save**.
 
-    ![Screenshot of the "Enable Change Analysis" user interface](./media/change-analysis/change-analysis-on.png)
+   :::image type="content" source="./media/change-analysis/change-analysis-on.png" alt-text="Screenshot of the Enable Change Analysis user interface":::   
+  
+    - The tool displays all web apps under an App Service plan, which you can toggle on and off individually. 
 
-5. Change data is also available in select **Web App Down** and **Application Crashes** detectors. 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.
+      :::image type="content" source="./media/change-analysis/change-analysis-on-2.png" alt-text="Screenshot of the Enable Change Analysis user interface expanded":::   
 
-     ![Screenshot of the change diff view](./media/change-analysis/change-view.png)
 
-## Diagnose and Solve Problems tool
-Change Analysis is available as an insight card in Diagnose and Solve Problem tool. If a resource experiences issues and there are changes discovered in the past 72 hours, the insights card will display the number of changes. Clicking on view change details link will lead to the filtered view from Change Analysis standalone UI.
+You can also view change data via the **Web App Down** and **Application Crashes** detectors. The graph summarizes:
+- The change types over time.
+- Details on those changes. 
+
+By default, the graph displays changes from within the past 24 hours help with immediate problems.
+
+:::image type="content" source="./media/change-analysis/change-view.png" alt-text="Screenshot of the change diff view":::   
 
-![Screenshot of viewing change insight in Diagnose and Solve Problems tool.](./media/change-analysis/change-insight-diagnose-and-solve.png)
+## Diagnose and Solve Problems tool
+Change Analysis displays as an insight card in a virtual machine's **Diagnose and solve problems** tool. The insight card displays the number of changes or issues a resource experiences within the past 72 hours. 
 
+Under **Common problems**, select **View change details** to view the filtered view from Change Analysis standalone UI.
 
+:::image type="content" source="./media/change-analysis/change-insight-diagnose-and-solve.png" alt-text="Screenshot of viewing change insight in Diagnose and Solve Problems tool.":::   
 
 ## 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.
+1. Within your virtual machine, select **Diagnose and solve problems** from the left menu. 
+1. Go to **Troubleshooting tools**.
+1. Scroll to the end of the troubleshooting options and select **Analyze recent changes** to view changes on the virtual machine.
+
+:::image type="content" source="./media/change-analysis/vm-dnsp-troubleshootingtools.png" alt-text="Screenshot of the VM Diagnose and Solve Problems":::   
 
-![Screenshot of the VM Diagnose and Solve Problems](./media/change-analysis/vm-dnsp-troubleshootingtools.png)
+:::image type="content" source="./media/change-analysis/analyze-recent-changes.png" alt-text="Change analyzer in troubleshooting tools":::   
 
-![Change analyzer in troubleshooting tools](./media/change-analysis/analyze-recent-changes.png)
+## Activity Log change history
 
-## Activity Log Change History
+Use the [View change history](../essentials/activity-log.md#view-change-history) feature to call the Application Change Analysis service backend to view changes associated with an operation. Changes returned include:
+- Resource level changes from [Azure Resource Graph](../../governance/resource-graph/overview.md).
+- Resource properties from [Azure Resource Manager](../../azure-resource-manager/management/overview.md).
+- In-guest changes from PaaS services, such as App Services web app.
 
-The [View change history](../essentials/activity-log.md#view-change-history) feature in Activity Log calls Application Change Analysis service backend to get changes associated with an operation. **Change history** used to call [Azure Resource Graph](../../governance/resource-graph/overview.md) directly, but swapped the backend to call Application Change Analysis so changes returned will include resource level changes from [Azure Resource Graph](../../governance/resource-graph/overview.md), resource properties from [Azure Resource Manager](../../azure-resource-manager/management/overview.md), and in-guest changes from PaaS services such as App Services web app. 
-In order for the Application Change Analysis service to be able to scan for changes in users' subscriptions, a resource provider needs to be registered. The first time entering **Change History** tab, the tool will automatically start to register **Microsoft.ChangeAnalysis** resource provider. After registered, changes from **Azure Resource Graph** will be available immediately and cover the past 14 days. Changes from other sources will be available after ~4 hours after subscription is onboard.
+1. From within your resource, select **Activity Log** from the side menu.
+1. Select a change from the list.
+1. Select the **Change history (Preview)** tab. 
+1. For the Application Change Analysis service to scan for changes in users' subscriptions, a resource provider needs to be registered. Upon selecting the **Change history (Preview)** tab, the tool will automatically register **Microsoft.ChangeAnalysis** resource provider.
+1. Once registered, you can view changes from **Azure Resource Graph** immediately from the past 14 days.
+   - Changes from other sources will be available after ~4 hours after subscription is onboard.
 
-![Activity Log change history integration](./media/change-analysis/activity-log-change-history.png)
+:::image type="content" source="./media/change-analysis/activity-log-change-history.png" alt-text="Activity Log change history integration":::   
 
 ## VM Insights integration
 
-Users having [VM Insights](../vm/vminsights-overview.md) enabled can view what changed in their virtual machines that might of caused any spikes in a metrics chart such as CPU or Memory. Change data is integrated in the VM Insights side navigation bar. User can view if any changes happened in the VM and select **Investigate Changes** to view change details in Application Change Analysis standalone UI.
+If you've enabled [VM Insights](../vm/vminsights-overview.md), you can view changes in your virtual machines that may have caused any spikes in a metric chart, such as CPU or Memory.
+
+1. Within your virtual machine, select **Insights** from under **Monitoring** in the left menu.
+1. Select the **Performance** tab.
+1. Expand the property panel.
+
+    :::image type="content" source="./media/change-analysis/vm-insights.png" alt-text="Virtual machine insights performance and property panel.":::   
+
+1. Select the **Changes** tab.
+1. Select the **Investigate Changes** button to view change details in the Application Change Analysis standalone UI.
 
-[![VM insights integration](./media/change-analysis/vm-insights.png)](./media/change-analysis/vm-insights.png#lightbox)
+    :::image type="content" source="./media/change-analysis/vm-insights-2.png" alt-text="View of the property panel, selecting Investigate Changes button.":::   
 
 ## Next steps