Merge pull request #206300 from hhunter-ms/hh-1972985

[Change Analysis] Clarify multiple ways to view data

Author: PRMerger19

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

@@ -5,7 +5,7 @@ ms.topic: conceptual
 ms.author: hannahhunter
 author: hhunter-ms
 ms.contributor: cawa
-ms.date: 07/11/2022 
+ms.date: 07/29/2022 
 ms.subservice: change-analysis
 ms.custom: devx-track-azurepowershell
 ---
@@ -18,7 +18,7 @@ The Change Analysis service:
     - 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 tracked properties and proxied settings change data available. The `Microsoft.ChangeAnalysis` resource is automatically registered as you either: 
+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 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.
 

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

@@ -5,17 +5,19 @@ ms.topic: conceptual
 ms.author: hannahhunter
 author: hhunter-ms
 ms.contributor: cawa
-ms.date: 07/11/2022
+ms.date: 07/28/2022
 ms.subservice: change-analysis
 ms.custom: devx-track-azurepowershell
 ms.reviewer: cawa
 ---
 
 # Visualizations for Change Analysis in Azure Monitor (preview)
 
-## Standalone UI
+Change Analysis provides data for various management and troubleshooting scenarios to help you understand what changes to your application might have caused the issues. You can view the Change Analysis data through several channels: 
 
-Change Analysis lives in a standalone pane under Azure Monitor, where you can view all changes and application dependency/resource insights. You can access Change Analysis through a couple of entry points:
+## The Change Analysis standalone UI
+
+You can access Change Analysis in a standalone pane under Azure Monitor, where you can view all changes and application dependency/resource insights. You can access Change Analysis through a couple of entry points:
 
 In the Azure portal, search for Change Analysis to launch the experience.
 
@@ -35,7 +37,6 @@ Send any feedback to the [Change Analysis team](mailto:changeanalysisteam@micros
 
 :::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:
@@ -44,7 +45,7 @@ The UI supports selecting multiple subscriptions to view resource changes. Use t
 
 ## Diagnose and solve problems tool
 
-From your resource'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. 
+From your resource's overview page in Azure portal, you can view change data by selecting **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. 
 
 ### Diagnose and solve problems tool for Web App
 
@@ -84,6 +85,7 @@ You can view Change Analysis data for [multiple Azure resources](./change-analys
 ## Activity Log change history
 
 Use the [View change history](../essentials/activity-log.md#view-change-history) feature to call the Azure Monitor 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.
@@ -128,4 +130,4 @@ You can also drill to Change Analysis logs via a chart you've created or pinned
 
 ## Next steps
 
-- Learn how to [troubleshoot problems in Change Analysis](change-analysis-troubleshoot.md)
+- Learn how to [troubleshoot problems in Change Analysis](change-analysis-troubleshoot.md)

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

@@ -5,7 +5,7 @@ ms.topic: conceptual
 ms.author: hannahhunter
 author: hhunter-ms
 ms.contributor: cawa
-ms.date: 06/29/2022 
+ms.date: 07/29/2022 
 ms.subservice: change-analysis
 ms.custom: devx-track-azurepowershell
 
@@ -65,20 +65,20 @@ Azure Monitor Change Analysis service supports resource property level changes i
 ## Data sources
 
 Azure Monitor's Change Analysis queries for:
-- Azure Resource Manager tracked properties.
-- Proxied configurations.
+- Azure Resource Manager resource properties.
+- Configuration changes.
 - Web app in-guest changes. 
 
 Change Analysis also tracks resource dependency changes to diagnose and monitor an application end-to-end.
 
-### Azure Resource Manager tracked properties changes
+### Azure Resource Manager resource properties changes
 
 Using [Azure Resource Graph](../../governance/resource-graph/overview.md), Change Analysis provides a historical record of how the Azure resources that host your application have changed over time. The following tracked settings can be detected:
 - Managed identities
 - Platform OS upgrade
 - Hostnames
 
-### Azure Resource Manager proxied setting changes
+### Azure Resource Manager configuration changes
 
 Unlike Azure Resource Graph, Change Analysis securely queries and computes IP Configuration rules, TLS settings, and extension versions to provide more change details in the app.
 

articles/azure-monitor/data-platform.md

@@ -5,7 +5,7 @@ author: bwren
 ms.topic: conceptual
 ms.tgt_pltfrm: na
 ms.workload: infrastructure-services
-ms.date: 07/19/2022
+ms.date: 07/28/2022
 ms.reviewer: bwren
 ---
 
@@ -61,7 +61,10 @@ Read more about distributed tracing at [What is distributed tracing?](app/distri
 
 [Changes](./change/change-analysis-visualizations.md) are a series of events that occur in your Azure application, from the infrastructure layer through application deployment. Changes are traced on a subscription-level using [the Change Analysis tool](./change/change-analysis.md). The Change Analysis tool increases observability by building on the power of [Azure Resource Graph](../governance/resource-graph/overview.md) to provide detailed insights into your application changes. 
 
-Once [Change Analysis is enabled](./change/change-analysis-enable.md), the `Microsoft.ChangeAnalysis` resource provider is registered with an Azure Resource Manager subscription to make the tracked properties and proxied settings change data available. Change Analysis' [integrations with Monitoring and Diagnostics tools](./change/change-analysis-visualizations.md) provide data for various management and troubleshooting scenarios to help users understand what changes might have caused the issues.
+Once [Change Analysis is enabled](./change/change-analysis-enable.md), the `Microsoft.ChangeAnalysis` resource provider is registered with an Azure Resource Manager subscription to make the resource properties and configuration change data available. Change Analysis provides data for various management and troubleshooting scenarios to help users understand what changes might have caused the issues:
+- Troubleshoot your application via the [Diagnose & solve problems tool](./change/change-analysis-enable.md).
+- Perform general management and monitoring via the [Change Analysis standalone UI](./change/change-analysis-visualizations.md#the-change-analysis-standalone-ui) and [the activity log](./change/change-analysis-visualizations.md#activity-log-change-history).
+- [Learn more about how to view data results for other scenarios](./change/change-analysis-visualizations.md).
 
 Read more about Change Analysis, including data sources in [Use Change Analysis in Azure Monitor](./change/change-analysis.md).
 

articles/azure-monitor/overview.md

@@ -48,7 +48,7 @@ Azure Monitor uses a version of the [Kusto Query Language](/azure/kusto/query/)
 
 ![Diagram that shows logs data flowing into Log Analytics for analysis.](media/overview/logs.png)
 
-Change Analysis alerts you to live site issues, outages, component failures, or other change data. It also provides insights into those application changes, increases observability, and reduces the mean time to repair. You automatically register the `Microsoft.ChangeAnalysis` resource provider with an Azure Resource Manager subscription by going to Change Analysis via the Azure portal. For web app in-guest changes, you can enable Change Analysis by using the [Diagnose and solve problems tool](./change/change-analysis-visualizations.md#diagnose-and-solve-problems-tool).
+Change Analysis alerts you to live site issues, outages, component failures, or other change data. It also provides insights into those application changes, increases observability, and reduces the mean time to repair. You automatically register the `Microsoft.ChangeAnalysis` resource provider with an Azure Resource Manager subscription by going to Change Analysis via the Azure portal. For web app in-guest changes, you can enable Change Analysis by using the [Diagnose and solve problems tool](./change/change-analysis-enable.md#enable-web-app-in-guest-change-collection-via-azure-portal).
 
 Change Analysis builds on [Azure Resource Graph](../governance/resource-graph/overview.md) to provide a historical record of how your Azure resources have changed over time. It detects managed identities, platform operating system upgrades, and hostname changes. Change Analysis securely queries IP configuration rules, TLS settings, and extension versions to provide more detailed change data.