Troubleshoot feature deployment issues
You might receive error messages when you deploy the Azure Automation Update Management feature or the Change Tracking and Inventory feature on your VMs. This article describes the errors that might occur and how to resolve them.
Scenario: Renaming a registered node requires unregister or register again
A node is registered to Azure Automation, and then the operating system computer name is changed. Reports from the node continue to appear with the original name.
Renaming registered nodes doesn't update the node name in Azure Automation.
Unregister the node from Azure Automation State Configuration, and then register it again. Reports published to the service before that time will no longer be available.
Scenario: Re-signing certificates via HTTPS proxy isn't supported
When you connect through a proxy that terminates HTTPS traffic and then re-encrypts the traffic using a new certificate, the service doesn't allow the connection.
Azure Automation doesn't support re-signing certificates used to encrypt traffic.
There's currently no workaround for this issue.
Scenario: Feature deployment fails with the message "The solution cannot be enabled"
You receive one of the following messages when you attempt to enable a feature on a VM:
The solution cannot be enabled due to missing permissions for the virtual machine or deployments
The solution cannot be enabled on this VM because the permission to read the workspace is missing
This error is caused by incorrect or missing permissions on the VM or workspace, or for the user.
Ensure that you have correct feature deployment permissions, and then try to deploy the feature again. If you receive the error message
The solution cannot be enabled on this VM because the permission to read the workspace is missing, see the following troubleshooting information.
Scenario: Feature deployment fails with the message "Failed to configure automation account for diagnostic logging"
You receive the following message when you attempt to enable a feature on a VM:
Failed to configure automation account for diagnostic logging
This error can be caused if the pricing tier doesn't match the subscription's billing model. For more information, see Monitoring usage and estimated costs in Azure Monitor.
Create your Log Analytics workspace manually, and repeat the feature deployment process to select the workspace created.
This error code means that the saved search computer group query used to target the feature isn't formatted correctly.
You might have altered the query, or the system might have altered it.
You can delete the query for the feature and then enable the feature again, which re-creates the query. The query can be found in your workspace under Saved searches. The name of the query is MicrosoftDefaultComputerGroup, and the category of the query is the name of the associated feature. If multiple features are enabled, the MicrosoftDefaultComputerGroup query shows multiple times under Saved searches.
This error code indicates that the deployment failed due to violation of one or more Azure Policy assignments.
An Azure Policy assignment is blocking the operation from completing.
To successfully deploy the feature, you must consider altering the indicated policy definition. Because there are many different types of policy definitions that can be defined, the changes required depend on the policy definition that's violated. For example, if a policy definition is assigned to a resource group that denies permission to change the contents of some contained resources, you might choose one of these fixes:
- Remove the policy assignment altogether.
- Try to enable the feature for a different resource group.
- Retarget the policy assignment to a specific resource, for example, an Automation account.
- Revise the set of resources that the policy definition is configured to deny.
Check the notifications in the upper-right corner of the Azure portal, or go to the resource group that contains your Automation account and select Deployments under Settings to view the failed deployment. To learn more about Azure Policy, see Overview of Azure Policy.
Scenario: Errors trying to unlink a workspace
You receive the following error message when you try to unlink a workspace:
The link cannot be updated or deleted because it is linked to Update Management and/or ChangeTracking Solutions.
This error occurs when you still have features active in your Log Analytics workspace that depend on your Automation account and Log Analytics workspace being linked.
Remove the resources for the following features from your workspace if you're using them:
- Update Management
- Change Tracking and Inventory
- Start/Stop VMs during off-hours
After you remove the feature resources, you can unlink your workspace. It's important to clean up any existing artifacts from these features from your workspace and your Automation account:
- For Update Management, remove Update Deployments (Schedules) from your Automation account.
- For Start/Stop VMs during off-hours, remove any locks on feature components in your Automation account under Settings > Locks. For more information, see Remove the feature.
Log Analytics for Windows extension failures
As part of the ongoing transition from Microsoft Operations Management Suite to Azure Monitor, the Operations Management Suite Agent for Windows or Linux will be referred to as the Log Analytics agent for Windows and Log Analytics agent for Linux.
An installation of the Log Analytics agent for Windows extension can fail for a variety of reasons. The following section describes feature deployment issues that can cause failures during deployment of the Log Analytics agent for Windows extension.
Log Analytics agent for Windows is the name used currently in Azure Automation for the Microsoft Monitoring Agent (MMA).
Scenario: An exception occurred during a WebClient request
The Log Analytics for Windows extension on the VM is unable to communicate with external resources and the deployment fails.
The following are examples of error messages that are returned:
Please verify the VM has a running VM agent, and can establish outbound connections to Azure storage.
'Manifest download error from https://<endpoint>/<endpointId>/Microsoft.EnterpriseCloud.Monitoring_MicrosoftMonitoringAgent_australiaeast_manifest.xml. Error: UnknownError. An exception occurred during a WebClient request.
Some potential causes of this error are:
- A proxy configured in the VM only allows specific ports.
- A firewall setting has blocked access to the required ports and addresses.
Ensure that you have the proper ports and addresses open for communication. For a list of ports and addresses, see Planning your network.
Scenario: Install failed because of transient environment issues
The installation of the Log Analytics for Windows extension failed during deployment because of another installation or action blocking the installation.
The following are examples of error messages that might be returned:
The Microsoft Monitoring Agent failed to install on this machine. Please try to uninstall and reinstall the extension. If the issue persists, please contact support.
'Install failed for plugin (name: Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent, version 1.0.11081.4) with exception Command C:\Packages\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\1.0.11081.4\MMAExtensionInstall.exe of Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent has exited with Exit code: 1618'
'Install failed for plugin (name: Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent, version 1.0.11081.2) with exception Command C:\Packages\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\1.0.11081.2\MMAExtensionInstall.exe of Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent has exited with Exit code: 1601'
Some potential causes of this error are:
- Another installation is in progress.
- The system is triggered to reboot during template deployment.
This error is transient in nature. Retry the deployment to install the extension.
Scenario: Installation timeout
The installation of the Log Analytics for Windows extension didn't complete because of a timeout.
The following is an example of an error message that might be returned:
Install failed for plugin (name: Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent, version 1.0.11081.4) with exception Command C:\Packages\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\1.0.11081.4\MMAExtensionInstall.exe of Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent has exited with Exit code: 15614
This type of error occurs because the VM is under a heavy load during installation.
Try to install the Log Analytics agent for Windows extension when the VM is under a lower load.
If you don't see your problem here or you can't resolve your issue, try one of the following channels for additional support:
- Get answers from Azure experts through Azure Forums.
- Connect with @AzureSupport, the official Microsoft Azure account for improving customer experience. Azure Support connects the Azure community to answers, support, and experts.
- File an Azure support incident. Go to the Azure support site, and select Get Support.