Resolver problemas de extensões da VM em servidores compatíveis com o Azure Arc

Este artigo fornece informações sobre como solucionar e solucionar problemas que podem ocorrer ao tentar implantar ou remover extensões de máquina virtual (VM) do Azure em servidores habilitados para Azure Arc. Para obter informações gerais, consulte Gerenciamento de extensão de máquina virtual com servidores habilitados para Azure Arc.

Resolução de problemas gerais

Os dados sobre o estado das implantações de extensão podem ser recuperados do portal do Azure selecionando a máquina aplicável e, em seguida, selecionando Configurações de Extensões>.

Para solução de problemas gerais, tente as etapas a seguir. Estas etapas se aplicam a todas as extensões de VM.

1. Verifique se o agente da Máquina Conectada do Azure (azcmagent) está conectado e se os serviços dependentes estão em execução/ativos.

   Execute o comando azcmagent show e verifique o status na saída (o Azure Arc Proxy pode ser ignorado).

   Captura de tela da tabela que mostra o estado dos serviços dependentes como em execução ou parado.

   Se quaisquer serviços diferentes do Azure Arc Proxy forem interrompidos, reinicie-os para retomar as operações de extensão.

2. Tente instalar novamente a extensão.

   As extensões podem ficar bloqueadas em Failed ou em outros estados por vários motivos. Se o status de uma extensão não estiver listado como Bem-sucedido, remova a extensão e instale-a novamente. O seguinte comando do Azure PowerShell pode ser usado para remover uma extensão:

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

3. Verifique o registo do agente convidado e revise a atividade desde que a sua extensão foi provisionada. Para Windows, verifique em %SystemDrive%\ProgramData\GuestConfig\ext_mgr_logs, e para Linux verifique em /var/lib/GuestConfig/ext_mgr_logs.

4. Verifique os registos da extensão específica para obter mais detalhes.

   Para computadores Windows

   • Os logs são armazenados em C:\ProgramData\GuestConfig
   • As configurações de extensão e os arquivos de status estão localizados em C:\Packages\Plugins

   Para máquinas Linux:

   • Os logs são armazenados em /var/lib/GuestConfig
   • As configurações de extensão e os arquivos de status estão localizados em C:\Packages\Plugins

   Os logs do serviço de extensão são gravados no …GuestConfig\ext_mgr_logs\gc_ext.log. Erros relacionados ao download ou verificação dos pacotes são mostrados lá.

5. Verifique as seções de solução de problemas da documentação específica da extensão para obter códigos de erro, problemas conhecidos ou outros detalhes. Você pode encontrar documentação para muitas extensões na tabela de extensões.

6. Revise os logs do sistema. Verifique se há outras operações que possam interferir na extensão, como uma instalação de longa duração de outro aplicativo que exija acesso exclusivo ao gerenciador de pacotes.

Problemas conhecidos

O arquivo HandlerManifest.json não existe para a extensão

A extensão está presa num Deleting estado. No log de serviço de extensão (gc_ext.log), você verá o seguinte erro:

HandlerManifest.json file does not exist for extension

Análise

Falta o ficheiro HandlerManifest.json à extensão. Isso pode acontecer se a extensão não foi desinstalada corretamente.

Solution

1. Para remover a extensão, use az connectedmachine extension delete com os parâmetros --extension-name, --machine-name e --resource-group.

2. Se a extensão ainda estiver no mesmo estado, tente remover manualmente a extensão da máquina. Algumas extensões podem exigir etapas de limpeza adicionais. Consulte a documentação específica da extensão na tabela de extensões para obter mais orientações.

   Para computadores Windows

   • Navegue até C:\Packages\Plugins\
   • Exclua a pasta correspondente à extensão

   Para máquinas Linux:

   • Navegue até /var/lib/waagent/
   • Exclua a pasta correspondente à extensão

3. Desinstale a extensão do Azure e reinstale-a.

Próximos passos

Se não vir o problema aqui ou não conseguir resolvê-lo, experimente um dos seguintes canais de suporte:

• Obtenha respostas de especialistas do Azure através do Microsoft Q&A.
• Abra um pedido de suporte para obter assistência. Para obter mais informações, veja Criar um pedido de suporte do Azure.