Instalación del agente de Azure Monitor en dispositivos cliente Windows mediante el instalador de cliente

Use el instalador del cliente para instalar el agente de Azure Monitor en dispositivos cliente de Windows y enviar datos de supervisión al área de trabajo de Log Analytics.

Tanto la Extensión del agente de Azure Monitor como el instalador instalan el mismo agente subyacente y usan reglas de recopilación de datos (DCR) para configurar la recopilación de datos.

En este artículo se explica cómo instalar el agente de Azure Monitor en dispositivos cliente Windows mediante el instalador de cliente y cómo asociar DCR a los dispositivos cliente de Windows.

Comparación con la extensión de máquina virtual

Esta es una comparación entre el uso del instalador de cliente y el uso de la extensión de máquina virtual (VM) para el agente de Azure Monitor:

Tipos de dispositivos compatibles

Requisitos previos

Limitaciones

• Las reglas de recopilación de datos que cree para las máquinas cliente de Windows solo pueden tener como destino todo el ámbito de inquilino de Microsoft Entra. Es decir, una regla de recopilación de datos asociada a un objeto supervisado se aplica a todas las máquinas cliente de Windows en las que se instala el agente de Azure Monitor mediante este instalador del cliente dentro del inquilino. No se admite la segmentación pormenorizadas mediante reglas de recopilación de datos para dispositivos cliente Windows.

• El agente de Azure Monitor no admite la supervisión de máquinas de Windows conectadas por medio de vínculos privados de Azure.

• El agente instalado mediante el instalador de cliente de Windows está diseñado principalmente para equipos de escritorio o estaciones de trabajo de Windows que siempre están conectados. Aunque puede instalar el agente de Azure Monitor en equipos portátiles mediante el instalador, el agente no está optimizado para el consumo de batería y las limitaciones de red de un portátil.

• Las métricas de Azure Monitor no se admiten como destino para dispositivos cliente Windows.

Instalación del agente

1. Descargue el instalador MSI del agente de Windows.

   También puede descargarlo en Azure Portal. En el menú del portal, vaya a Monitor>Reglas de recopilación de datos>Crear como se muestra en el recorte de pantalla siguiente:

   

2. Abra una ventana de comandos con privilegios de administrador y cambie el directorio a la ubicación donde descargó el instalador.

3. Para realizar la instalación con la configuración predeterminada, ejecute el comando siguiente:

   msiexec /i AzureMonitorAgentClientSetup.msi /qn
   

4. Para realizar la instalación con rutas de acceso de archivo personalizadas, la configuración del proxy de red, o en una nube no pública, use el siguiente comando. Use los valores de la tabla siguiente.

   msiexec /i AzureMonitorAgentClientSetup.msi /qn DATASTOREDIR="C:\example\folder"
   

   Parámetro	Descripción
   INSTALLDIR	Ruta de acceso del directorio donde se instalan los archivos binarios del agente.
   DATASTOREDIR	Ruta de acceso del directorio donde el agente almacena sus registros operativos y los datos.
   PROXYUSE	Debe establecerse en true para usar un proxy.
   PROXYADDRESS	Establezca este valor en la dirección de proxy. PROXYUSE debe establecerse en true para aplicarse correctamente.
   PROXYUSEAUTH	Establézcalo en true si un proxy requiere autenticación.
   PROXYUSERNAME	Establezca este valor en el nombre de usuario del proxy. PROXYUSE y PROXYUSEAUTH deben establecerse en true.
   PROXYPASSWORD	Establezca este valor en la contraseña del proxy. PROXYUSE y PROXYUSEAUTH deben establecerse en true.
   CLOUDENV	Configurar el nombre de la nube como: Azure Commercial, Azure China, Azure US Gov, Azure USNat, o Azure USSec.

5. Compruebe que la instalación es correcta:

   1. Abre Panel de control>Programas y características. Asegúrese de que el Agente de Azure Monitor aparezca en la lista de programas.
   2. Abra Servicios y confirme que aparece el Agente Azure Monitor y el Estado es Ejecución.

Vaya a la sección siguiente para crear un objeto supervisado que se asociará a los DCR para iniciar el agente.

Creación y asociación de un objeto supervisado

A continuación, cree un objeto supervisado, que representa el inquilino de Microsoft Entra en Azure Resource Manager. A continuación, los DCR se asocian a la entidad de Azure Resource Manager. Azure asocia un objeto supervisado a todas las máquinas cliente de Windows en el mismo inquilino de Microsoft Entra.

Actualmente, el ámbito de esta asociación se limita al inquilino de Microsoft Entra. La configuración que se aplica al inquilino de Microsoft Entra se aplica a todos los dispositivos que forman parte del inquilino y ejecutan el agente instalado a través del instalador de cliente. Los agentes instalados a través de la extensión de máquina virtual no están en el ámbito y no se ven afectados.

En la imagen siguiente se muestra cómo funciona la asociación de objetos supervisados:

A continuación, continúe en la sección siguiente para crear y asociar DCR a un objeto supervisado mediante la API de REST o comandos de Azure PowerShell.

Permisos requeridos

Dado que un objeto supervisado es un recurso de nivel de inquilino, el ámbito de los permisos es mayor que el ámbito de los permisos necesarios para una suscripción. Es posible que se requiera un administrador de inquilinos de Azure para realizar este paso. Completa los pasos para elevar un administrador de tenant de Microsoft Entra a administrador de tenant de Azure. Proporciona permisos de propietario en el ámbito raíz al administrador de tenant de Microsoft Entra. Este ámbito de permisos es necesario para todos los métodos descritos en la sección siguiente.

Opción 1: Uso de las API REST

En las secciones siguientes se describen los pasos para crear un DCR y asociarlo a un objeto supervisado mediante la API de REST:

1. Asigna el rol de Colaborador de objetos supervisados al operador.
2. Crear un objeto supervisado.
3. Asocie el DCR al objeto supervisado.

Estas tareas también se describen:

• Enumeración de las asociaciones con el objeto supervisado.
• Desasocie el DCR del objeto supervisado.

Asignación del rol Colaborador de objetos supervisados al operador

Este paso concede permisos para crear y vincular un objeto supervisado a un usuario o grupo.

URI de solicitud

PUT https://management.azure.com/providers/microsoft.insights/providers/microsoft.authorization/roleassignments/{roleAssignmentGUID}?api-version=2021-04-01-preview

Parámetros de URI

Encabezados

• Autorización: token de portador de Azure Resource Manager (use Get-AzAccessToken u otro método)
• "Content-Type: Application/json"

Cuerpo de la solicitud

{
    "properties":
    {
        "roleDefinitionId":"/providers/Microsoft.Authorization/roleDefinitions/56be40e24db14ccf93c37e44c597135b",
        "principalId":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
    }
}

Parámetros del cuerpo

Una vez completado este paso, volver a autenticar la sesión y volver a adquirir el token de portador de Azure Resource Manager.

Crear un objeto supervisado

En este paso se crea el objeto supervisado para el ámbito del inquilino de Microsoft Entra. Se utiliza para representar los dispositivos cliente firmados con esa identidad de inquilino de Microsoft Entra.

Permisos necesarios: cualquier persona que tenga el rol Colaborador de objetos supervisados en un ámbito adecuado puede realizar esta operación, como se asigna en el paso 1.

URI de solicitud

PUT https://management.azure.com/providers/Microsoft.Insights/monitoredObjects/{AADTenantId}?api-version=2021-09-01-preview

Parámetros de URI

Encabezados

• Autorización: token de portador de Azure Resource Manager
• "Content-Type: Application/json"

Cuerpo de la solicitud

{
    "properties":
    {
        "___location":"eastus"
    }
}

Parámetros del cuerpo

Asocie el DCR al objeto supervisado

Ahora asocie el DCR al objeto supervisado mediante la creación de asociaciones de reglas de recopilación de datos (DCRAs).

Permisos necesarios: cualquier persona que tenga el rol Colaborador de objetos supervisados en un ámbito adecuado puede realizar esta operación, como se asigna en el paso 1.

URI de solicitud

PUT https://management.azure.com/{MOResourceId}/providers/microsoft.insights/datacollectionruleassociations/{associationName}?api-version=2021-09-01-preview

URI de solicitud de ejemplo

PUT https://management.azure.com/providers/Microsoft.Insights/monitoredObjects/{AADTenantId}/providers/microsoft.insights/datacollectionruleassociations/{associationName}?api-version=2021-09-01-preview

Parámetros de URI

Encabezados

• Autorización: token de portador de Azure Resource Manager
• "Content-Type: Application/json"

Cuerpo de la solicitud

{
    "properties":
    {
        "dataCollectionRuleId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{DCRName}"
    }
}

Parámetros del cuerpo

Enumeración de las asociaciones con el objeto supervisado

Si necesita ver las asociaciones, puede enumerar las asociaciones del objeto supervisado.

Permisos necesarios: cualquier persona que tenga el rol Lector en un ámbito adecuado puede realizar esta operación, similar a los permisos asignados en el paso 1.

URI de solicitud

GET https://management.azure.com/{MOResourceId}/providers/microsoft.insights/datacollectionruleassociations/?api-version=2021-09-01-preview

URI de solicitud de ejemplo

GET https://management.azure.com/providers/Microsoft.Insights/monitoredObjects/{AADTenantId}/providers/microsoft.insights/datacollectionruleassociations/?api-version=2021-09-01-preview

{
  "value": [
    {
      "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm/providers/Microsoft.Insights/dataCollectionRuleAssociations/myRuleAssociation",
      "name": "myRuleAssociation",
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "properties": {
        "dataCollectionRuleId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myCollectionRule",
        "provisioningState": "Succeeded"
      },
      "systemData": {
        "createdBy": "user1",
        "createdByType": "User",
        "createdAt": "2021-04-01T12:34:56.1234567Z",
        "lastModifiedBy": "user2",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-04-02T12:34:56.1234567Z"
      },
      "etag": "070057da-0000-0000-0000-5ba70d6c0000"
    }
  ],
  "nextLink": null
}

Desasociar el DCR del objeto supervisado

Si necesita quitar una asociación de un DCR del objeto supervisado.

Permisos necesarios: cualquier persona que tenga el rol Colaborador de objetos supervisados en un ámbito adecuado puede realizar esta operación, como se asigna en el paso 1.

URI de solicitud

DELETE https://management.azure.com/{MOResourceId}/providers/microsoft.insights/datacollectionruleassociations/{associationName}?api-version=2021-09-01-preview

URI de solicitud de ejemplo

DELETE https://management.azure.com/providers/Microsoft.Insights/monitoredObjects/{AADTenantId}/providers/microsoft.insights/datacollectionruleassociations/{associationName}?api-version=2021-09-01-preview

Parámetros de URI

Encabezados

• Autorización: token de portador de Azure Resource Manager
• "Content-Type: Application/json"

Opción 2: Uso de Azure PowerShell

El siguiente script de Azure PowerShell:

• Asigna al operador el rol de Colaborador de Objetos Supervisados.
• Crea un objeto supervisado.
• Asocia un DCR al objeto supervisado.
• (Opcional) Asocia otro DCR a un objeto supervisado.
• (Opcional) Enumera las asociaciones con el objeto supervisado.

$TenantID = "xxxxxxxxx-xxxx-xxx" #Your tenant ID
$SubscriptionID = "xxxxxx-xxxx-xxxxx" #Your subscription ID
$ResourceGroup = "rg-yourResourceGroup" #Your resource group

#If the following cmdlet produces the error 'Interactive authentication is not supported in this session,' run
#cmdlet Connect-AzAccount -UseDeviceAuthentication
#uncomment -UseDeviceAuthentication on next line
Connect-AzAccount -Tenant $TenantID #-UseDeviceAuthentication

#Select the subscription
Select-AzSubscription -SubscriptionId $SubscriptionID

#Grant access to the user at root scope "/"
$user = Get-AzADUser -SignedIn

New-AzRoleAssignment -Scope '/' -RoleDefinitionName 'Owner' -ObjectId $user.Id

#Create the auth token
$auth = Get-AzAccessToken

$AuthenticationHeader = @{
    "Content-Type" = "application/json"
    "Authorization" = "Bearer " + $auth.Token
    }


#Assign the Monitored Object Contributor role to the operator
$newguid = (New-Guid).Guid
$UserObjectID = $user.Id

$body = @"
{
            "properties": {
                "roleDefinitionId":"/providers/Microsoft.Authorization/roleDefinitions/56be40e24db14ccf93c37e44c597135b",
                "principalId": `"$UserObjectID`"
        }
}
"@

$requestURL = "https://management.azure.com/providers/microsoft.insights/providers/microsoft.authorization/roleassignments/$newguid`?api-version=2021-04-01-preview"


Invoke-RestMethod -Uri $requestURL -Headers $AuthenticationHeader -Method PUT -Body $body

##########################

#Create a monitored object
#The '___location' property value in the 'body' section should be the Azure region where the monitored object is stored. It should be the same region where you created the data collection rule. This is the region where agent communications occurs.
$Location = "eastus" #Use your own ___location
$requestURL = "https://management.azure.com/providers/Microsoft.Insights/monitoredObjects/$TenantID`?api-version=2021-09-01-preview"
$body = @"
{
    "properties":{
        "___location":`"$Location`"
    }
}
"@

$Respond = Invoke-RestMethod -Uri $requestURL -Headers $AuthenticationHeader -Method PUT -Body $body -Verbose
$RespondID = $Respond.id

##########################

#Associate a DCR to the monitored object
#See reference documentation https://learn.microsoft.com/rest/api/monitor/data-collection-rule-associations/create?tabs=HTTP
$associationName = "assoc01" #You can define your custom association name, but you must change the association name to a unique name if you want to associate multiple DCRs to a monitored object.
$DCRName = "dcr-WindowsClientOS" #Your data collection rule name

$requestURL = "https://management.azure.com$RespondId/providers/microsoft.insights/datacollectionruleassociations/$associationName`?api-version=2021-09-01-preview"
$body = @"
        {
            "properties": {
                "dataCollectionRuleId": "/subscriptions/$SubscriptionID/resourceGroups/$ResourceGroup/providers/Microsoft.Insights/dataCollectionRules/$DCRName"
            }
        }

"@

Invoke-RestMethod -Uri $requestURL -Headers $AuthenticationHeader -Method PUT -Body $body

#(Optional example) Associate another DCR to a monitored object. Remove comments around the following text to use it as a sample.
#See reference documentation https://learn.microsoft.com/en-us/rest/api/monitor/data-collection-rule-associations/create?tabs=HTTP
<#
$associationName = "assoc02" #You must change the association name to a unique name if you want to associate multiple DCRs to a monitored object.
$DCRName = "dcr-PAW-WindowsClientOS" #Your Data collection rule name

$requestURL = "https://management.azure.com$RespondId/providers/microsoft.insights/datacollectionruleassociations/$associationName`?api-version=2021-09-01-preview"
$body = @"
        {
            "properties": {
                "dataCollectionRuleId": "/subscriptions/$SubscriptionID/resourceGroups/$ResourceGroup/providers/Microsoft.Insights/dataCollectionRules/$DCRName"
            }
        }

"@

Invoke-RestMethod -Uri $requestURL -Headers $AuthenticationHeader -Method PUT -Body $body

#(Optional) Get all the associations.
$requestURL = "https://management.azure.com$RespondId/providers/microsoft.insights/datacollectionruleassociations?api-version=2021-09-01-preview"
(Invoke-RestMethod -Uri $requestURL -Headers $AuthenticationHeader -Method get).value
#>

Desasociar el DCR del objeto supervisado mediante PowerShell

El siguiente script de PowerShell desasocia un DCR de un objeto supervisado.

#Remove the monitor object
$TenantID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" #Your Tenant ID

Connect-AzAccount -Tenant $TenantID

#Create the auth token
$auth = Get-AzAccessToken

$AuthenticationHeader = @{
    "Content-Type" = "application/json"
    "Authorization" = "Bearer " + $auth.Token
}

#Get the monitored object
$requestURL = "https://management.azure.com/providers/Microsoft.Insights/monitoredObjects/$TenantID`?api-version=2021-09-01-preview"
$MonitoredObject = Invoke-RestMethod -Uri $requestURL -Headers $AuthenticationHeader -Method Get

#Get DCRs associated to the monitored object 
$requestURL = "https://management.azure.com$($MonitoredObject.id)/providers/microsoft.insights/datacollectionruleassociations?api-version=2021-09-01-preview"
$MonitoredObjectAssociations = Invoke-RestMethod -Uri $requestURL -Headers $AuthenticationHeader -Method Get

#Disassociate the monitored object from all DCRs
foreach ($Association in $MonitoredObjectAssociations.value){
    $requestURL = "https://management.azure.com$($Association.id)?api-version=2022-06-01"
    Invoke-RestMethod -Uri $requestURL -Headers $AuthenticationHeader -Method Delete
}

#Delete the monitored object
$requestURL = "https://management.azure.com/providers/Microsoft.Insights/monitoredObjects/$TenantID`?api-version=2021-09-01-preview"
Invoke-AzRestMethod -Uri $requestURL -Method Delete

Verificar la configuración exitosa

En el área de trabajo de Log Analytics que especificó como destino en las DCR, compruebe la tabla Heartbeat y otras tablas que configuró en las reglas.

Las columnas SourceComputerId, Computer, y ComputerIP deben reflejar la información del dispositivo cliente respectivamente y la columna Categoría debe indicar Agente de Azure Monitor.

Administración del agente

En las secciones siguientes se muestra cómo administrar el agente:

• Comprobación de la versión del agente
• Desinstalación del agente
• Actualización del agente

Comprobación de la versión del agente

1. Abre Panel de control>Programas y características.
2. En la lista de programas, seleccione Agente de Azure Monitor.
3. Compruebe el valor de Version.

También puede comprobar la versión del agente en Configuración.

Desinstalación del agente

1. Abre Panel de control>Programas y características.
2. En la lista de programas, seleccione Agente de Azure Monitor.
3. En la barra de menús, seleccione Desinstalar.

También puede desinstalar el agente en Configuración.

Si tiene problemas al desinstalar el agente, consulte Solución de problemas.

Actualización del agente

Para actualizar la versión, instale la nueva versión a la que desea actualizar.

Solución de problemas

Visualización de los registros de diagnóstico del agente

1. Vuelva a ejecutar la instalación con el registro activado y especifique el nombre del archivo de registro: Msiexec /I AzureMonitorAgentClientSetup.msi /L*V <log file name>.

2. Los registros en tiempo de ejecución se recopilan automáticamente en la ubicación predeterminadaC:\Resources\Azure Monitor Agent\ o en la ruta de acceso del archivo especificada durante la instalación.

   Si no encuentra la ruta de acceso, la ubicación exacta se indica en el registro como AMADataRootDirPath en HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureMonitorAgent.

3. La carpeta ServiceLogs contiene el registro del servicio Windows del agente de Azure Monitor, que inicia y administra los procesos del agente de Azure Monitor.

4. AzureMonitorAgent.MonitoringDataStore contiene datos y registros de los procesos del agente de Azure Monitor.

Resolución de problemas de instalación y desinstalación

En las secciones siguientes se describe cómo resolver problemas de instalación y desinstalación.

Falta un archivo DLL

Mensaje de error: "Hay un problema con este paquete de Windows Installer. No se pudo ejecutar un archivo DLL necesario para que este instalador se complete..."

Resolución: asegúrese de instalar C++ Redistributable (>2015) antes de instalar el agente de Azure Monitor. Instale el archivo redistribuible correspondiente e inténtelo de nuevo.

No unido a Microsoft Entra

Mensaje de error: "Error de recuperación de identificadores de inquilino y dispositivo"

Resolución: ejecute el comando dsregcmd /status. En la sección Device State, la salida esperada es AzureAdJoined : YES y en la sección Device Details es DeviceAuthStatus : SUCCESS. Si esta salida no aparece, conecte el dispositivo con un tenant de Microsoft Entra y luego inténtelo de nuevo.

Se ha producido un error en la instalación silenciosa desde el símbolo del sistema

Asegúrese de iniciar el instalador mediante la opción Ejecutar como administrador. La instalación silenciosa solo se puede iniciar en un símbolo del sistema de administrador.

Se produce un error en la desinstalación porque el desinstalador no puede detener el servicio

1. Si hay una opción para intentar desinstalarla de nuevo, inténtelo de nuevo.
2. Si el reintento del desinstalador no funciona, cancele la desinstalación y detenga el servicio del agente de Azure Monitor en Services>Aplicaciones de escritorio.
3. Vuelva a intentar la desinstalación.

Forzar la desinstalación manualmente cuando el desinstalador no funciona

1. Detenga el servicio Agente de Monitor de Azure. A continuación, intente de nuevo la desinstalación. Si se produce un error, continúe con los pasos siguientes.
2. Elimine el servicio de agente de Azure Monitor ejecutando sc delete AzureMonitorAgent en un símbolo del sistema de administrador.
3. Descargue una herramienta de destino y desinstale el agente de Azure Monitor.
4. Elimine los archivos binarios del agente de Azure Monitor. De manera predeterminada, los archivos binarios del agente se almacenan en Archivos de programa\Agente de Azure Monitor.
5. Elimine los registros y los datos del agente de Azure Monitor. De manera predeterminada, los datos y registros del agente se almacenan en C:\Resources\Agente de Azure Monitor.
6. Abrir Registro. Compruebe HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure Monitor Agent. Si existe, elimine la clave.

Problemas operativos y posteriores a la instalación

Una vez instalado correctamente el agente (es decir, si ve que se está ejecutando el servicio del agente, pero no ve los datos esperados), siga los pasos estándar de solución de problemas que se indican para una Máquina virtual Windows y un Servidor habilitado para Windows Arc, respectivamente.

Preguntas más frecuentes

Obtenga respuestas a las preguntas comunes.

¿Azure Arc es necesario para las máquinas unidas a Microsoft Entra?

N.º Las máquinas unidas a Microsoft Entra (o unidas a híbridos de Microsoft Entra) que ejecutan Windows 11 o 10 (SO cliente) no requieren que se instale Azure Arc. En su lugar, puede usar el instalador MSI de Windows para el agente de Azure Monitor.

Preguntas y comentarios

Realice esta encuesta rápida o comparta sus comentarios o preguntas sobre el instalador de cliente.