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

Artigo
01/23/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 sua máquina virtual do Windows:

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 sua máquina > virtual Abrir Configurações: Extensões + aplicativos no painel à esquerda > 'AzureMonitorWindowsAgent'deve aparecer com Status: 'Provisionamento bem-sucedido'
2. Se não, verifique se a máquina pode acessar o Azure e encontre a extensão para instalar usando o comando abaixo:
```
az vm extension image list-versions --location <machine-region> --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor
```
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:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent sua máquina
5. Se nenhuma das opções acima ajudar, registre um tíquete com Resumo como 'A extensão AMA falha ao instalar ou provisionar' e Tipo de problema como 'Preciso de ajuda com o Azure Monitor Windows Agent'.
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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Configuration sua máquina
4. Se nenhuma das opções acima ajudar, registre um tíquete com Resumo como 'extensão AMA provisionada, mas não em execução' e Tipo de problema como 'Preciso de ajuda com o Azure Monitor Windows Agent'.
Verifique se o DCR existe e está associado à máquina virtual:
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. Na máquina virtual, verifique a existência do arquivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.latest.xml. Se este ficheiro não existir:
  - A máquina virtual pode não estar associada a um DCR. Ver passo 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 a partir da máquina virtual. Verifique se consegue aceder ao IMDS a partir da máquina. Caso contrário, registre um tíquete com Resumo como 'O serviço IMDS não está em execução' e Tipo de problema como 'Preciso de ajuda para configurar a coleta de dados de uma VM'.
  - O AMA não pode acessar o IMDS. Verifique se você vê erros IMDS no C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MAEventTable.tsf arquivo. Se sim, registre um tíquete com Resumo como 'AMA não pode acessar o IMDS' e Tipo de problema como 'Preciso de ajuda para configurar a coleta de dados de uma VM'.
3. Abra o portal > do Azure Selecione sua regra > de coleta de dados Abrir configuração : Recursos do painel à esquerda > Você deve ver a máquina virtual listada aqui
4. Se não estiver listado, clique em 'Adicionar' e selecione sua máquina virtual no seletor de recursos. Repita em todos os DCRs.
5. Se nenhuma das opções acima ajudar, registre um tíquete com Resumo como 'DCR não encontrado ou associado' e Tipo de problema como 'Preciso de ajuda para configurar a coleta de dados de uma VM'.
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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\configchunks
2. Caso contrário, registre um tíquete com Resumo como 'AMA incapaz de baixar a configuração DCR' e Tipo de problema como 'Preciso de ajuda com o Azure Monitor Windows Agent'.

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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml existe. Se ele não existir, registre um tíquete com Resumo como "AMA não funcionou o suficiente para marcar e Tipo de problema como "Preciso de ajuda com o Azure Monitor Windows Agent".

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>

Se não CounterSet houver nós, o DCR não foi analisado corretamente. Registre um tíquete com Resumo como 'AMA não é possível analisar a configuração DCR' e Tipo de problema como 'Preciso de ajuda com o Azure Monitor Windows Agent'.

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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\AuthToken-MSI.json o arquivo está presente.
Verifique se C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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.
Se nenhuma das opções acima ajudar, registre um tíquete com Resumo como 'AMA incapaz de coletar métricas personalizadas' e Tipo de problema como 'Preciso de ajuda com o Azure Monitor Windows Agent'.

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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml existe. Se ele não existir, registre um tíquete com Resumo como "AMA não funcionou o suficiente para marcar e Tipo de problema como "Preciso de ajuda com o Azure Monitor Windows Agent".

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>

Se não houver nós , então o DCR não Subscriptionfoi analisado corretamente. Registre um tíquete com Resumo como 'AMA não é possível analisar a configuração DCR' e Tipo de problema como 'Preciso de ajuda com o Azure Monitor Windows Agent'.

Registre um ticket

Abra uma regra de coleta de dados e, no menu à esquerda, selecione Nova solicitação de suporte. Você também pode abrir o painel Ajuda + suporte e selecionar Criar uma solicitação de suporte.
Selecione:
- Tipo de problema: Técnico.
- Subscrição: Selecione a subscrição onde residem as suas máquinas.
- Tipo de serviço: Regras de coleta de dados e Azure Monitor Agent.
- O seu problema está relacionado com um recurso?: Sim. Selecione sua máquina usando o seletor de recursos.
Insira o tipo Resumo e Problema, conforme indicado nas etapas de solução de problemas. Informações precisas levam a uma resolução mais rápida do problema.
Selecione Avançar e revise as soluções recomendadas para ver se elas ajudam.
Se eles não ajudarem, selecione Avançar e preencha o próximo conjunto de detalhes.
Selecione Avançar, revise os detalhes finais e selecione Criar.

Share via