Guía de solución de problemas del agente de Azure Monitor en máquinas virtuales Windows y conjuntos de escalado

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

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 la máquina virtual > Abra Settings: Extensions + applications (Configuración: Extensiones y aplicaciones) en el panel de la izquierda > Debería aparecer "AzureMonitorWindowsAgent" con el estado "Aprovisionamiento realizado correctamente".
2. Si no es así, compruebe si la máquina puede acceder a Azure y busque la extensión que se va a instalar mediante el comando siguiente:
```
az vm extension image list-versions --location <machine-region> --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor
```
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:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent en la máquina.
5. Si ninguno de los elementos anteriores ayuda, cree una incidencia de soporte técnico con el campo Resumen con el texto "La extensión de AMA no se puede instalar o aprovisionar" y el campo Tipo de problema con el texto "Necesito ayuda con el agente de Azure Monitor para Windows".
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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Configuration en la máquina.
4. Si ninguno de los elementos anteriores ayuda, cree una incidencia de soporte técnico con el campo Resumen con el texto "La extensión de AMA está aprovisionada pero no en ejecución" y el campo Tipo de problema con el texto "Necesito ayuda con el agente de Azure Monitor para Windows".
Compruebe que exista la DCR y esté asociada a la máquina virtual:
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 la máquina virtual, compruebe la existencia del archivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.latest.xml. Si este archivo no existe:
  - Es posible que la máquina virtual no esté asociada a una DCR. Consulte el paso 3.
  - Es posible que la máquina virtual no tenga habilitada la identidad administrada. Consulte aquí cómo habilitarla.
  - El servicio IMDS no se ejecuta o no es accesible desde la máquina virtual. Compruebe si puede acceder a IMDS desde la máquina. Si no es así, presente un vale con Resumen como “El servicio IMDS no se ejecuta” y Tipo de problema como “Necesito ayuda para configurar la recopilación de datos de una máquina virtual”.
  - AMA no puede acceder a IMDS. Compruebe si ve errores de IMDS en el archivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MAEventTable.tsf. Si es así, presente un vale con Resumen como “AMA no puede acceder a IMDS” y Tipo de problema como “Necesito ayuda para configurar la recopilación de datos de una VM”.
3. Abra Azure Portal > Seleccione la regla de recopilación de datos > Abra Configuration: Resources (Configuración: Recursos) en el panel de la izquierda > La máquina virtual debería aparecer aquí.
4. Si no aparece, haga clic en "Agregar" y seleccione la máquina virtual en el selector de recursos. Repita esto para todas las DCR.
5. Si ninguno de los elementos anteriores ayuda, cree una incidencia de soporte técnico con el campo Resumen con el texto "DCR no encontrada o asociada" y el campo Tipo de problema con el texto "Necesito ayuda para configurar la recopilación de datos de una máquina virtual".
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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\configchunks
2. Si no es así, cree una incidencia de soporte técnico con el campo Resumen con el texto "AMA no puede descargar la configuración de DCR" y el campo Tipo de problema con el texto "Necesito ayuda con el agente de Azure Monitor para Windows".

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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml. Si no existe, cree una incidencia de soporte técnico con el campo Resumen con el texto "AMA no se ejecutó lo suficiente para al marcado" y el campo Tipo de problema con el texto "Necesito ayuda con el agente de Azure Monitor para Windows".

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>

Si no hay nodos CounterSet, la DCR no se ha analizado correctamente. Cree una incidencia de soporte técnico con el campo Resumen con el texto "AMA no puede analizar la configuración de DCR" y el campo Tipo de problema con el texto "Necesito ayuda con el agente de Azure Monitor para Windows".

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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\AuthToken-MSI.json esté presente.
Compruebe que el archivo C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MaMetricsExtensionEtw.tsf.
1. El comando generará el archivo "MaMetricsExtensionEtw.csv".
2. Ábralo, busque los errores de nivel 2 e intente corregirlos.
Si ninguno de los elementos anteriores ayuda, cree una incidencia de soporte técnico con el campo Resumen con el texto "AMA no puede recopilar métricas personalizadas" y el campo Tipo de problema con el texto "Necesito ayuda con el agente de Azure Monitor para Windows".

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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml. Si no existe, cree una incidencia de soporte técnico con el campo Resumen con el texto "AMA no se ejecutó lo suficiente para al marcado" y el campo Tipo de problema con el texto "Necesito ayuda con el agente de Azure Monitor para Windows".
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>
```
Si no hay nodos Subscription, la DCR no se ha analizado correctamente. Cree una incidencia de soporte técnico con el campo Resumen con el texto "AMA no puede analizar la configuración de DCR" y el campo Tipo de problema con el texto "Necesito ayuda con el agente de Azure Monitor para Windows".

Creación de una incidencia

Abra una regla de recopilación de datos y, en el menú de la izquierda, seleccione Nueva solicitud de soporte técnico. También puede abrir el panel Ayuda y soporte técnico y seleccionar Crear una solicitud de soporte técnico.
Seleccione:
- Tipo de problema: técnico.
- Suscripción: elija la suscripción donde residen las máquinas.
- Tipo de servicio: reglas de recopilación de datos y Agente de Azure Monitor.
- ¿El problema está relacionado con algún recurso?: sí. Seleccione la máquina mediante el selector de recursos.
Escriba los campos Resumen y Tipo de problema, tal y como se indica en los pasos de solución de problemas. Aportar detalles precisos posibilitará una resolución más rápida del problema.
Seleccione Siguiente y revise las soluciones recomendadas para ver si le sirven.
Si no le sirvieran, seleccione Siguiente y rellene el conjunto siguiente de detalles.
Seleccione Siguiente, revise los detalles finales y seleccione Crear.