Skip to content

Commit 65fe1ec

Browse files
authored
Merge pull request #183751 from hhunter-ms/hannah-changeanalysis-troubleshootupdate
[change analysis] clarification to troubleshooting guide
2 parents fa49f85 + 061451e commit 65fe1ec

File tree

1 file changed

+52
-29
lines changed

1 file changed

+52
-29
lines changed

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

Lines changed: 52 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -4,65 +4,88 @@ description: Learn how to troubleshoot problems in Application Change Analysis.
44
ms.topic: conceptual
55
author: cawams
66
ms.author: cawa
7-
ms.date: 02/11/2021
7+
ms.date: 01/07/2022
88
ms.custom: devx-track-azurepowershell
99

1010
---
1111

1212
# Troubleshoot Application Change Analysis (preview)
1313

14-
## Having trouble registering Microsoft. Change Analysis resource provider from Change history tab
14+
## Trouble registering Microsoft.ChangeAnalysis resource provider from Change history tab.
1515

16-
If it's the first time you view Change history after its integration with Application Change Analysis, you will see it automatically registering a resource provider **Microsoft.ChangeAnalysis**. In rare cases it might fail for the following reasons:
16+
If you're viewing Change history after its first integration with Application Change Analysis, you will see it automatically registering the **Microsoft.ChangeAnalysis** resource provider. The resource may fail and incur the following error messages:
1717

18-
- **You don't have enough permissions to register Microsoft.ChangeAnalysis resource provider**. This error message means your role in the current subscription does not have the **Microsoft.Support/register/action** scope associated with it. This might happen if you are not the owner of a subscription and got shared access permissions through a coworker (that is, view access to a resource group). To fix this, you can contact the owner of your subscription to register the **Microsoft.ChangeAnalysis** resource provider. This can be done in Azure portal through **Subscriptions | Resource providers** and search for ```Microsoft.ChangeAnalysis``` and register in the UI, or through Azure PowerShell or Azure CLI.
18+
### You don't have enough permissions to register Microsoft.ChangeAnalysis resource provider.
19+
You're receiving this error message because your role in the current subscription is not associated with the **Microsoft.Support/register/action** scope. For example, you are not the owner of your subscription and instead received shared access permissions through a coworker (like view access to a resource group).
1920

20-
Register resource provider through PowerShell:
21+
To resolve the issue, contact the owner of your subscription to register the **Microsoft.ChangeAnalysis** resource provider.
22+
1. In the Azure portal, search for **Subscriptions**.
23+
1. Select your subscription.
24+
1. Navigate to **Resource providers** under **Settings** in the side menu.
25+
1. Search for **Microsoft.ChangeAnalysis** and register via the UI, Azure PowerShell, or Azure CLI.
26+
27+
Example for registering the resource provider through PowerShell:
2128
```PowerShell
2229
# Register resource provider
2330
Register-AzResourceProvider -ProviderNamespace "Microsoft.ChangeAnalysis"
2431
```
2532
26-
- **Failed to register Microsoft.ChangeAnalysis resource provider**. This message means something failed immediately as the UI sent request to register the resource provider, and it's not related to permission issue. Likely it might be a temporary internet connectivity issue. Try refreshing the page and checking your internet connection. If the error persists, contact [email protected]
33+
### Failed to register Microsoft.ChangeAnalysis resource provider.
34+
This error message is likely a temporary internet connectivity issue, since:
35+
* The UI sent the resource provider registration request.
36+
* You've resolved your [permissions issue](#you-dont-have-enough-permissions-to-register-microsoftchangeanalysis-resource-provider).
2737
28-
- **This is taking longer than expected**. This message means the registration is taking longer than 2 minutes. This is unusual but does not necessarily mean something went wrong. You can go to **Subscriptions | Resource provider** to check for **Microsoft.ChangeAnalysis** resource provider registration status. You can try to use the UI to unregister, re-register, or refresh to see if it helps. If issue persists, contact [email protected] for support.
29-
![Troubleshoot RP registration taking too long](./media/change-analysis/troubleshoot-registration-taking-too-long.png)
38+
Try refreshing the page and checking your internet connection. If the error persists, contact the [Change Analysis help team](mailto:[email protected]).
3039
31-
![Screenshot of the Diagnose and Solve Problems tool for a Virtual Machine with Troubleshooting tools selected.](./media/change-analysis/vm-dnsp-troubleshootingtools.png)
40+
### This is taking longer than expected.
41+
You'll receive this error message when the registration takes longer than 2 minutes. While unusual, it doesn't mean something went wrong. Restart your web app to see your registration changes. Changes should show up within a few hours of app restart.
3242
33-
![Screenshot of the tile for the Analyze recent changes troubleshooting tool for a Virtual Machine.](./media/change-analysis/analyze-recent-changes.png)
43+
If your changes still don't show after 6 hours, contact the [Change Analysis help team](mailto:[email protected]).
44+
45+
## Azure Lighthouse subscription is not supported.
46+
47+
### Failed to query Microsoft.ChangeAnalysis resource provider.
48+
Often, this message includes: `Azure Lighthouse subscription is not supported, the changes are only available in the subscription's home tenant`.
3449
35-
## Azure Lighthouse subscription is not supported
50+
Currently, the Change Analysis resource provider is limited to registration through Azure Lighthouse subscription for users outside of home tenant. We are working on addressing this limitation.
3651
37-
- **Failed to query Microsoft.ChangeAnalysis resource provider** with message *Azure lighthouse subscription is not supported, the changes are only available in the subscription's home tenant*. There is a limitation right now for Change Analysis resource provider to be registered through Azure Lighthouse subscription for users not in home tenant. We are working on addressing this limitation. If this is a blocking issue for you, there is a workaround that involves creating a service principal and explicitly assigning the role to allow the access. Contact [email protected] to learn more about it.
52+
If this is a blocking issue for you, we can provide a workaround that involves creating a service principal and explicitly assigning the role to allow the access. Contact the [Change Analysis help team](mailto:[email protected]) to learn more about it.
3853
39-
## An error occurred while getting changes. Please refresh this page or come back later to view changes
54+
## An error occurred while getting changes. Please refresh this page or come back later to view changes.
4055
41-
This is the general error message presented by Application Change Analysis service when changes could not be loaded. A few known causes are:
56+
When changes can't be loaded, Application Change Analysis service presents this general error message. A few known causes are:
4257
43-
- Internet connectivity error from the client device
44-
- Change Analysis service being temporarily unavailable
45-
Refreshing the page after a few minutes usually fixes this issue. If the error persists, contact [email protected]
58+
- Internet connectivity error from the client device.
59+
- Change Analysis service being temporarily unavailable.
4660
47-
## You don't have enough permissions to view some changes. Contact your Azure subscription administrator
61+
Refreshing the page after a few minutes usually fixes this issue. If the error persists, contact the [Change Analysis help team](mailto:[email protected]).
4862
49-
This is the general unauthorized error message, explaining the current user does not have sufficient permissions to view the change. At least reader access is required on the resource to view infrastructure changes returned by Azure Resource Graph and Azure Resource Manager. For web app in-guest file changes and configuration changes, at least contributor role is required.
63+
## You don't have enough permissions to view some changes. Contact your Azure subscription administrator.
5064
51-
## Failed to register Microsoft.ChangeAnalysis resource provider
65+
This general unauthorized error message occurs when the current user does not have sufficient permissions to view the change. At minimum,
66+
* To view infrastructure changes returned by Azure Resource Graph and Azure Resource Manager, reader access is required.
67+
* For web app in-guest file changes and configuration changes, contributor role is required.
5268
53-
This message means something failed immediately as the UI sent request to register the resource provider, and it's not related to permission issue. Likely it might be a temporary internet connectivity issue. Try refreshing the page and checking your internet connection. If the error persists, contact [email protected]
69+
You may not immediately see web app in-guest file changes and configuration changes. While we work on providing the option to restart the app in the Azure portal, the current procedure is:
5470
55-
## You don't have enough permissions to register Microsoft.ChangeAnalysis resource provider. Contact your Azure subscription administrator
71+
1. User adds the hidden tracking tag, notifying the scheduled worker.
72+
2. Scheduled worker scans the web app within a few hours.
73+
3. While scanning, scheduled worker creates a handshake file via AST.
74+
4. The Web App team checks that handshake file when it restarts.
5675
57-
This error message means your role in the current subscription does not have the **Microsoft.Support/register/action** scope associated with it. This might happen if you are not the owner of a subscription and got shared access permissions through a coworker (that is, view access to a resource group). To fix this, you can contact the owner of your subscription to register the **Microsoft.ChangeAnalysis** resource provider. This can be done in Azure portal through **Subscriptions | Resource providers** and search for ```Microsoft.ChangeAnalysis``` and register in the UI, or through Azure PowerShell or Azure CLI.
76+
## Diagnose and solve problems tool for virtual machines
77+
78+
To troubleshoot virtual machine issues using the troubleshooting tool in the Azure portal:
79+
1. Navigate to your virtual machine.
80+
1. Select **Diagnose and solve problems** from the side menu.
81+
1. Browse and select the troubleshooting tool that fits your issue.
82+
83+
![Screenshot of the Diagnose and Solve Problems tool for a Virtual Machine with Troubleshooting tools selected.](./media/change-analysis/vm-dnsp-troubleshootingtools.png)
84+
85+
![Screenshot of the tile for the Analyze recent changes troubleshooting tool for a Virtual Machine.](./media/change-analysis/analyze-recent-changes.png)
5886
59-
Register resource provider through PowerShell:
6087
61-
```PowerShell
62-
# Register resource provider
63-
Register-AzResourceProvider -ProviderNamespace "Microsoft.ChangeAnalysis"
64-
```
6588
6689
## Next steps
6790
68-
- Learn more about [Azure Resource Graph](../../governance/resource-graph/overview.md), which helps power Change Analysis.
91+
Learn more about [Azure Resource Graph](../../governance/resource-graph/overview.md), which helps power Change Analysis.

0 commit comments

Comments
 (0)