Diretrizes de solução de problemas para o agente do Azure Monitor no servidor Windows habilitado para Azure Arc

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 no servidor Windows habilitado para Azure Arc:

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 o servidor habilitado para Arc > Abra Configurações: Extensões no painel à esquerda > 'AzureMonitorWindowsAgent' deve aparecer com Status: 'Êxito'
   2. Caso contrário, verifique se o agente do Arc (Agente de Computador Conectado) pode se conectar ao Azure e se o serviço de extensão está em execução.

      azcmagent show
      

      Você deverá ver a saída abaixo:

      Resource Name                           : <server name>
      [...]
      Dependent Service Status
        Agent Service (himds)                 : running
        GC Service (gcarcservice)             : running
        Extension Service (extensionservice)  : running
      

   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:\ProgramData\GuestConfig\extension_logs\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:\Resources\Directory\AMADataStore\Configuration no seu computador

4. Verifique se a DCR existe e está associado ao servidor habilitado para Arc:

   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. No servidor habilitado para Arc, verifique se o arquivo C:\Resources\Directory\AMADataStore\mcs\mcsconfig.latest.xml existe. Se esse arquivo não existir, o servidor habilitado para Arc poderá não estar associado a uma DCR.
   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 o servidor habilitado para Arc listado aqui
   4. Se ele não estiver listado, clique em 'Adicionar' e selecione seu servidor habilitado para Arc 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:\Resources\Directory\AMADataStore\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:\Resources\Directory\AMADataStore\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:\Resources\Directory\AMADataStore\mcs\AuthToken-MSI.json está presente.

5. Verifique se o arquivo C:\Resources\Directory\AMADataStore\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:\Resources\Directory\AMADataStore\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:\Resources\Directory\AMADataStore\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>