Como usar a Solução de Problemas do Agente do Azure Monitor no sistema operacional (SO) Linux

Cuidado

Este artigo faz referência ao CentOS, uma distribuição Linux que está em status de fim do serviço (EOL). Considere o seu uso e planeje de acordo. Para obter mais informações, confira as Diretrizes de Fim do Suporte do CentOS.

O solucionador de problemas do AMA (agente do Azure Monitor) foi projetado para ajudar a identificar problemas com o agente e realizar avaliações gerais de integridade. Ele pode realizar várias verificações para garantir que o agente esteja instalado e conectado corretamente e também pode reunir registros relacionados ao AMA do computador que está sendo diagnosticado.

Observação

A Solução de Problemas do AMA é um executável que acompanha o agente em todas as versões superiores a 1.25.1 para Linux.

Pré-requisitos

Requisito de ponto de extremidade público

O solucionador de problemas do AMA do Linux requer acesso ao seguinte ponto de extremidade público para funcionar corretamente: https://docs.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-extension-versions

Essa URL é usada pela ferramenta para recuperar as informações de versão mais recentes do AMA (Agente do Azure Monitor). Verifique se a conectividade de saída para este ponto de extremidade é permitida do ambiente onde a ferramenta está em execução. A falta de acesso pode resultar em tempos limite ou falhas durante a solução de problemas.

Requisito do Python

A Solução de Problemas do AMA para Linux requer o Python 2.6+ ou qualquer versão do Python 3 instalada no computador.

Para verificar se o Python está instalado no seu computador, copie o comando a seguir e execute no Bash como raiz:

sudo python -V
sudo python3 -V

Captura de tela dos comandos para verificar a versão do Python no Linux.

Várias versões do Python podem ser instaladas e configuradas com alias – se várias versões estiverem instaladas, use:

ls -ls /usr/bin/python*

Captura de tela do comando para verificar várias versões do Python para Linux.

Se sua máquina virtual estiver usando uma distribuição que não inclua o Python 3 por padrão, instale-o. Os exemplos de comandos a seguir instalarão o Python 3 em diferentes distribuições:

sudo yum install -y python3

Além disso, os seguintes pacotes do Python são necessários para serem executados (todos devem estar presentes em uma instalação padrão do Python 2 ou Python 3):

Pacote do Python Necessário para Python 2? Necessário para Python 3?
copiar sim sim
datetime sim sim
json sim sim
so sim sim
plataforma sim sim
re sim sim
solicitações não sim
shutil sim sim
subprocesso sim sim
url lib sim não
xml.dom.minidom sim sim

Verificação da existência da solução de problemas

Verifique a existência do diretório do Agente de Solução de Problemas AMA no computador a ser diagnosticado para confirmar a instalação do agente de solução de problemas.

/var/lib/waagent/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-{version}

Para verificar se a solução de problemas do agente do Azure Monitor está presente, copie o seguinte comando e execute no Bash como raiz:

ls -ltr /var/lib/waagent | grep "Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-*"

Captura de tela da janela Bash, mostrando o resultado do comando ls para o diretório de instalação do AMA.

Se o diretório não existir ou se a instalação falhar, siga as Etapas básicas de solução de problemas.

Se o diretório existir, siga para Executar a Solução de Problemas.

Executar a Solução de Problemas

No computador a ser diagnosticado, execute a Solução de Problemas do Agente.

O Modo de Log ativa a coleta de logs, que podem ser comprimidos em formato .tgz para exportação ou análise. O Modo Interativo permite que os usuários participem ativamente dos cenários de solução de problemas e vejam os resultados diretamente no shell.

Para iniciar a Solução de Problemas do Agente no modo de log, copie o seguinte comando e execute-o no Bash como raiz:

Observação

Atualize a {version} para corresponder ao número da versão instalada. No exemplo a seguir, a versão é 1.28.11.

cd /var/lib/waagent/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-{version}/ama_tst/
sudo sh ama_troubleshooter.sh -L

Insira um caminho para salvar os logs. Por exemplo, você pode usar /tmp.

O processo executa uma série de atividades e salva um arquivo .tgz no diretório especificado. Seja paciente até que esse processo termine.

Captura de tela da janela Bash, mostrando o resultado do AgentTroubleshooter em execução com a opção -L para gerar logs.

Perguntas frequentes

Posso copiar a Solução de Problemas de um agente mais recente para um agente mais antigo e executá-lo no agente mais antigo para diagnosticar problemas com o agente mais antigo?

Não é possível usar a Solução de Problemas para diagnosticar uma versão mais antiga do agente copiando-a. Você deve ter uma versão atualizada do agente para que a Solução de Problemas funcione corretamente.

Próximas etapas