Habilitación de VM Insights para una máquina virtual híbrida

En este artículo se describe cómo habilitar VM Insights para una máquina virtual fuera de Azure, incluidos los entornos locales y otros entornos en la nube.

Importante

El método recomendado para habilitar VM híbridas primero consiste en habilitar Azure Arc para servidores, a fin de que las VM se puedan habilitar para VM Insights con procesos similares a los de las VM de Azure. En este artículo se describe cómo incorporar máquinas virtuales híbridas si decide no usar Azure Arc.

Requisitos previos

Información general

Las máquinas virtuales fuera de Azure requieren el mismo agente de Log Analytics y el mismo Dependency Agent que los que se usan para las máquinas virtuales de Azure. Dado que no se pueden usar las extensiones de máquina virtual para instalar los agentes, debe instalarlos manualmente en el sistema operativo invitado o mediante algún otro método.

Vea Conexión de equipos Windows a Azure Monitor o Conexión de equipos Linux a Azure Monitor para más información sobre la implementación del agente de Log Analytics. En este artículo se proporcionan detalles sobre Dependency Agent.

Requisitos de firewall

Los requisitos de firewall para el agente de Log Analytics se proporcionan en Introducción al agente de Log Analytics. La instancia de Dependency Agent de asignación de VM Insights no transmite ningún dato y no requiere ningún cambio en firewalls o puertos. Los datos de Mapa siempre son transmitidos por el agente de Log Analytics al servicio de Azure Monitor, ya sea directamente o mediante la Puerta de enlace de Operations Management Suite, si las directivas de seguridad de TI no permiten que los equipos de la red se conecten a Internet.

Dependency Agent

Nota

La siguiente información que se describe en esta sección también se aplica a la solución Service Map.

Puede descargar Dependency Agent desde estas ubicaciones:

Archivo SO Versión SHA-256
InstallDependencyAgent-Windows.exe Windows 9.10.13.19190 0882504FE5828C4C4BA0A869BD9F6D5B0020A52156DDBD21D55AAADA762923C4
InstallDependencyAgent-Linux64.bin Linux 9.10.13.19190 7D90A2A7C6F1D7FB2BCC274ADC4C5D6C118E832FF8A620971734AED4F446B030

Instalar Dependency Agent en Windows

Para instalar Dependency Agent manualmente en equipos Windows, puede ejecutar InstallDependencyAgent-Windows.exe. Si ejecuta este archivo ejecutable sin opciones, se inicia un asistente para instalación que puede seguir para realizar la instalación del agente de forma interactiva. Necesita privilegios de administrador en el sistema operativo invitado para instalar o desinstalar el agente.

En la tabla siguiente se destacan los parámetros que admite el programa de instalación para el agente desde la línea de comandos.

Parámetro Descripción
/? Devuelve una lista de las opciones de la línea de comandos.
/S Realiza una instalación silenciosa sin interacción del usuario.

Por ejemplo, para ejecutar el programa de instalación con el parámetro /?, escriba InstallDependencyAgent-Windows.exe /? .

Los archivos de Dependency Agent para Windows se instalan en C:\Archivos de programa\Microsoft Dependency Agent de manera predeterminada. Si Dependency Agent no se inicia una vez completada la instalación, compruebe los registros para obtener información detallada del error. El directorio de registro es %Programfiles%\Microsoft Dependency Agent\logs.

Script de PowerShell

Use el siguiente script de PowerShell de ejemplo para descargar e instalar el agente:

Invoke-WebRequest "https://aka.ms/dependencyagentwindows" -OutFile InstallDependencyAgent-Windows.exe

.\InstallDependencyAgent-Windows.exe /S

Instalación de Dependency Agent en Linux

Dependency Agent se instala en los servidores Linux desde InstallDependencyAgent-Linux64.bin, un script de shell con un archivo binario autoextraíble. Puede ejecutar el archivo mediante sh o agregar permisos de ejecución al propio archivo.

Nota

Es necesario el acceso raíz para instalar o configurar el agente.

Parámetro Descripción
-help Obtenga una lista de las opciones de la línea de comandos.
-S Realice una instalación silenciosa sin preguntas.
--check Compruebe los permisos y el sistema operativo, pero no instale el agente.

Por ejemplo, para ejecutar el programa de instalación con el parámetro -help, escriba InstallDependencyAgent-Linux64.bin -help. Para instalar Dependency en Linux como raíz, ejecute el comando sh InstallDependencyAgent-Linux64.bin.

Si Dependency Agent no se inicia, compruebe los registros para obtener información detallada del error. En los agentes de Linux, el directorio de registro es /var/opt/microsoft/dependency-agent/log.

Los archivos de Dependency Agent se colocan en los directorios siguientes:

Archivos Location
Archivos principales /opt/microsoft/dependency-agent
Archivos de registro /var/opt/microsoft/dependency-agent/log
Archivos de configuración /etc/opt/microsoft/dependency-agent/config
Archivos ejecutables de servicio /opt/microsoft/dependency-agent/bin/microsoft-dependency-agent
/opt/microsoft/dependency-agent/bin/microsoft-dependency-agent-manager
Archivos binarios de almacenamiento /var/opt/microsoft/dependency-agent/storage

Script de shell

Use el siguiente script de shell de ejemplo para descargar e instalar el agente:

wget --content-disposition https://aka.ms/dependencyagentlinux -O InstallDependencyAgent-Linux64.bin
sudo sh InstallDependencyAgent-Linux64.bin -s

Configuración de estado deseado

Para implementar Dependency Agent mediante Desired State Configuration (DSC), puede usar el módulo xPSDesiredStateConfiguration con el siguiente código de ejemplo:

configuration VMInsights {

    Import-DscResource -ModuleName xPSDesiredStateConfiguration

    $DAPackageLocalPath = "C:\InstallDependencyAgent-Windows.exe"

    Node localhost
    {
        # Download and install the Dependency agent
        xRemoteFile DAPackage
        {
            Uri = "https://aka.ms/dependencyagentwindows"
            DestinationPath = $DAPackageLocalPath
        }

        xPackage DA
        {
            Ensure="Present"
            Name = "Dependency Agent"
            Path = $DAPackageLocalPath
            Arguments = '/S'
            ProductId = ""
            InstalledCheckRegKey = "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\DependencyAgent"
            InstalledCheckRegValueName = "DisplayName"
            InstalledCheckRegValueData = "Dependency Agent"
            DependsOn = "[xRemoteFile]DAPackage"
        }
    }
}

Solución de problemas

La VM no aparece en la asignación

Si la instalación del agente de dependencia se completó correctamente, pero no ve el equipo en el mapa, siga estos pasos para diagnosticar el problema.

  1. ¿Se ha instalado Dependency Agent correctamente? Para validarlo, compruebe si el servicio está instalado y se ejecuta.

    Windows: Busque el servicio llamado "Microsoft Dependency Agent".

    Linux: Busque el proceso en ejecución "microsoft-dependency-agent".

  2. ¿Está en el plan de tarifa gratuito de Log Analytics ? El plan gratuito permite hasta cinco equipos únicos. Ningún equipo posterior aparecerá en la asignación, incluso si los cinco anteriores ya no envían datos.

  3. ¿El equipo envía datos de registro y de rendimiento a los registros de Azure Monitor? Realice la consulta siguiente para el equipo:

    Usage | where Computer == "computer-name" | summarize sum(Quantity), any(QuantityUnit) by DataType
    

    ¿Devolvió uno o más resultados? ¿Son los datos recientes? Si es así, el agente de Log Analytics funciona correctamente y se comunica con el servicio. Si no es así, compruebe el agente en el servidor: Log Analytics agent for Windows troubleshooting (Cómo solucionar problemas relacionados con el agente de Windows de Log Analytics) o Cómo solucionar problemas relacionados con el agente de Linux de Log Analytics.

El equipo aparece en la asignación, pero no tiene ningún proceso

Si ve el servidor en el mapa, pero no tienen datos de procesos ni de conexión, eso indica que Dependency Agent está instalado y se está ejecutando, pero el controlador del kernel no se cargó.

Revise el archivo C:\Program Files\Microsoft Dependency Agent\logs\wrapper.log (Windows) o el archivo /var/opt/microsoft/dependency-agent/log/service.log (Linux). Las últimas líneas del archivo deben indicar por qué no se cargó el kernel. Por ejemplo, es posible que el kernel no sea compatible con Linux si actualizó el kernel.

Pasos siguientes

Ahora que la supervisión está habilitada para las máquinas virtuales, esta información está disponible para analizarse con VM Insights.