Diretrizes de solução de problemas para o agente do Azure Monitor em máquinas virtuais Windows e conjuntos de dimensionamento

Visão geral do agente do Azure Monitor

Antes de ler mais, você precisa estar familiarizado com o agente do Azure Monitor e as Regras de Coleta de Dados.

Terminologia

Etapas básicas de solução de problemas (instalação, agente que não está em execução, problemas de configuração)

Siga as etapas abaixo para solucionar problemas da versão mais recente do agente do Azure Monitor em execução na máquina virtual do Windows:

1. Examine cuidadosamente os pré-requisitos mostrados aqui.

2. Verifique se a extensão foi instalada e provisionada com êxito, que instala os binários do agente em seu computador:

   1. Abra o portal do Azure > selecione sua máquina virtual > Abra Configurações: Extensões + aplicativos no painel à esquerda > 'AzureMonitorWindowsAgent' deve aparecer com o status: 'Provisionamento bem-sucedido'
   2. Caso contrário, verifique se o computador pode acessar o Azure e localize a extensão a ser instalada usando o comando abaixo:

      az vm extension image list-versions --location <machine-region> --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor
      

   3. Aguarde de dez a 15 minutos, pois o status da extensão pode estar em transição. Se ainda não aparecer, desinstale e instale novamente a extensão e repita a verificação para ver a extensão aparecer.
   4. Se não ocorrer, verifique se há erros em logs de extensão localizados em C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent em seu computador

3. Verifique se o agente está em execução:

   1. Verifique se o agente está emitindo logs de pulsação para o workspace do Log Analytics usando a consulta abaixo. Ignore se 'Métricas Personalizadas' é o único destino na DCR:

      Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
      

   2. Caso contrário, abra o Gerenciador de Tarefas e verifique se o processo 'MonAgentCore.exe' está em execução. Se estiver, aguarde cinco minutos para que a pulsação apareça.
   3. Se não aparecer, verifique se você vê erros em logs do agente principal localizados em C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Configuration no seu computador

4. Verifique se a DCR existe e está associado à máquina virtual:

   1. Se estiver usando o workspace do Log Analytics como destino, verifique se a DCR existe na mesma região física que o workspace do Log Analytics.
   2. Em sua máquina virtual, verifique a existência do arquivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.latest.xml. Se esse arquivo não existir:
      • A máquina virtual pode não estar associada a uma DCR. Confira a etapa 3
      • A máquina virtual pode não ter a Identidade Gerenciada habilitada. Veja aqui como habilitar.
      • O serviço IMDS não está em execução/acessível na máquina virtual. Verifique se você pode acessar o IMDS do computador.
      • O AMA não consegue acessar o IMDS. Verifique se você vê erros de IMDS no arquivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MAEventTable.tsf.
   3. Abra o portal do Azure > selecione a regra de coleta de dados > Abra a folha Configuração: Recursos no painel à esquerda > Você deve ver a máquina virtual listada aqui
   4. Se não estiver listada, clique em 'Adicionar' e selecione sua máquina virtual no seletor de recursos. Repita em todas as DCRs.

5. Verifique se o agente foi capaz de baixar as DCRs associadas do serviço AMCS:

   1. Verifique se você vê a DCR mais recente baixada neste local: C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\configchunks

Problemas ao coletar contadores de desempenho

1. Verifique se o JSON da DCR contém uma seção para 'performanceCounters'. Caso contrário, corrija a DCR. Confira como criar uma DCR ou DCR de exemplo.
2. Verifique se o arquivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml existe.
3. Abra o arquivo e verifique se ele contém nós CounterSet, conforme mostrado no exemplo abaixo:

   <CounterSet storeType="Local" duration="PT1M" 
       eventName="c9302257006473204344_16355538690556228697" 
       sampleRateInSeconds="15" format="Factored">
       <Counter>\Processor(_Total)\% Processor Time</Counter>
       <Counter>\Memory\Committed Bytes</Counter>
       <Counter>\LogicalDisk(_Total)\Free Megabytes</Counter>
       <Counter>\PhysicalDisk(_Total)\Avg. Disk Queue Length</Counter>
   </CounterSet>
   

Problemas ao usar 'Métricas Personalizadas' como destino

1. Examine cuidadosamente os pré-requisitos aqui.
2. Verifique se a DCR associada foi criada corretamente para coletar contadores de desempenho e enviá-los para as métricas do Azure Monitor. Você deve ver esta seção em sua DCR:

   "destinations": {  
   "azureMonitorMetrics": {  
       "name":"myAmMetricsDest" 
       } 
   }
   

3. Execute o comando do PowerShell:

   Get-WmiObject Win32_Process -Filter "name = 'MetricsExtension.Native.exe'" | select Name,ExecutablePath,CommandLine | Format-List
   

   Verifique se o parâmetro CommandLine na saída contém o argumento "-TokenSource MSI"
4. Verifique se o arquivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\AuthToken-MSI.json está presente.
5. Verifique se o arquivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\CUSTOMMETRIC_<subscription>_<region>_MonitoringAccount_Configuration.json está presente.
6. Coletar logs executando o comando C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\<version-number>\Monitoring\Agent\table2csv.exe C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MaMetricsExtensionEtw.tsf
   1. O comando gerará o arquivo 'MaMetricsExtensionEtw.csv'
   2. Abra-o, procure erros de Nível 2 e tente corrigi-los.

Problemas ao coletar logs de eventos do Windows

1. Verifique se o JSON da DCR contém uma seção para 'windowsEventLogs'. Caso contrário, corrija a DCR. Confira como criar uma DCR ou DCR de exemplo.
2. Verifique se o arquivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml existe.
3. Abra o arquivo e verifique se ele contém nós Subscription, conforme mostrado no exemplo abaixo:

   <Subscription eventName="c9302257006473204344_14882095577508259570" 
   query="System!*[System[(Level = 1 or Level = 2 or Level = 3)]]">
       <Column name="ProviderGuid" type="mt:wstr" defaultAssignment="00000000-0000-0000-0000-000000000000">
         <Value>/Event/System/Provider/@Guid</Value>
       </Column>
       ...
   
       </Column>
   </Subscription>