Troubleshoot Azure Arc-enabled servers VM extension issues

This article provides information on troubleshooting and resolving issues that may occur while attempting to deploy or remove Azure virtual machine (VM) extensions on Azure Arc-enabled servers. For general information, see Virtual machine extension management with Azure Arc-enabled servers.

Data about the state of extension deployments can be retrieved from the Azure portal by selecting the applicable machine and then selecting Settings > Extensions.

For general troubleshooting, try the following steps. These steps apply to all VM extensions.

1. Ensure that the Azure Connected Machine agent (azcmagent) is connected and that the dependent services are running/active.

   Run the azcmagent show command and check the output for the status (Azure Arc Proxy can be ignored):

   

   If any services other than Azure Arc Proxy are stopped, restart them to resume extension operations.

2. Retry extension installation.

   Extensions can get stuck in Failed or other states for various reasons. If an extension's status isn't listed as Succeeded, remove the extension and install it again. The following Azure PowerShell command can be used to remove an extension:

   Remove-AzConnectedMachineExtension -Name <Extension Name> -ResourceGroupName <RG Name> -MachineName <Machine Name>
   

3. Check the Guest agent log and review activity from when your extension was being provisioned. For Windows, check in %SystemDrive%\ProgramData\GuestConfig\ext_mgr_logs, and for Linux check in /var/lib/GuestConfig/ext_mgr_logs.

4. Check the extension logs for the specific extension for more details.

   For Windows machines:

   • Logs are stored in C:\ProgramData\GuestConfig
   • Extension settings and status files reside in C:\Packages\Plugins

   For Linux machines:

   • Logs are stored in /var/lib/GuestConfig
   • Extension settings and status files reside in /var/lib/waagent

   Extension service logs are written to …GuestConfig\ext_mgr_logs\gc_ext.log. Errors regarding downloading or verifying the packages are shown there.

5. Check extension-specific documentation troubleshooting sections for error codes, known issues, or other details. You can find documentation for many extensions in the extensions table.

6. Review the system logs. Check for other operations that could interfere with the extension, such as a long-running installation of another application that requires exclusive package manager access.

If you don't see your problem here or you can't resolve your issue, try one of the following channels for support:

• Get answers from Azure experts through Microsoft Q&A.
• Open a support request to get assistance. For more information, see Create an Azure support request.