Instalación y administración del agente de Azure Monitor

En este artículo se detallan los distintos métodos para instalar, desinstalar, actualizar y configurar el agente de Azure Monitor en máquinas virtuales de Azure, conjuntos de escalado y servidores habilitados para Azure Arc.

Importante

El agente de Azure Monitor requiere al menos una regla de recopilación de datos (DCR, por sus siglas en inglés) para empezar a recopilar datos después de instalarlos en el equipo cliente. En función del método de instalación que use, es posible que se cree una DCR automáticamente. Si no es así, debe configurar la recopilación de datos siguiendo las instrucciones del artículo Recopilación de datos con el agente de Azure Monitor.

Requisitos previos

Consulte los siguientes artículos para conocer los requisitos previos y otros requisitos del agente de Azure Monitor:

• Entornos y sistemas operativos compatibles con el agente de Azure Monitor
• Requisitos del agente de Azure Monitor
• Configuración de red del agente de Azure Monitor

Importante

La instalación, actualización o desinstalación del agente de Azure Monitor no requerirá un reinicio de la máquina.

Opción de instalación

En la tabla siguiente se enumeran las distintas opciones para instalar y administrar el agente de Azure Monitor en máquinas virtuales de Azure y servidores habilitados para Azure Arc. El agente de Azure Arc debe instalarse en las máquinas que no estén en Azure para poder instalar el agente de Azure Monitor.

Método de instalación	Descripción
Extensión de máquina virtual	Use cualquiera de los métodos siguientes para instalar el agente mediante el marco de extensión de Azure. Este método no crea una DCR, por lo que debe crear al menos una y asociarla al agente antes de que se inicie la recopilación de datos.
Creación de una regla de recopilación de datos	Al crear una DCR en Azure Portal, el agente de Azure Monitor se instala en cualquier máquina que se agregue como recurso para la DCR. El agente comenzará a recopilar inmediatamente los datos definidos en la DCR.
VM Insights	Al habilitar VM Insights en una máquina, se instala el agente de Azure Monitor y se crea una DCR que recopila un conjunto predefinido de datos. No debe modificar esta DCR, pero puede crear reglas adicionales para recopilar otros datos.
Container Insights	Al habilitar Container Insights en un clúster de Kubernetes, se instala una versión contenedorizada del agente de Azure Monitor en el clúster y se crea una DCR que comienza a recopilar datos inmediatamente. Puede modificar esta DCR siguiendo las instrucciones del artículo Configuración de la recopilación de datos y la optimización de costes en Container Insights mediante una regla de recopilación de datos.
Instalador de clientes	Instala el agente mediante un instalador MSI de Windows para clientes de Windows 10 y Windows 11.
Azure Policy	Use Azure Policy para instalar automáticamente el agente en máquinas virtuales de Azure y servidores habilitados para Azure Arc y asociarlos automáticamente a las reglas de recopilación de datos necesarias.

Nota:

Para enviar datos entre inquilinos, primero debe habilitar Azure Lighthouse. No se admite la clonación de una máquina con el agente de Azure Monitor instalado. El procedimiento recomendado para estas situaciones es usar Azure Policy o una infraestructura como herramienta de código para implementar AMA a escala.

Instalación de la extensión del agente

En esta sección se proporcionan detalles sobre cómo instalar el agente de Azure Monitor mediante la extensión de máquina virtual.

Portal

Use las instrucciones que aparecen en el artículo Recopilación de datos con el agente de Azure Monitor para instalar el agente mediante Azure Portal y crear una DCR para recopilar datos.

PowerShell

Puede instalar el agente de Azure Monitor en máquinas virtuales de Azure y en servidores habilitados para Azure Arc mediante el comando de PowerShell para agregar una extensión de máquina virtual.

Azure Virtual Machines

Use los siguientes comandos de PowerShell para instalar el agente de Azure Monitor en máquinas virtuales de Azure. Elija el comando adecuado en función del método de autenticación elegido.

• Windows

  ## User-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  
  ## System-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
  

• Linux

  ## User-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  
  ## System-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
  

Conjunto de escalado de máquinas virtuales de Azure

Use el cmdlet de PowerShell Add-AzVmssExtension para instalar el Agente de Azure Monitor en conjuntos de escalado de máquinas virtuales de Azure.

Servidores habilitados para Azure Arc

Utilice los siguientes comandos de PowerShell para instalar el agente de Azure Monitor en servidores habilitados para Azure Arc.

• Windows

  New-AzConnectedMachineExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
  

• Linux

  New-AzConnectedMachineExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
  

CLI de Azure

Puede instalar el agente de Azure Monitor en máquinas virtuales de Azure y en servidores habilitados para Azure Arc usando el comando de la CLI de Azure para agregar una extensión de máquina virtual.

Azure Virtual Machines

Use los siguientes comandos de la CLI para instalar el agente de Azure Monitor en máquinas virtuales de Azure. Elija el comando adecuado en función del método de autenticación elegido.

Identidad administrada asignada por el usuario

• Windows

  az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  

• Linux

  az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  

Identidad administrada asignada por el sistema

• Windows

  az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
  

• Linux

  az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
  

Conjunto de escalado de máquinas virtuales de Azure

Use el cmdlet de la CLI del conjunto de extensiones az vmss para instalar el Agente de Azure Monitor en conjuntos de escalado de máquinas virtuales de Azure.

Servidores habilitados para Azure Arc

Use los siguientes comandos de la CLI para instalar el agente de Azure Monitor en servidores habilitados para Azure Arc.

• Windows

  az connectedmachine extension create --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
  

• Linux

  az connectedmachine extension create --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
  

Plantilla de Resource Manager

Puede usar las plantillas de Resource Manager para instalar el agente de Azure Monitor en máquinas virtuales de Azure y en servidores habilitados para Azure Arc, así como para crear una asociación con las reglas de recopilación de datos. Debe crear todas las reglas de recopilación de datos antes de crear la asociación.

Obtenga plantillas de ejemplo para instalar el agente y crear la asociación de los siguientes recursos:

• Plantilla para instalar el agente de Azure Monitor (Azure y Azure Arc)
• Plantilla para crear una asociación con una regla de recopilación de datos

Instale las plantillas con cualquier método de implementación para las plantillas de Resource Manager, como los siguientes comandos.

• PowerShell

  New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"
  

• Azure CLI

  az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"
  

Desinstalación

Portal

Para desinstalar el agente de Azure Monitor mediante Azure Portal, vaya a la máquina virtual, al conjunto de escalado o al servidor habilitado para Azure Arc. Seleccione la pestaña Extensiones y AzureMonitorWindowsAgent o AzureMonitorLinuxAgent. En el cuadro de diálogo que se abre, seleccione Desinstalar.

PowerShell

Desinstalación de máquinas virtuales de Azure

Use los siguientes comandos de PowerShell para desinstalar el agente de Azure Monitor en máquinas virtuales de Azure.

• Windows

  Remove-AzVMExtension -Name AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> 
  

• Linux

  Remove-AzVMExtension -Name AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> 
  

Desinstalar en el conjunto de escalado de máquinas virtuales de Azure

Use el cmdlet de PowerShell Remove-AzVmssExtension para instalar el Agente de Azure Monitor en conjuntos de escalado de máquinas virtuales de Azure.

Desinstalación de servidores habilitados para Azure Arc

Use los comandos de PowerShell siguientes para desinstalar el agente de Azure Monitor de los servidores habilitados para Azure Arc.

• Windows

  Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorWindowsAgent
  

• Linux

  Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorLinuxAgent
  

CLI de Azure

Desinstalación de máquinas virtuales de Azure

Use los siguientes comandos de la CLI para desinstalar el agente de Azure Monitor de las máquinas virtuales de Azure.

• Windows

  az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorWindowsAgent
  

• Linux

  az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorLinuxAgent
  

Desinstalar en el conjunto de escalado de máquinas virtuales de Azure

Use el cmdlet de CLI de eliminación de extensión az vmss para desinstalar el Agente de Azure Monitor en conjuntos de escalado de máquinas virtuales de Azure.

Desinstalación de servidores habilitados para Azure Arc

Use los siguientes comandos de la CLI para desinstalar el agente de Azure Monitor de los servidores habilitados para Azure Arc.

• Windows

  az connectedmachine extension delete --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
  

• Linux

  az connectedmachine extension delete --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
  

Plantilla de Resource Manager

N/D

Actualizar

Nota

La recomendación es habilitar la Actualización automática de extensiones, que puede tardar hasta 5 semanas después de que se publique una versión de extensión nueva para que actualice las extensiones instaladas a la versión publicada (más reciente) en todas las regiones. Las actualizaciones se emiten en lotes, por lo que es posible que vea que algunas de las máquinas virtuales, los conjuntos de escalado o los servidores habilitados para Arc se actualizan antes que otros. Si necesita actualizar una extensión inmediatamente, puede usar las instrucciones manuales siguientes.

Portal

Para realizar una actualización única del agente, primero debe desinstalar la versión del agente existente. A continuación, instale la nueva versión, tal como se describe.

Es recomendable habilitar la actualización automática del agente habilitando para ello la característica de actualización automática de extensiones. Vaya a la máquina virtual o el conjunto de escalado, seleccione la pestaña Extensiones y seleccione AzureMonitorWindowsAgent o AzureMonitorLinuxAgent. En el cuadro de diálogo que aparece, seleccione Habilitar actualización automática.

PowerShell

Actualización en máquinas virtuales de Azure

Para llevar a cabo una actualización única del agente, primero debe desinstalar la versión del agente existente y, a continuación, instalar la nueva versión como se ha descrito.

Es recomendable habilitar la actualización automática del agente habilitando la característica de actualización automática de extensiones, mediante los siguientes comandos de PowerShell.

• Windows

  Set-AzVMExtension -ExtensionName AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
  

• Linux

  Set-AzVMExtension -ExtensionName AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
  

Actualización en servidores habilitados para Azure Arc

Para realizar una actualización única del agente, use los siguientes comandos de PowerShell.

• Windows

  $target = @{"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent" = @{"targetVersion"=<target-version-number>}}
  Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
  

• Linux

  $target = @{"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent" = @{"targetVersion"=<target-version-number>}}
  Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
  

Es recomendable habilitar la actualización automática del agente habilitando la característica de actualización automática de extensiones, mediante los siguientes comandos de PowerShell.

• Windows

  Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorWindowsAgent -EnableAutomaticUpgrade
  

• Linux

  Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorLinuxAgent -EnableAutomaticUpgrade
  

CLI de Azure

Actualización en máquinas virtuales de Azure

Para llevar a cabo una actualización única del agente, primero debe desinstalar la versión del agente existente y, a continuación, instalar la nueva versión como se ha descrito.

Es recomendable habilitar la actualización automática del agente habilitando la característica de actualización automática de extensiones, mediante los siguientes comandos de la CLI.

• Windows

  az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

• Linux

  az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

Actualización en servidores habilitados para Azure Arc

Para realizar una actualización única del agente, use los siguientes comandos de la CLI.

• Windows

  az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
  

• Linux

  az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
  

Es recomendable habilitar la actualización automática del agente habilitando la característica de actualización automática de extensiones, mediante los siguientes comandos de PowerShell.

• Windows

  az connectedmachine extension update --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

• Linux

  az connectedmachine extension update --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

Plantilla de Resource Manager

N/D

Configurar

reglas de recopilación de datos (DCR) sirven como herramienta de administración para el agente de Azure Monitor (AMA) en la máquina. La DCR de AgentSettings se puede usar para configurar parámetros AMA como DisQuotaInMb, lo que garantiza que el agente se adapte a sus necesidades de supervisión específicas.

Nota:

Consideraciones importantes a tener en cuenta al trabajar con la DCR de AgentSettings:

• La DCR de AgentSettings solo se puede configurar mediante la implementación de plantillas.
• AgentSettings siempre tiene su propia regla de recopilación de datos y no se le puede agregar una existente.
• Para una funcionalidad adecuada, tanto la máquina como la DCR de AgentSettings deben encontrarse en la misma región.

Parámetros admitidos

La DCR de AgentSettings admite actualmente la configuración de los parámetros siguientes:

Parámetro	Descripción	Valores válidos
DiscQuotaInMb	Define la cantidad de espacio en disco que usan los archivos de registro y la memoria caché del agente de Azure Monitor.	1000-5000 (en MB)
TimeReceivedForForwardedEvents	Cambia la columna WEF de la tabla WEF de Sentinel para usar datos TimeReceived en lugar de datos TimeGenerated.	0 o 1

Configuración de la DCR de AgentSettings

Portal

No se admite actualmente.

PowerShell

N/D

CLI de Azure

N/D

Plantilla de Resource Manager

1. Prepare el entorno:

   Instale AMA en la máquina virtual.

2. Cree una regla de recopilación de datos mediante la implementación de plantillas:

   En el ejemplo siguiente se cambia la cantidad máxima de espacio en disco usado por la memoria caché de AMA a 5 GB.

   {
   "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {},
   "resources": [
       {
       "type": "Microsoft.Insights/dataCollectionRules",
       "name": "dcr-contoso-01",
       "apiVersion": "2023-03-11",
       "properties": 
           {
           "description": "A simple agent settings",
           "agentSettings": 
               {
               "logs": [
                   {
                   "name": "MaxDiskQuotaInMB",
                   "value": "5000"
                   }
               ]
               }
           },
       "kind": "AgentSettings",
       "location": "eastus"
       }
   ]
   }
   

   Nota:

   Puede usar la API Get DataCollectionRule para obtener la carga de la DCR que creó con esta plantilla.

3. Asocie la regla de recopilación de datos con la máquina:

   Esto se puede hacer con una plantilla o mediante la API Create con los detalles siguientes:

   • AssociationName: agentSettings
   • ResourceUri: id. de ARM completo para la máquina virtual
   • api-version: 2023-03-11 (la versión anterior de la API también sirve)
   • Cuerpo:

         {
         "properties": {
             "dataCollectionRuleId": “Full ARM ID for agent setting DCR”
             }
         }
     

4. Active la configuración:

   Reinicie AMA para aplicar los cambios.

Pasos siguientes

Cree una regla de recopilación de datos para recopilar datos del agente y enviarlos a Azure Monitor.