Compartilhar via

Solucionar problemas de Hybrid Runbook Worker baseados em extensão da VM na Automação

  • Artigo

Este artigo fornece informações sobre como solucionar problemas com os Hybrid Runbook Workers baseados em extensão da Automação do Azure. Para solucionar problemas de trabalhos baseados em agente, confira Solucionar problemas de Hybrid Runbook Worker baseados em agente na Automação. Para obter informações gerais, consulte Visão geral do Hybrid Runbook Worker.

Lista de verificações gerais

Para ajudar a solucionar problemas com os Hybrid Runbook Workers baseados em extensão:

  • Verifique se o sistema operacional é compatível e se todos os pré-requisitos foram atendidos. Consulte Pré-requisitos.

  • Verifique se a identidade gerenciada atribuída pelo sistema está habilitada na VM. As VMs do Azure e os computadores do Azure habilitados para Arc devem estar habilitados com uma identidade gerenciada atribuída pelo sistema.

  • Verifique se a extensão está habilitada com as configurações corretas. O arquivo de configuração deve ter AutomationAccountURL correto. Faça a verificação cruzada da URL com a propriedade da conta de automação – AutomationHybridServiceUrl. 

    • Para o Windows, você pode encontrar o arquivo de configurações aqui:

    Dica

    Substitua * no caminho abaixo pela versão instalada, se souber.

    C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\RuntimeSettings
    • Para o Linux: você pode encontrar o arquivo de configurações aqui: 
      /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux/

  • Verifique a mensagem de erro mostrada no status/Status detalhado da extensão do Hybrid Worker. Ele contém mensagens de erro e suas respectivas recomendações para corrigir o problema.

  • Execute a ferramenta de solução de problemas na VM e ela gera um arquivo de saída. Abra o arquivo de saída e verifique os erros identificados pela ferramenta de solução de problemas.

    • Para o Windows, você pode encontrar a solução de problemas aqui:

    Dica

    Substitua * no caminho abaixo pela versão instalada, se souber.

    C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\bin\troubleshooter\TroubleShootWindowsExtension.ps1
    • Para o Linux, você pode encontrar a solução de problemas aqui:

    Dica

    Substitua * no caminho abaixo pela versão instalada, se souber.

    /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/Troubleshooter/LinuxTroubleshooter.py

  • Para computadores Linux, a extensão do Hybrid Worker cria um usuário hweautomation e inicia o Hybrid Worker sob o usuário. Verifique se o usuário hweautomation está configurado com as permissões corretas. Se o runbook estiver tentando acessar qualquer recurso local, verifique se o hweautomation tem as permissões corretas para os recursos locais.

  • Verifique se o processo do Hybrid Worker está em execução.

    • Para o Windows: verifique o serviço Hybrid Worker Service (HybridWorkerService)
    • Para o Linux, verifique o serviço hwd.

  • Coletar logs:

    • Para o Windows, execute a ferramenta coletor de logs localizada aqui:

    Dica

    Substitua * no caminho abaixo pela versão instalada, se souber.

    C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\bin\troubleshooter\PullLogs.ps1

    Os logs estarão aqui:

    C:\HybridWorkerExtensionLogs
    • Para o Linux, os logs estão nas seguintes pastas: 
      /var/log/azure/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux
      e 
      /home/hweautomation

Cenário: os runbooks entram em um estado suspenso em um Hybrid Runbook Worker ao usar uma conta personalizada em um servidor com o UAC (Controle de Conta de Usuário) habilitado

Problema

Os trabalhos falham e entram em um estado suspenso no Hybrid Runbook Worker. Os logs de eventos Microsoft-SMA indicam Win32 Process Exited with code [2148734720] e um erro correspondente no log de aplicativos quando o runbook tenta executar a .NET Runtime version : 4.0.30319.0 indica que o aplicativo não pôde ser iniciado.

Causa

Quando um sistema tem UAC/LUA em vigor, as permissões devem ser concedidas diretamente e não por meio de uma associação de grupo e quando o usuário precisa elevar as permissões, os trabalhos começam a falhar.

Resolução

Para o usuário personalizado no Hybrid Runbook Worker, atualize as permissões nas seguintes pastas:

Pasta Permissões
C:\ProgramData\AzureConnectedMachineAgent\Tokens Ler
C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows Leitura e execução

Cenário: houve falha ao iniciar o trabalho, pois o Hybrid Worker não estava disponível quando o trabalho agendado foi iniciado

Problema

O trabalho falha ao iniciar em um Hybrid Worker e você vê o seguinte erro:

Houve falha ao iniciar, pois o Hybrid Worker não estava disponível quando o trabalho agendado foi iniciado. O Hybrid Worker estava ativo pela última vez em dd/mm/aaaa.

Causa

Esse erro pode ocorrer devido aos seguintes motivos:

  • Os computadores não existem mais.
  • O computador está desligado e inacessível.
  • O computador tem um problema de conectividade de rede.
  • A extensão do Hybrid Runbook Worker foi desinstalada do computador.

Resolução

  • Verifique se o computador existe e se a extensão do Hybrid Runbook Worker está instalada nele. O Hybrid Worker deve estar íntegro e emitir uma pulsação. Solucione problemas de rede verificando os logs de evento Microsoft-SMA nas funções de trabalho no Grupo do Hybrid Runbook Worker que tentou executar esse trabalho.
  • Você também pode monitorar a métrica HybridWorkerPing que fornece o número de pings de um Hybrid Worker e pode ajudar a verificar problemas relacionados ao ping.

Cenário: o trabalho foi suspenso porque excedeu o limite de trabalho de um Hybrid Worker

Problema

O trabalho é suspenso com a seguinte mensagem de erro:

O trabalho foi suspenso porque excedeu o limite de trabalho de um Hybrid Worker. Adicione mais Hybrid Workers ao grupo do Hybrid Worker para solucionar esse problema.

Causa

Os trabalhos podem ser suspensos devido a qualquer um dos seguintes motivos:

  • Cada Hybrid Worker ativo no grupo sondará trabalhos a cada 30 segundos para ver se há trabalhos disponíveis. A função de trabalho escolhe trabalhos por ordem de chegada. Dependendo de quando um trabalho foi enviado por push, o Hybrid Worker dentro do grupo do Hybrid Worker que executa ping no serviço da Automação pega o trabalho primeiro. Um único trabalho híbrido pode, em geral, pegar quatro trabalhos por ping (ou seja, a cada 30 segundos). Se a taxa de trabalhos por push for maior que quatro por 30 segundos e nenhuma outra função de trabalho pegar o trabalho, ele poderá ser suspenso.
  • O Hybrid Worker pode não estar sondando conforme o esperado, a cada 30 segundos. Isso pode acontecer se o Trabalho não estiver íntegro ou houver problemas de rede.

Resolução

  • Se o limite de trabalho de um Hybrid Worker exceder quatro trabalhos por 30 segundos, você poderá adicionar mais Hybrid Workers ao grupo do Hybrid Worker para alta disponibilidade e balanceamento de carga. Você também pode agendar trabalhos para que eles não excedam o limite de quatro trabalhos por 30 segundos. O tempo de processamento da fila de trabalhos depende do perfil de hardware do Hybrid worker e a carga. Certifique-se de que o Hybrid Worker está íntegro e emite uma pulsação.
  • Solucione problemas de rede verificando os logs de evento Microsoft-SMA nas funções de trabalho no Grupo do Hybrid Runbook Worker que tentou executar esse trabalho.
  • Você também pode monitorar a métrica HybridWorkerPing que fornece o número de pings de um Hybrid Worker e pode ajudar a verificar problemas relacionados ao ping.

Problema

Você está implantando um Hybrid Runbook Worker baseado em extensão em uma VM e ele falha com o erro: Falha na autenticação para links privados.

Causa

A rede virtual da VM é diferente do ponto de extremidade privado da conta de Automação do Azure ou elas não estão conectadas.

Resolução

Verifique se o ponto de extremidade privado da conta de Automação do Azure está conectado à mesma Rede Virtual, à qual a VM está conectada. Siga as etapas mencionadas em Planejamento com base em sua rede para se conectar a um ponto de extremidade privado. Defina sinalizadores de acesso à rede pública para configurar uma conta de Automação para negar todas as configurações públicas e permitir apenas conexões por meio de pontos de extremidade privados. Para obter mais informações sobre como definir as configurações de DNS para pontos de extremidade privados, consulte Configuração de DNS

Cenário: a implantação do Hybrid Worker falha quando o grupo do Hybrid Worker fornecido não existe

Problema

Você está implantando um Hybrid Runbook Worker baseado em extensão em uma VM e ele falha com o erro: Conta/Grupo especificado não existe.

Causa

O grupo Hybrid Runbook Worker no qual o Hybrid Worker deve ser implantado já está excluído.

Resolução

Crie o grupo Hybrid Runbook Worker e adicione a VM como um Hybrid Worker nesse grupo. Siga as etapas mencionadas em Criar um grupo do Hybrid Runbook Worker usando o portal do Azure.

Cenário: a implantação do Hybrid Worker falha quando a identidade gerenciada atribuída pelo sistema não está habilitada na VM

Problema

Você está implantando um Hybrid Runbook Worker baseado em extensão em uma VM e ele falha com o erro:
Não é possível recuperar o ponto de extremidade de identidade do IMDS para uma VM que não seja do Azure. Verifique se o agente do computador conectado do Azure está instalado e se a identidade atribuída pelo sistema está habilitada.

Causa

Você está implantando o Hybrid Worker baseado em extensão em uma VM não Azure que não tem o agente de computador conectado do Arc instalado nele.

Resolução

Computadores não Azure devem ter o agente do computador conectado do Arc instalado nele, antes de implantá-lo como um Hybrid Runbook Worker baseado em extensão. Para instalar o AzureConnectedMachineAgent, confira conectar computadores híbridos do Azure a partir do portal do Azure para servidores habilitados para Arc ou Gerenciar máquinas virtuais VMware no Azure Arc para habilitar o gerenciamento de convidados para VM do VMware habilitada para o Arc.

Cenário: falha na implantação do Hybrid Worker devido à identidade atribuída pelo sistema não habilitada

Problema

Você está implantando um Hybrid Runbook Worker baseado em extensão em uma VM e ele falha com o erro: Token de autorização inválido.

Causa

A identidade gerenciada atribuída pelo usuário da VM está habilitada, mas a identidade gerenciada atribuída pelo sistema não está habilitada.

Resolução

Siga as etapas listadas abaixo:

  1. Habilite a identidade gerenciada atribuída pelo sistema da VM.
  2. Exclua a extensão do Hybrid Worker instalada na VM.
  3. Reinstalar a extensão do Hybrid Worker na VM.

Cenário: o processo de instalação da extensão do Hybrid Worker na VM do Windows fica travado

Problema

Você instalou a extensão do Hybrid Worker em uma VM do Windows no Portal, mas não recebe uma notificação de que o processo foi concluído com êxito.

Causa

Às vezes, o processo de instalação pode ficar travado.

Resolução

Siga as etapas mencionadas abaixo para instalar novamente a extensão do Hybrid Worker:

  1. Abra o console do PowerShell.

  2. Remova a chave do Registro, se presente: HKLM:\Software\Microsoft\Azure\HybridWorker

    1. Código do PowerShell para remover a chave do Registro e todas as subchaves e valores associados:

      Get-Item HKLM:\Software\Microsoft\Azure\HybridWorker | Remove-Item -Recurse

  3. Remova a chave do Registro, se presente: HKLM:\Software\Microsoft\HybridRunbookWorkerV2

    1. Código do PowerShell para remover a chave do Registro e todas as subchaves e valores associados:

      Get-Item HKLM:\Software\Microsoft\HybridRunbookWorkerV2 | Remove-Item -Recurse

  4. Navegue até a pasta de instalação da extensão Hybrid Worker:

    Dica

    Substitua * no comando abaixo pela versão instalada, se souber.

    cd "C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*"

  5. Instale a extensão Hybrid Worker:

    .\bin\install.ps1

  6. Habilite a extensão Hybrid Worker:

    .\bin\enable.ps1

Cenário: o processo de desinstalação da extensão do Hybrid Worker na VM do Windows fica travado

Problema

Você instalou uma extensão Hybrid Worker em uma VM do Windows no portal, mas não recebe uma notificação de que o processo foi concluído com êxito.

Causa

Às vezes, o processo de desinstalação pode ficar travado.

Resolução

  1. Abra o console do PowerShell.

  2. Navegue até a pasta de instalação da extensão Hybrid Worker:

    Dica

    Substitua * no comando abaixo pela versão instalada, se souber.

    cd "C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*"

  3. Desabilite a extensão Hybrid Worker:

    .\bin\disable.cmd

  4. Desinstale a extensão Hybrid Worker:

    .\bin\uninstall.ps1

  5. Remova a chave do Registro, se presente: HKLM:\Software\Microsoft\Azure\HybridWorker

    1. Código do PowerShell para remover a chave do Registro e todas as subchaves e valores associados:

      Get-Item HKLM:\Software\Microsoft\Azure\HybridWorker | Remove-Item -Recurse

  6. Remova a chave do Registro, se presente: HKLM:\Software\Microsoft\HybridRunbookWorkerV2

    1. Código do PowerShell para remover a chave do Registro e todas as subchaves e valores associados:

      Get-Item HKLM:\Software\Microsoft\HybridRunbookWorkerV2 | Remove-Item -Recurse

Cenário: o processo de instalação da extensão do Hybrid Worker na VM do Linux fica travado

Problema

Você instalou uma extensão Hybrid Worker em uma VM do Linux no portal, mas não recebe uma notificação de que o processo foi concluído com êxito.

Causa

Às vezes, o processo de desinstalação pode ficar travado.

Resolução

  1. Exclua a pasta state:

    rm -r /home/hweautomation/state

  2. Navegue até a pasta de instalação da extensão Hybrid Worker:

    Dica

    Substitua * no comando abaixo pela versão instalada, se souber.

    cd /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/

  3. Exclua o arquivo mrseq:

    rm mrseq

  4. Instale a extensão Hybrid Worker:

    ./extension_shim.sh -c ./HWExtensionHandlers.py -i

  5. Habilite a extensão Hybrid Worker:

    ./extension_shim.sh -c ./HWExtensionHandlers.py -e

Cenário: o processo de desinstalação da extensão do Hybrid Worker na VM do Linux fica travado

Problema

Você desinstalou a extensão Hybrid Worker em uma VM do Linux no portal, mas não recebe uma notificação de que o processo foi concluído com êxito.

Causa

Às vezes, o processo de desinstalação pode ficar travado.

Resolução

Siga as etapas mencionadas abaixo para desinstalar completamente a extensão do Hybrid Worker:

  1. Navegue até a pasta de instalação da extensão Hybrid Worker:

    Dica

    Substitua * no comando abaixo pela versão instalada, se souber.

    cd /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/
  2. Desabilite a extensão Hybrid Worker: 
    ./extension_shim.sh -c ./HWExtensionHandlers.py -d
  3. Desinstale a extensão Hybrid Worker: 
    ./extension_shim.sh -c ./HWExtensionHandlers.py -u

Cenário: a execução do Runbook falha

Problema

A execução do runbook falha e você recebe a seguinte mensagem de erro:

The job action 'Activate' cannot be run, because the process stopped unexpectedly. The job action was attempted three times.

Seu runbook será suspenso logo depois de tentar executar três vezes. Existem condições que podem interromper a conclusão do runbook. A mensagem de erro relacionada pode não incluir nenhuma informação adicional.

Causa

Estas são as possíveis causas:

  • Os runbooks não podem autenticar com recursos locais.
  • O Hybrid Worker está usando um proxy ou firewall.
  • O computador configurado para executar o Hybrid Runbook Worker não atende aos requisitos mínimos de hardware.

Resolução

Verifique se o computador tem acesso de saída a *.azure-automation.net na porta 443.

Os computadores que executam o Hybrid Runbook Worker devem atender aos requisitos mínimos de hardware antes de o trabalho ser configurado para hospedar esse recurso. Os Runbooks e o processo em segundo plano que eles usam podem fazer com que o sistema se sobrecarregue e cause atrasos ou tempos limite de trabalho de runbook.

Confirme se o computador que executa o recurso de Hybrid Runbook Worker atende aos requisitos mínimos de hardware. Se isso acontecer, monitore o uso de CPU e memória para determinar qualquer correlação entre o desempenho de processos do Hybrid Runbook Worker e o Windows. Qualquer pressão de memória ou CPU pode indicar a necessidade de atualizar os recursos. Você também pode selecionar um recurso de computação diferente que dê suporte aos requisitos mínimos e à escala quando as demandas de carga de trabalho indicarem que um aumento é necessário.

Verifique o log de eventos do Microsoft SMA para ver um evento correspondente com a descrição Win32 Process Exited with code [4294967295]. A causa desse erro é que você ainda não configurou a autenticação em seus runbooks ou especificou as credenciais Executar como para o grupo do Hybrid Runbook Worker. Examine as permissões de runbook em Executando runbooks em um Hybrid Runbook Worker para confirmar que você configurou corretamente a autenticação para seus runbooks.

Cenário: nenhum certificado foi encontrado no repositório de certificados no Hybrid Runbook Worker

Problema

Um runbook em execução em um Hybrid Runbook Worker falha com a seguinte mensagem de erro:

Connect-AzAccount : No certificate was found in the certificate store with thumbprint 0000000000000000000000000000000000000000
At line:3 char:1
+ Connect-AzAccount -ServicePrincipal -Tenant $Conn.TenantID -Appl ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : CloseError: (:) [Connect-AzAccount],ArgumentException
    + FullyQualifiedErrorId : Microsoft.Azure.Commands.Profile.ConnectAzAccountCommand

Causa

Esse erro ocorre quando você tenta usar uma conta Executar como em um runbook que é executado em um Hybrid Runbook Worker, em que o certificado da conta Executar como não está presente. Os Hybrid Runbook Workers não têm o ativo de certificado localmente por padrão. A conta Executar como requer que este ativo funcione corretamente.

Resolução

Se seu Hybrid Runbook Worker for uma VM do Azure, você poderá usar a autenticação de runbook com identidades gerenciadas em vez disso. Esse cenário simplifica a autenticação, permitindo que você se autentique nos recursos do Azure usando a identidade gerenciada da VM do Azure em vez da conta Executar como. Quando o Hybrid Runbook Worker é um computador local, você precisará instalar o certificado da conta Executar como no computador. Para saber como instalar o certificado, consulte as etapas para executar o runbook do PowerShell Export-RunAsCertificateToHybridWorker em Executar runbooks em um Hybrid Runbook Worker.

Cenário: VMs do Microsoft Azure descartadas automaticamente de um grupo do Hybrid Worker

Problema

Você não pode ver o Hybrid Runbook Worker ou as VMs quando o computador de trabalho foi desativado por muito tempo.

Causa

O computador do Hybrid Runbook Worker não tem efetuado ping na Automação do Azure por mais de 30 dias. Como resultado, a Automação limpou o grupo de Hybrid Runbook Worker ou o grupo de trabalho do sistema.

Resolução

Inicie o computador de trabalho e, em seguida, registre-o novamente com a Automação do Azure. Para obter instruções sobre como instalar o ambiente de runbook e conectar-se à Automação do Azure, consulte Implantar um Hybrid Runbook Worker do Windows.

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 nos Fóruns do Azure.
  • 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.