Como usar o solucionador de problemas do agente do Azure Monitor do sistema operacional (SO) Windows
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
O Solucionador de Problemas do AMA do Windows é um executável de linha de comando enviado com o agente para todas as versões mais recentes que 1.12.0.0.
Pré-requisitos
Verificação da existência do solucionador 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:
- Extensão do AMA – PowerShell
- Extensão do AMA – Prompt de Comando
- AMA Autônomo – PowerShell
- AMA Autônomo – Prompt de Comando
Para verificar se o Solucionador de Problemas do Agente está presente, copie o seguinte comando e execute-o no PowerShell como administrador:
Test-Path -Path "C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent"
Se o diretório existir, o cmdlet Test-Path retornará True.
Se o diretório não existir ou se a instalação falhar, siga as etapas Básicas de solução de problemas.
Sim, o diretório existe. Prossiga para Executar o solucionador de problemas.
Executar o solucionador de problemas
No computador a ser diagnosticado, execute a Solução de Problemas do Agente.
- Extensão do AMA – PowerShell
- Extensão do AMA – Prompt de Comando
- AMA Autônomo – PowerShell
- AMA Autônomo – Prompt de Comando
Para iniciar o Solucionador de Problemas do Agente, copie o seguinte comando e execute-o no PowerShell como administrador:
$currentVersion = ((Get-ChildItem -Path "Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Azure\HandlerState\" `
| where Name -like "*AzureMonitorWindowsAgent*" `
| ForEach-Object {$_ | Get-ItemProperty} `
| where InstallState -eq "Enabled").PSChildName -split('_'))[1]
$troubleshooterPath = "C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\$currentVersion\Troubleshooter"
Set-Location -Path $troubleshooterPath
Start-Process -FilePath $troubleshooterPath\AgentTroubleshooter.exe -ArgumentList "--ama"
Invoke-Item $troubleshooterPath
Ele executa uma série de atividades que podem levar até 15 minutos para serem concluídas. Seja paciente até que o processo esteja concluído.
O arquivo de registro é criado no diretório no qual o AgentTroubleshooter.exe está localizado.
Exemplo de instalação baseada em extensão: 
Exemplo para instalação autônoma: 
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.