Compartilhar via


Solucionar problemas do agente de atualização do Linux

Pode haver muitas razões pelas quais o computador não está aparecendo como pronto (íntegro) no Gerenciamento de Atualizações. Você pode verificar a integridade de um agente do Hybrid Runbook Worker do Linux para determinar o problema subjacente. A seguir estão os três estados de preparação para um computador:

  • Pronto: O Hybrid Runbook Worker está implantado e foi visualizado pela última vez há menos de uma hora.
  • Desconectado: o Hybrid Runbook Worker está implantado e foi visualizado pela última vez há mais de uma hora.
  • Não configurado: o Hybrid Runbook Worker não foi encontrado ou não concluiu a implantação.

Observação

Pode haver um pequeno atraso entre o que o portal do Azure mostra e o estado atual de um computador.

Este artigo descreve como executar a solução de problemas em computadores do Azure no portal do Azure e em computadores não Azure no cenário offline.

Observação

O script de solução de problemas atualmente não roteia o tráfego por um servidor proxy se houver um configurado.

Iniciar a solução de problemas

Para computadores do Azure, selecione o link Solução de Problemas na coluna Preparação do Agente de Atualização no portal para abrir a página Solucionar Problemas do Agente de Atualização. Para computadores não Azure, o link levará você para este artigo. Para solucionar problemas de um computador não Azure, confira as instruções na seção Solucionar problemas offline.

Screenshot of VM list page.

Observação

As verificações exigem que a VM esteja em execução. Se a VM não estiver em execução, Iniciar a VM será exibido.

Na página Solucionar problemas de atualização de agente, selecione Executar Verificações para iniciar a solução de problemas. A solução de problemas usa Executar comando para executar um script no computador para verificar as dependências. Quando a solução de problemas é concluída, ela retorna o resultado das verificações.

Screenshot of Troubleshoot page.

Quando as verificações forem concluídas, os resultados serão retornados na janela. As seções de verificação fornecem informações sobre o que cada verificação está procurando.

Screenshot of Linux Troubleshooter.

Verificações de pré-requisitos

Sistema operacional

A verificação do sistema operacional verifica se o Hybrid Runbook Worker está executando um dos sistemas operacionais com suporte.

Verificação do dmidecode

Para verificar se é uma VM do Azure, verifique o valor da marca de Ativo usando o comando abaixo:

sudo dmidecode

Se a marca de ativo for diferente de 7783-7084-3265-9085-8269-3286-77, reinicie a VM para iniciar o novo registro.

Monitoramento das verificações de integridade de serviço do agente

Agente de Monitoramento

Para corrigir isso, instale o agente Linux do Azure Log Analytics e verifique se ele comunica os pontos de extremidade necessários. Para obter mais informações, confira Instalar o agente do Log Analytics em computadores Linux.

Esta tarefa verifica se a pasta está presente -

/etc/opt/microsoft/omsagent/conf/omsadmin.conf

Monitoramento de status do agente

Para corrigir esse problema, você deve iniciar o serviço de Agente do OMS usando o seguinte comando:

 sudo /opt/microsoft/omsagent/bin/service_control restart

Para validar, você pode executar a verificação do processo usando o comando abaixo:

process_name="omsagent"
ps aux | grep %s | grep -v grep" % (process_name)"

Para obter mais informações, confira Solucionar problemas com o agente do Log Analytics para Linux

Hospedagem múltipla

Essa verificação determina se o agente está se comunicando com vários workspaces. O Gerenciamento de Atualizações não dá suporte a hospedagem múltipla.

Para corrigir esse problema, limpe completamente o Agente do OMS e reinstale-o com o workspace vinculado ao gerenciamento de atualizações

Valide se não há mais multihoming verificando os diretórios neste caminho:

/var/opt/microsoft/omsagent.

Como são os diretórios de workspaces, o número de diretórios é igual ao número de workspaces integrados ao OMSAgent.

Hybrid Runbook Worker

Para corrigir o problema, execute o seguinte comando:

sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/PerformRequiredConfigurationChecks.py'

Esse comando força o agente omsconfig a se comunicar com o Azure Monitor e recuperar a configuração mais recente.

Valide para verificar se os dois caminhos a seguir existem:

/opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/VERSION </br> /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/configuration.py

Status do Hybrid Runbook Worker

Essa verificação garante que o Hybrid Runbook Worker esteja em execução no computador. Os processos no exemplo abaixo deverão estar presentes se o Hybrid Runbook Worker estiver sendo executado corretamente.

ps -ef | grep python
nxautom+   8567      1  0 14:45 ?        00:00:00 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/main.py /var/opt/microsoft/omsagent/state/automationworker/oms.conf rworkspace:<workspaceId> <Linux hybrid worker version>
nxautom+   8593      1  0 14:45 ?        00:00:02 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/hybridworker.py /var/opt/microsoft/omsagent/state/automationworker/worker.conf managed rworkspace:<workspaceId> rversion:<Linux hybrid worker version>
nxautom+   8595      1  0 14:45 ?        00:00:02 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/hybridworker.py /var/opt/microsoft/omsagent/<workspaceId>/state/automationworker/diy/worker.conf managed rworkspace:<workspaceId> rversion:<Linux hybrid worker version>

Gerenciamento de Atualizações baixa pacotes do Hybrid Runbook Worker do ponto de extremidade de operações. Portanto, se o Hybrid Runbook Worker não estiver em execução e a verificação do ponto de extremidade de operações falhar, a atualização poderá falhar.

Para corrigir esse problema, execute o seguinte comando:

sudo su omsagent -c 'python /opt/microsoft/omsconfig/Scripts/PerformRequiredConfigurationChecks.py'

Esse comando força o agente omsconfig a se comunicar com o Azure Monitor e recuperar a configuração mais recente.

Se o problema ainda persistir, execute a ferramenta Coletor de Logs do omsagent

Verificações de conectividade

Verificação habilitada para proxy

Para corrigir o problema, remova o proxy ou verifique se o endereço de proxy pode acessar a URL do pré-requisito.

Você pode validar a tarefa executando o comando abaixo:

HTTP_PROXY

Verificação de conectividade do IMDS

Para corrigir esse problema, permita o acesso ao IP 169.254.169.254. Para obter mais informações, confira Acessar Serviço de Metadados de Instância do Azure

Após as alterações de rede, você pode processar novamente a solução de problemas ou executar os comandos abaixo para validar:

 curl -H \"Metadata: true\" http://169.254.169.254/metadata/instance?api-version=2018-02-01

Conectividade com a Internet geral

Essa verificação garante que o computador tenha acesso à Internet e pode ser ignorada se você bloqueou a Internet e permitiu apenas URLs específicas.

CURL em qualquer URL HTTP.

Ponto de extremidade de registro

Essa verificação determina se o Hybrid Runbook Worker pode se comunicar corretamente com a Automação do Azure no workspace do Log Analytics.

As configurações de proxy e firewall devem permitir que o agente do Hybrid Runbook Worker se comunique com o ponto de extremidade de registro. Para obter uma lista de endereços e portas a serem abertas, confira Planejamento de rede

Corrija esse problema permitindo as URLs de pré-requisito. Para obter mais informações, confira Gerenciamento de Atualizações e Controle de Alterações e Inventário

Após as alterações de rede, você pode executar novamente a solução de problemas ou o CURL no ponto de extremidade do JRDS fornecido.

Ponto de extremidade de operações

Essa verificação determina se o agente do Log Analytics pode se comunicar corretamente com o Serviço de Dados de Runtime do Trabalho.

As configurações de proxy e firewall devem permitir que o agente do Hybrid Runbook Worker se comunique com o Serviço de Dados de Runtime do Trabalho. Para obter uma lista de endereços e portas a serem abertas, consulte Planejamento de rede.

Ponto de extremidade do Log Analytics 1

Essa verificação verifica se o seu computador tem acesso aos pontos de extremidade necessários para o agente do Log Analytics.

Corrija esse problema permitindo as URLs de pré-requisito.

Após fazer as alterações de rede, você pode executar novamente a Solução de problemas ou o CURL no ponto de extremidade do ODS fornecido.

Ponto de extremidade do Log Analytics 2

Essa verificação verifica se o seu computador tem acesso aos pontos de extremidade necessários para o agente do Log Analytics.

Corrija esse problema permitindo as URLs de pré-requisito.

Após fazer as alterações de rede, você pode executar novamente a Solução de problemas ou o CURL no ponto de extremidade do OMS fornecido

Repositórios de software

Corrija esse problema permitindo a URL de repositório de pré-requisito. Para RHEL, confira aqui.

Após fazer as alterações de rede, você pode executar novamente a Solução de problemas ou

O CURL nos repositórios de software configurados no gerenciador de pacotes.

Atualizar os repositórios ajuda a confirmar a comunicação.

sudo apt-get check
sudo yum check-update

Observação

A verificação está disponível apenas no modo offline.

Solucionar problemas offline

Você pode usar a solução de problemas offline em um Hybrid Runbook Worker executando o script localmente. O script de Python, UM_Linux_Troubleshooter_Offline.py, pode ser encontrado no GitHub.

Observação

A versão atual do script de solução de problemas não dá suporte ao Ubuntu 20.04.

Um exemplo da saída desse script é mostrado no seguinte exemplo:

Debug: Machine Information:   Static hostname: LinuxVM2
         Icon name: computer-vm
           Chassis: vm
        Machine ID: 00000000000000000000000000000000
           Boot ID: 00000000000000000000000000000000
    Virtualization: microsoft
  Operating System: Ubuntu 16.04.5 LTS
            Kernel: Linux 4.15.0-1025-azure
      Architecture: x86-64


Passed: Operating system version is supported

Passed: Microsoft Monitoring agent is installed

Debug: omsadmin.conf file contents:
        WORKSPACE_ID=00000000-0000-0000-0000-000000000000
        AGENT_GUID=00000000-0000-0000-0000-000000000000
        LOG_FACILITY=local0
        CERTIFICATE_UPDATE_ENDPOINT=https://00000000-0000-0000-0000-000000000000.oms.opinsights.azure.com/ConfigurationService.Svc/RenewCertificate
        URL_TLD=opinsights.azure.com
        DSC_ENDPOINT=https://scus-agentservice-prod-1.azure-automation.net/Accou            nts/00000000-0000-0000-0000-000000000000/Nodes\(AgentId='00000000-0000-0000-0000-000000000000'\)
        OMS_ENDPOINT=https://00000000-0000-0000-0000-000000000000.ods.opinsights            .azure.com/OperationalData.svc/PostJsonDataItems
        AZURE_RESOURCE_ID=/subscriptions/00000000-0000-0000-0000-000000000000/re            sourcegroups/myresourcegroup/providers/microsoft.compute/virtualmachines/linuxvm            2
        OMSCLOUD_ID=0000-0000-0000-0000-0000-0000-00
        UUID=00000000-0000-0000-0000-000000000000


Passed: Microsoft Monitoring agent is running

Passed: Machine registered with log analytics workspace:['00000000-0000-0000-0000-000000000000']

Passed: Hybrid worker package is present

Passed: Hybrid worker is running

Passed: Machine is connected to internet

Passed: TCP test for {scus-agentservice-prod-1.azure-automation.net} (port 443)             succeeded

Passed: TCP test for {eus2-jobruntimedata-prod-su1.azure-automation.net} (port 4            43) succeeded

Passed: TCP test for {00000000-0000-0000-0000-000000000000.ods.opinsights.azure.            com} (port 443) succeeded

Passed: TCP test for {00000000-0000-0000-0000-000000000000.oms.opinsights.azure.            com} (port 443) succeeded

Passed: TCP test for {ods.systemcenteradvisor.com} (port 443) succeeded

Próximas etapas

Solucionar problemas do Hybrid Runbook Worker.