Solucionar problemas de extensão de VM dos servidores habilitados para Azure Arc

Este artigo fornece informações sobre como solucionar problemas e resolver questões que podem ocorrer durante a tentativa de implantar ou remover extensões de VM do Azure em servidores habilitados para Azure Arc. Para obter informações gerais, consulte Gerenciar e usar extensões de VM do Azure.

Solução de problemas gerais

Dados sobre o estado das implantações de extensão podem ser recuperados do portal do Azure.

As seguintes etapas de solução de problemas aplicam-se a todas as extensões da VM.

  1. Para verificar o log do agente Convidado, examine a atividade quando sua extensão estava sendo provisionada no %SystemDrive%\ProgramData\GuestConfig\ext_mgr_logs para Windows e para Linux em /var/lib/GuestConfig/ext_mgr_logs.

  2. Verifique os logs de extensão da extensão específica para obter mais detalhes no %SystemDrive%\ProgramData\GuestConfig\extension_logs\<Extension> para Windows. A saída da extensão é registrada em um arquivo para cada extensão instalada no Linux em /var/lib/GuestConfig/extension_logs.

  3. Verifique as seções de solução de problemas de documentação específicas da extensão para conferir códigos de erro, problemas conhecidos etc. Informações adicionais de solução de problemas para cada extensão podem ser encontradas na seção Solução de problemas e suporte na visão geral da extensão. Isso inclui a descrição dos códigos de erro gravados no log. Os artigos de extensão são vinculados na tabela de extensões.

  4. Examine os logs do sistema. Verifique se há outras operações que podem ter interferido na extensão, como uma instalação de longa execução de outro aplicativo que exigia acesso exclusivo ao gerenciador de pacotes.

Solucionando problemas de cenários de extensão específicos

Insights da VM

  • Ao habilitar Insights da VM para um servidor habilitado para Azure Arc, ele instala a dependência e o agente de Análise de Logs. Em um computador lento ou com uma conexão de rede lenta, é possível ver os tempos limite durante o processo de instalação. A Microsoft está tomando medidas para resolver isso no Connected Machine Agent para ajudar a melhorar essa condição. Por enquanto, uma nova tentativa da instalação pode funcionar.

Agente do Log Analytics para Linux

  • A versão do agente de análise de logs 1.13.9 (a versão da extensão correspondente é 1.13.15) não está marcando corretamente os dados carregados com a ID de recurso do servidor habilitado para Azure Arc. Embora os logs estejam sendo enviados para o serviço, quando você tenta exibir os dados do servidor habilitado selecionado depois de selecionar Logs ou Insights, nenhum dado é retornado. Você pode exibir seus dados executando consultas de logs do Azure Monitor ou do Azure Monitor para VMs, que têm como escopo o espaço de trabalho.

  • No momento, não há suporte para algumas distribuições no agente de Análise de Logs para Linux. O agente requer dependências adicionais a serem instaladas, incluindo o Python 2. Examine a matriz de suporte e os pré-requisitos aqui.

  • O código de erro 52 na mensagem de status indica uma dependência ausente. Verifique a saída e os logs para obter mais informações sobre qual dependência está faltando.

  • Se uma instalação falhar, examine a seção Solução de problemas e suporte na visão geral da extensão. Na maioria dos casos, há um código de erro incluído na mensagem de status. Para o agente de Análise de Logs para Linux, as mensagens de status são explicadas aqui, juntamente com informações gerais de solução de problemas para essa extensão de VM.

Próximas etapas

Se você não encontrar seu problema aqui ou não conseguir resolvê-lo, visite um dos seguintes canais para obter mais suporte:

  • Obtenha respostas de especialistas do Azure no Microsoft Q&A.

  • Conecte-se ao @AzureSupport, a conta oficial do Microsoft Azure para melhorar a experiência do cliente. O Suporte do Azure conecta a Comunidade do Azure a respostas, suporte e especialistas.

  • Registrar um incidente de suporte do Azure. Acesse o site de suporte do Azure e selecione Obter suporte.