Skip to content

Commit 2430dad

Browse files
committed
Merge branch 'master' of https://github.com/MicrosoftDocs/azure-docs-pr into work01
2 parents 1799f73 + 1cfe393 commit 2430dad

File tree

15 files changed

+74
-44
lines changed

15 files changed

+74
-44
lines changed
-1.79 KB
Loading

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

Lines changed: 36 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Use Application Change Analysis in Azure Monitor to troubleshoot ap
44
ms.topic: conceptual
55
author: cawams
66
ms.author: cawa
7-
ms.date: 05/07/2019
7+
ms.date: 05/04/2020
88

99
---
1010

@@ -25,19 +25,21 @@ The following diagram illustrates the architecture of Change Analysis:
2525

2626
![Architecture diagram of how Change Analysis gets change data and provides it to client tools](./media/change-analysis/overview.png)
2727

28-
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.
29-
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.
28+
## Data sources
29+
30+
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.
3031

3132
### Azure Resource Manager tracked properties changes
3233

3334
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.
3435

3536
### Azure Resource Manager proxied setting changes
36-
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.
37+
38+
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.
3739

3840
### Changes in web app deployment and configuration (in-guest changes)
3941

40-
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**.
42+
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**.
4143

4244
![Screenshot of the "Scan changes now" button](./media/change-analysis/scan-changes.png)
4345

@@ -49,70 +51,71 @@ Currently the following dependencies are supported:
4951
- Azure Storage
5052
- Azure SQL
5153

52-
### Enablement
53-
"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.
54-
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.
54+
## Application Change Analysis service
55+
56+
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.
57+
"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.
58+
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.
5559

60+
## Visualizations for Application Change Analysis
5661

57-
## Viewing changes for all resources in Azure
58-
In Azure Monitor, there is a standalone blade for Change Analysis to view all changes with insights and application dependencies resources.
62+
### Standalone UI
5963

60-
Search for Change Analysis in the search bar on Azure portal to launch the blade.
64+
In Azure Monitor, there is a standalone pane for Change Analysis to view all changes with insights into application dependencies and resources.
65+
66+
Search for Change Analysis in the search bar on Azure portal to launch the experience.
6167

6268
![Screenshot of searching Change Analysis in Azure portal](./media/change-analysis/search-change-analysis.png)
6369

64-
Select Resource Group and resources to start viewing changes.
70+
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.
6571

6672
![Screenshot of Change Analysis blade in Azure portal](./media/change-analysis/change-analysis-standalone-blade.png)
6773

68-
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.
74+
Clicking into a resource to view all its changes. If needed, drill down into a change to view json formatted change details and insights.
6975

70-
Currently supported resources include:
71-
- Virtual Machines
72-
- Virtual Machine Scale Set
73-
- Azure Networking resources
74-
- Web app with in-guest file tracking and environment variables changes
76+
![Screenshot of change details](./media/change-analysis/change-details.png)
7577

7678
For any feedback, use the send feedback button in the blade or email [email protected].
7779

7880
![Screenshot of feedback button in Change Analysis blade](./media/change-analysis/change-analysis-feedback.png)
7981

80-
## Change Analysis for the Web Apps feature
82+
### Web App Diagnose and Solve Problems
8183

8284
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.
8385

8486
![Screenshot of the "Overview" button and the "Diagnose and solve problems" button](./media/change-analysis/change-analysis.png)
8587

86-
### Enable Change Analysis in the Diagnose and solve problems tool
88+
### Application Change Analysis in the Diagnose and solve problems tool
89+
90+
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.
8791

8892
1. Select **Availability and Performance**.
8993

9094
![Screenshot of the "Availability and Performance" troubleshooting options](./media/change-analysis/availability-and-performance.png)
9195

92-
1. Select **Application Changes**. Not that the feature is also available in **Application Crashes**.
96+
2. Select **Application Changes**. The feature is also available in **Application Crashes**.
9397

9498
![Screenshot of the "Application Crashes" button](./media/change-analysis/application-changes.png)
9599

96-
1. To enable Change Analysis, select **Enable now**.
100+
3. To enable Change Analysis, select **Enable now**.
97101

98102
![Screenshot of "Application Crashes" options](./media/change-analysis/enable-changeanalysis.png)
99103

100-
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.
104+
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.
101105

102106
![Screenshot of the "Enable Change Analysis" user interface](./media/change-analysis/change-analysis-on.png)
103107

104-
105-
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.
108+
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.
106109

107110
![Screenshot of the change diff view](./media/change-analysis/change-view.png)
108111

109-
110112
### Enable Change Analysis at scale
111113

112114
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.
113115

114116
Pre-requisites:
115-
* 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)
117+
118+
- 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)
116119

117120
Run the following script:
118121

@@ -129,7 +132,6 @@ Set-AzContext -SubscriptionId $SubscriptionId
129132
# Register resource provider
130133
Register-AzResourceProvider -ProviderNamespace "Microsoft.ChangeAnalysis"
131134
132-
133135
# Enable each web app
134136
$webapp_list = Get-AzWebApp | Where-Object {$_.kind -eq 'app'}
135137
foreach ($webapp in $webapp_list)
@@ -141,7 +143,13 @@ foreach ($webapp in $webapp_list)
141143
142144
```
143145

146+
### Virtual Machine Diagnose and Solve Problems
147+
148+
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.
149+
150+
![Screenshot of the VM Diagnose and Solve Problems](./media/change-analysis/vm-dnsp-troubleshootingtools.png)
144151

152+
![Screenshot of the VM Diagnose and Solve Problems](./media/change-analysis/analyze-recent-changes.png)
145153

146154
## Next steps
147155

7.64 KB
Loading
-7.5 KB
Loading
-434 KB
Loading
119 KB
Loading
-53 KB
Loading
20.8 KB
Loading
49.2 KB
Loading
31 KB
Loading

0 commit comments

Comments
 (0)