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

Artigo
11/05/2024

Visão geral do agente do Azure Monitor

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

Terminologia

Nome	Acrónimos	Description
Agente do Azure Monitor	AMA	O novo agente do Azure Monitor
Regras de Recolha de Dados	DCR	Regras para configurar a coleta de dados pelo agente, ou seja, o que coletar, para onde enviar e muito mais
Serviço de Configuração do Azure Monitor	AMCS	Serviço regional hospedado no Azure, que controla a coleta de dados para este agente e outras partes do Azure Monitor. O agente chama este serviço para buscar DCRs.
Ponto de extremidade de logs	--	Ponto de extremidade para enviar dados para espaços de trabalho do Log Analytics
Ponto final de métricas	--	Ponto de extremidade para enviar dados para bancos de dados do Azure Monitor Metrics.
Serviço de metadados de instância e híbrido	IMDS e HIMDS	Serviços hospedados no Azure que fornecem informações sobre máquinas virtuais em execução no momento, conjuntos de dimensionamento (via IMDS) e servidores habilitados para Arc (via HIMDS), respectivamente
Área de trabalho do Log Analytics	DIREITO	O destino no Azure Monitor para o qual você pode enviar logs coletados pelo agente
Métricas Personalizadas	--	O destino no Azure Monitor para o qual você pode enviar métricas de convidado coletadas pelo agente

Etapas básicas de solução de problemas (instalação, agente não 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 em seu servidor habilitado para Windows Arc:

Analise cuidadosamente os pré-requisitos aqui.
Verifique se a extensão foi instalada e provisionada com êxito, o que instala os binários do agente em sua máquina:
1. Abra o portal > do Azure selecione seu servidor > habilitado para Arc Abrir Configurações : As extensões do painel à esquerda > 'AzureMonitorWindowsAgent'devem aparecer com Status: 'Succeeded'
2. Caso contrário, verifique se o agente Arc (Connected Machine Agent) é capaz de se conectar ao Azure e se o serviço de extensão está em execução.
```
azcmagent show
```
  Você deve 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 10 a 15 minutos como extensão talvez em status de transição. Se mesmo assim não aparecer, desinstale e instale a extensão novamente e repita a verificação para ver a extensão aparecer.
4. Caso contrário, verifique se você vê algum erro nos logs de extensão localizados em C:\ProgramData\GuestConfig\extension_logs\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent sua máquina
Verifique se o agente está em execução:
1. Verifique se o agente está emitindo logs de pulsação para o espaço de trabalho do Log Analytics usando a consulta abaixo. Ignore se 'Métricas personalizadas' for o único destino no DCR:
```
Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
```
2. Caso contrário, abra o Gestor de Tarefas e verifique se o processo 'MonAgentCore.exe' está em execução. Se for, aguarde 5 minutos para que os batimentos cardíacos apareçam.
3. Caso contrário, verifique se você vê algum erro nos logs do agente principal localizados em C:\Resources\Directory\AMADataStore\Configuration sua máquina
Verifique se o DCR existe e está associado ao servidor habilitado para Arc:
1. Se estiver usando o espaço de trabalho do Log Analytics como destino, verifique se o DCR existe na mesma região física do espaço de trabalho do Log Analytics.
2. No servidor habilitado para Arc, verifique a existência do arquivo C:\Resources\Directory\AMADataStore\mcs\mcsconfig.latest.xml. Se esse arquivo não existir, o servidor habilitado para Arc pode não estar associado a um DCR.
3. Abra o portal > do Azure selecione sua regra > de coleta de dados Abrir configuração : recursos do painel à esquerda > Você deve ver o servidor habilitado para Arc listado aqui
4. Se não estiver listado, clique em 'Adicionar' e selecione seu servidor habilitado para Arc no seletor de recursos. Repita em todos os DCRs.
Verifique se o agente conseguiu baixar o(s) DCR(s) associado(s) do serviço AMCS:
1. Verifique se você vê o DCR mais recente baixado neste local C:\Resources\Directory\AMADataStore\mcs\configchunks

Problemas na coleta de contadores de desempenho

Verifique se o JSON DCR contém uma seção para 'performanceCounters'. Caso contrário, corrija o seu DCR. Veja como criar DCR ou exemplo de DCR.
Verifique se o arquivo C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml existe.

Abra o arquivo e verifique se ele contém CounterSet nós como 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

Analise cuidadosamente os pré-requisitos aqui.
Verifique se o DCR associado foi criado corretamente para coletar contadores de desempenho e enviá-los para as métricas do Azure Monitor. Deverá ver esta secção no seu DCR:
```
"destinations": {  
"azureMonitorMetrics": {  
    "name":"myAmMetricsDest" 
    } 
}
```

Execute o comando 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"

Verifique se C:\Resources\Directory\AMADataStore\mcs\AuthToken-MSI.json o arquivo está presente.
Verifique se C:\Resources\Directory\AMADataStore\mcs\CUSTOMMETRIC_<subscription>_<region>_MonitoringAccount_Configuration.json o arquivo está presente.
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 irá gerar o ficheiro 'MaMetricsExtensionEtw.csv'
2. Abra-o e procure por quaisquer erros de Nível 2 e tente corrigi-los.

Problemas ao coletar logs de eventos do Windows

Verifique se o JSON DCR contém uma seção para 'windowsEventLogs'. Caso contrário, corrija o seu DCR. Veja como criar DCR ou exemplo de DCR.
Verifique se o arquivo C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml existe.

Abra o arquivo e verifique se ele contém Subscription nós como 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>

Partilhar via