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
Se houver várias versões do Python instaladas e configuradas com alias, use:
ls -ls /usr/bin/python*
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-*"
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.
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.