Partilhar via

Resolver problemas do agente de atualização do Linux

  • Artigo

Importante

O agente Change Tracking and Inventory using Log Analytics foi desativado em 31 de agosto de 2024 e funcionará em suporte limitado até 01 de fevereiro de 2025. Recomendamos que você use o Agente de Monitoramento do Azure como o novo agente de suporte. Siga as orientações para Migração do Registo de Alterações e Inventário utilizando o Log Analytics para o Registo de Alterações e Inventário utilizando Agente de Monitorização do Azure versão.

Pode haver muitas razões pelas quais sua máquina não está aparecendo como pronta (íntegra) no Gerenciamento de Atualizações. Você pode verificar a integridade de um agente Linux Hybrid Runbook Worker para determinar o problema subjacente. Seguem-se os três estados de preparação de um computador:

  • Preparado: a Função de Trabalho de Runbook Híbrida está implementada e foi vista pela última vez há menos de uma hora.
  • Desligado: a Função de Trabalho de Runbook Híbrida está implementada e foi vista pela última vez há mais de uma hora.
  • Não configurado: O Runbook Worker Híbrido não foi encontrado ou não concluiu a implantação.

Nota

Pode haver um pequeno atraso entre o que o portal do Azure mostra e o estado atual de uma máquina.

Este artigo descreve como executar a resolução de problemas para máquinas do Azure a partir do portal do Azure e máquinas não Azure no cenário offline.

Nota

Atualmente, o script da solução de problemas não roteia o tráfego por meio de um servidor proxy se um estiver configurado.

Iniciar a resolução de problemas

Para máquinas do Azure, selecione o link de solução de problemas na coluna Preparação do Update Agent no portal para abrir a página Solucionar problemas do Update Agent. Para máquinas virtuais que não são do Azure, a ligação leva-o a este artigo. Para solucionar problemas de uma máquina que não seja do Azure, consulte as instruções na seção Solucionar problemas offline .

Captura de ecrã da página de listagem de VM.

Nota

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 do Update Agent, selecione Executar verificações para iniciar a solução de problemas. A solução de problemas usa o comando Executar para executar um script na máquina para verificar as dependências. Quando a resolução de problemas for concluída, devolve o resultado das verificações.

Captura de ecrã da página Resolução de problemas.

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

Screenshot da Resolução de Problemas do Linux.

Verificações de pré-requisitos

Sistema operativo

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

Verificação Dmidecode

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

sudo dmidecode

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

Verificações do estado de funcionamento do serviço do agente de monitorização

Agente de Monitorização

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, consulte Instalar o agente do Log Analytics em computadores Linux.

Esta tarefa verifica se a pasta está presente -

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

Status do Agente de Monitoramento

Para corrigir esse problema, você deve iniciar o serviço OMS Agent 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, consulte Solucionar problemas com o agente do Log Analytics para Linux

Multihoming

Essa verificação determina se o agente está se reportando a vários espaços de trabalho. O Gerenciamento de Atualizações não oferece suporte a multihoming.

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

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

/var/opt/microsoft/omsagent.

Como eles são os diretórios de espaços de trabalho, o número de diretórios é igual ao número de espaços de trabalho integrados ao OMSAgent.

Função de Trabalho de Runbook Híbrida

Para corrigir o problema, execute o seguinte comando:

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

Este comando força o agente omsconfig a falar com o Azure Monitor e recuperar a configuração mais recente.

Valide para verificar se existem os dois caminhos a seguir:

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

Status do Runbook Worker híbrido

Essa verificação garante que o Hybrid Runbook Worker esteja em execução na máquina. Os processos no exemplo abaixo devem 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>

O 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 das 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'

Este comando força o agente omsconfig a falar com o Azure Monitor e recuperar a configuração mais recente.

Se o problema persistir, execute a ferramenta omsagent Log Collector

Verificações de conectividade

Verificação habilitada para proxy

Para corrigir o problema, remova o proxy ou certifique-se de que o endereço proxy é capaz de acessar a URL de pré-requisito.

Você pode validar a tarefa executando o comando abaixo:

HTTP_PROXY

Verificação de conectividade IMDS

Para corrigir esse problema, permita o acesso ao IP 169.254.169.254. Para obter mais informações, consulte Access Azure Instance Metadata Service

Após as alterações de rede, você pode executar 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 geral com a Internet

Essa verificação garante que a máquina tenha acesso à internet e possa ser ignorada se você tiver bloqueado a internet e permitido apenas URLs específicos.

CURL em qualquer url http.

Ponto final do registo

Essa verificação determina se o Runbook Worker Híbrido pode se comunicar corretamente com a Automação do Azure no espaço de trabalho do Log Analytics.

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

Corrija esse problema permitindo as URLs de pré-requisito. Para obter mais informações, consulte Gerenciamento de atualizações e controle de alterações e inventário

Postar as alterações de rede, você pode executar novamente a solução de problemas ou CURL no ponto de extremidade jrds fornecido.

Ponto final de operações

Essa verificação determina se o agente do Log Analytics pode se comunicar corretamente com o Job Runtime Data Service.

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

Ponto de extremidade 1 do Log Analytics

Essa verificação verifica se sua máquina 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 alterações na rede, você pode executar novamente a Solução de problemas ou Curl no ponto de extremidade ODS fornecido.

Ponto de extremidade 2 do Log Analytics

Essa verificação verifica se sua máquina 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 alterações na rede, você pode executar novamente a Solução de problemas ou Curl no ponto de extremidade do OMS fornecido

Repositórios de software

Corrija esse problema permitindo o URL de recompra de pré-requisito. Para RHEL, veja aqui.

Após fazer alterações na Rede, você pode executar novamente a Solução de Problemas ou

Curl em repositórios de software configurados no gerenciador de pacotes.

Refrescar os repositórios ajudaria a confirmar a comunicação.

sudo apt-get check
sudo yum check-update

Nota

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

Resolver problemas offline

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

Nota

A versão atual do script de solução de problemas não suporta o Ubuntu 20.04.

Um exemplo da saída desse script é mostrado no exemplo a seguir:

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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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óximos passos

Solucione problemas do Hybrid Runbook Worker.