Compartilhar via


Como usar a Solução de Problemas do Agente do Azure Monitor do 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 seu uso e planejamento adequadamente. Para obter mais informações, confira as Diretrizes de Fim do Suporte do CentOS.

O solucionador de problemas do Azure Monitor Agent (AMA) 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 do Windows é um executável que acompanha o agente em todas as versões superiores a 1.25.1 do Linux.

Pré-requisitos

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.

Se houver várias versões do Python instaladas e configuradas com alias, 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?
copy sim sim
DATETIME sim sim
json sim sim
os sim sim
plataforma sim sim
{1>re<1} 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 da Solução de Problemas do Agente 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