Skip to content

Commit d5922df

Browse files
authored
Merge pull request #195396 from hhunter-ms/hh_changeanalysis_ga
[Change Analysis] updates to overviews and faq
2 parents fc51436 + 1e1daa4 commit d5922df

File tree

5 files changed

+111
-98
lines changed

5 files changed

+111
-98
lines changed

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

Lines changed: 2 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.topic: conceptual
55
ms.author: hannahhunter
66
author: hhunter-ms
77
ms.contributor: cawa
8-
ms.date: 03/21/2022
8+
ms.date: 04/18/2022
99
ms.subservice: change-analysis
1010
ms.custom: devx-track-azurepowershell
1111
---
@@ -49,45 +49,9 @@ Azure Monitor's Change Analysis is:
4949

5050
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.
5151

52-
### Diagnose and solve problems tool for Web App
53-
54-
> [!NOTE]
55-
> You may not immediately see web app in-guest file changes and configuration changes. Restart your web app and you should be able to view changes within 30 minutes. If not, refer to [the troubleshooting guide](./change-analysis-troubleshoot.md#cannot-see-in-guest-changes-for-newly-enabled-web-app).
56-
57-
1. Select **Availability and Performance**.
58-
59-
:::image type="content" source="./media/change-analysis/availability-and-performance.png" alt-text="Screenshot of the Availability and Performance troubleshooting options":::
60-
61-
2. Select **Application Changes (Preview)**. The feature is also available in **Application Crashes**.
62-
63-
:::image type="content" source="./media/change-analysis/application-changes.png" alt-text="Screenshot of the Application Crashes button":::
64-
65-
The link leads to Azure Monitor's Change Analysis UI scoped to the web app.
66-
67-
3. Enable web app in-guest change tracking if you haven't already.
68-
69-
:::image type="content" source="./media/change-analysis/enable-changeanalysis.png" alt-text="Screenshot of the Application Crashes options":::
70-
71-
4. Toggle on **Change Analysis** status and select **Save**.
72-
73-
:::image type="content" source="./media/change-analysis/change-analysis-on.png" alt-text="Screenshot of the Enable Change Analysis user interface":::
74-
75-
- The tool displays all web apps under an App Service plan, which you can toggle on and off individually.
76-
77-
:::image type="content" source="./media/change-analysis/change-analysis-on-2.png" alt-text="Screenshot of the Enable Change Analysis user interface expanded":::
78-
79-
80-
You can also view change data via the **Web App Down** and **Application Crashes** detectors. The graph summarizes:
81-
- The change types over time.
82-
- Details on those changes.
83-
84-
By default, the graph displays changes from within the past 24 hours help with immediate problems.
85-
86-
:::image type="content" source="./media/change-analysis/change-view.png" alt-text="Screenshot of the change diff view":::
87-
8852
### Diagnose and solve problems tool for Virtual Machines
8953

90-
Change Analysis displays as an insight card in a your 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.
54+
Change Analysis displays as an insight card in your 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.
9155

9256
1. Within your virtual machine, select **Diagnose and solve problems** from the left menu.
9357
1. Go to **Troubleshooting tools**.

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

Lines changed: 44 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.topic: conceptual
55
ms.author: hannahhunter
66
author: hhunter-ms
77
ms.contributor: cawa
8-
ms.date: 03/21/2022
8+
ms.date: 04/18/2022
99
ms.subservice: change-analysis
1010
ms.custom: devx-track-azurepowershell
1111
---
@@ -140,32 +140,64 @@ The Change Analysis service:
140140
- Easily navigate through all resource changes.
141141
- Identify relevant changes in the troubleshooting or monitoring context.
142142

143+
### Enable Change Analysis
144+
143145
You'll need to 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:
144146
- Enter the Web App **Diagnose and Solve Problems** tool, or
145147
- Bring up the Change Analysis standalone tab.
146148

147-
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#diagnose-and-solve-problems-tool-for-web-app) section.
149+
### Enable Change Analysis for web app in-guest changes
150+
151+
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#diagnose-and-solve-problems-tool) section.
152+
153+
> [!NOTE]
154+
> You may not immediately see web app in-guest file changes and configuration changes. Restart your web app and you should be able to view changes within 30 minutes. If not, refer to [the troubleshooting guide](./change-analysis-troubleshoot.md#cannot-see-in-guest-changes-for-newly-enabled-web-app).
155+
156+
1. Select **Availability and Performance**.
157+
158+
:::image type="content" source="./media/change-analysis/availability-and-performance.png" alt-text="Screenshot of the Availability and Performance troubleshooting options":::
159+
160+
2. Select **Application Changes (Preview)**.
161+
162+
:::image type="content" source="./media/change-analysis/application-changes.png" alt-text="Screenshot of the Application Changes button":::
163+
164+
The link leads to Azure Monitor's Change Analysis UI scoped to the web app.
165+
166+
3. Enable web app in-guest change tracking by either:
167+
168+
- Selecting **Enable Now** in the banner, or
169+
170+
:::image type="content" source="./media/change-analysis/enable-changeanalysis.png" alt-text="Screenshot of the Application Changes options from the banner":::
171+
172+
- Selecting **Configure** from the top menu.
173+
174+
:::image type="content" source="./media/change-analysis/configure-button.png" alt-text="Screenshot of the Application Changes options from the top menu":::
175+
176+
4. Toggle on **Change Analysis** status and select **Save**.
177+
178+
:::image type="content" source="./media/change-analysis/change-analysis-on.png" alt-text="Screenshot of the Enable Change Analysis user interface":::
179+
180+
- The tool displays all web apps under an App Service plan, which you can toggle on and off individually.
148181

149-
If you don't see changes within 30 minutes, refer to [the troubleshooting guide](./change-analysis-troubleshoot.md#cannot-see-in-guest-changes-for-newly-enabled-web-app).
182+
:::image type="content" source="./media/change-analysis/change-analysis-on-2.png" alt-text="Screenshot of the Enable Change Analysis user interface expanded":::
150183

184+
You can also view change data via the **Web App Down** and **Application Crashes** detectors. The graph summarizes:
185+
- The change types over time.
186+
- Details on those changes.
151187

152-
## Cost
153-
Azure Monitor's Change Analysis is a free service. Once enabled, the Change Analysis **Diagnose and solve problems** tool does not:
154-
- Incur any billing cost to subscriptions.
155-
- Have any performance impact for scanning Azure Resource properties changes.
188+
By default, the graph displays changes from within the past 24 hours help with immediate problems.
156189

157-
## Data retention
158-
Change Analysis provides 14 days of data retention.
190+
:::image type="content" source="./media/change-analysis/change-view.png" alt-text="Screenshot of the change diff view":::
159191

160-
## Enable Change Analysis at scale for Web App in-guest file and environment variable changes
192+
### Enable Change Analysis at scale for Web App in-guest file and environment variable changes
161193

162194
If your subscription includes several web apps, enabling the service at the web app level would be inefficient. Instead, run the following script to enable all web apps in your subscription.
163195

164-
### Pre-requisites
196+
#### Pre-requisites
165197

166198
PowerShell Az Module. Follow instructions at [Install the Azure PowerShell module](/powershell/azure/install-az-ps)
167199

168-
### Run the following script:
200+
#### Run the following script:
169201

170202
```PowerShell
171203
# Log in to your Azure subscription
10.7 KB
Loading

0 commit comments

Comments
 (0)