Guía de solución de problemas del agente de Azure Monitor en el servidor Windows habilitado para Arc

Artículo
10/15/2024

Introducción al agente de Azure Monitor

Antes de leer más, debe estar familiarizado con el agente de Azure Monitor y las reglas de recopilación de datos.

Terminología

Nombre	Acrónimo	Descripción
Agente de Azure Monitor	AMA	Nuevo agente de Azure Monitor
Reglas de recopilación de datos	DCR	Reglas para configurar la recopilación de datos por parte del agente, es decir, qué recopilar, dónde enviarlo y mucho más
Servicio de configuración de Azure Monitor	AMCS	Servicio regional hospedado en Azure, que controla la recopilación de datos para este agente y otras partes de Azure Monitor. El agente llama a este servicio para capturar las DCR.
Punto de conexión de registros	--	Punto de conexión para enviar datos a las áreas de trabajo de Log Analytics
Punto de conexión de métricas	--	Punto de conexión para enviar datos a las bases de datos de métricas de Azure Monitor.
Azure Instance Metadata Service e híbrido	IMDS e HIMDS	Servicios hospedados en Azure que proporcionan información sobre las máquinas virtuales actualmente en ejecución, los conjuntos de escalado (mediante IMDS) y los servidores habilitados para Arc (mediante HIMDS), respectivamente.
Área de trabajo de Log Analytics	LAW	Destino de Azure Monitor al que puede enviar los registros recopilados por el agente
Métricas personalizadas	--	Destino de Azure Monitor al que puede enviar las métricas de invitado recopiladas por el agente

Pasos básicos de solución de problemas (instalación, el agente no se ejecuta, problemas de configuración)

Siga los pasos que se indican a continuación para solucionar los problemas de la versión más reciente del agente de Azure Monitor que se ejecuta en el servidor Windows habilitado para Arc:

Revise detenidamente los requisitos previos aquí.
Compruebe que la extensión se haya instalado y aprovisionado correctamente, lo que instala los archivos binarios del agente en la máquina:
1. Abra Azure Portal > Seleccione el servidor habilitado para Arc > Abra Settings: Extensions (Configuración: Extensiones) en el panel de la izquierda > Debería aparecer "AzureMonitorWindowsAgent" con el estado "Correcto".
2. Si no es así, compruebe si el agente de Arc (agente de Connected Machine) puede conectarse a Azure y el servicio de extensión se está ejecutando.
```
azcmagent show
```
  Debería ver el resultado siguiente:
```
Resource Name                           : <server name>
[...]
Dependent Service Status
  Agent Service (himds)                 : running
  GC Service (gcarcservice)             : running
  Extension Service (extensionservice)  : running
```
3. Espere entre 10 y 15 minutos, ya que la extensión tal vez en el estado de transición. Si sigue sin aparecer, desinstale e instale la extensión de nuevo y repita la comprobación para ver si aparece la extensión.
4. Si no es así, compruebe si ve algún error en los registros de extensión ubicados en C:\ProgramData\GuestConfig\extension_logs\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent en la máquina.
Compruebe que el agente se esté ejecutando:
1. Compruebe si el agente emite registros de latidos al área de trabajo de Log Analytics mediante la consulta siguiente. Puede omitirlo si "Métricas personalizadas" es el único destino de la DCR:
```
Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
```
2. Si no es así, abra el Administrador de tareas y compruebe si se está ejecutando el proceso "MonAgentCore.exe". Si está en ejecución, espere 5 minutos para que aparezca el latido.
3. Si no lo está, compruebe si ve algún error en los registros básicos del agente ubicados en C:\Resources\Directory\AMADataStore\Configuration en la máquina.
Compruebe que exista la DCR y esté asociada al servidor habilitado para Arc:
1. Si usa el área de trabajo de Log Analytics como destino, compruebe que la DCR exista en la misma región física que el área de trabajo de Log Analytics.
2. En el servidor habilitado para Arc, compruebe la existencia del archivo C:\Resources\Directory\AMADataStore\mcs\mcsconfig.latest.xml. Si este archivo no existe, es posible que el servidor habilitado para Arc no esté asociado a una DCR.
3. Abra Azure Portal > Seleccione la regla de recopilación de datos > Abra Configuration: Resources (Configuración: Recursos) en el panel de la izquierda > El servidor habilitado para Arc debería aparecer aquí.
4. Si no aparece, haga clic en "Agregar" y seleccione el servidor habilitado para Arc en el selector de recursos. Repita esto para todas las DCR.
Compruebe que el agente haya podido descargar las DCR asociadas desde el servicio AMCS:
1. Compruebe si ve la versión más reciente de la DCR descargada en esta ubicación: C:\Resources\Directory\AMADataStore\mcs\configchunks

Problemas al recopilar contadores de rendimiento

Compruebe que el código JSON de la DCR contenga una sección para "performanceCounters". Si no es así, corrija la DCR. Consulte cómo crear una DCR o una DCR de ejemplo.
Compruebe que exista el archivo C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml.

Abra el archivo y compruebe si contiene nodos CounterSet, como se muestra en el ejemplo siguiente:

<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 al usar "Métricas personalizadas" como destino

Revise detenidamente los requisitos previos aquí.
Asegúrese de que la DCR asociada esté creada correctamente para recopilar los contadores de rendimiento y enviarlos a las métricas de Azure Monitor. Debería ver esta sección en la DCR:
```
"destinations": {  
"azureMonitorMetrics": {  
    "name":"myAmMetricsDest" 
    } 
}
```

Ejecute el comando de PowerShell:

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

Compruebe que el parámetro CommandLine de la salida contenga el argumento "-TokenSource MSI".

Compruebe que el archivo C:\Resources\Directory\AMADataStore\mcs\AuthToken-MSI.json esté presente.
Compruebe que el archivo C:\Resources\Directory\AMADataStore\mcs\CUSTOMMETRIC_<subscription>_<region>_MonitoringAccount_Configuration.json esté presente.
Recopile los registros mediante la ejecución del comando C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\<version-number>\Monitoring\Agent\table2csv.exe C:\Resources\Directory\AMADataStore\Tables\MaMetricsExtensionEtw.tsf.
1. El comando generará el archivo "MaMetricsExtensionEtw.csv".
2. Ábralo, busque los errores de nivel 2 e intente corregirlos.

Problemas al recopilar los registros de eventos de Windows

Compruebe que el código JSON de la DCR contenga una sección para "windowsEventLogs". Si no es así, corrija la DCR. Consulte cómo crear una DCR o una DCR de ejemplo.
Compruebe que exista el archivo C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml.

Abra el archivo y compruebe si contiene nodos Subscription, como se muestra en el ejemplo siguiente:

<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>

Compartir a través de