Habilitación de VM Insights para una máquina virtual híbridaEnable VM insights for a hybrid virtual machine

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.This article describes how to enable VM insights for a virtual machine outside of Azure, including on-premises and other cloud environments.

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.The recommended method of enabling hybrid VMs is first enabling Azure Arc for servers so that the VMs can be enabled for VM insights using processes similar to Azure VMs. En este artículo se describe cómo incorporar máquinas virtuales híbridas si decide no usar Azure Arc.This article describes how to onboard hybrid VMs if you choose not to use Azure Arc.

Requisitos previosPrerequisites

Información generalOverview

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.Virtual machines outside of Azure require the same Log Analytics agent and Dependency agent that are used for Azure VMs. 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.Since you can't use VM extensions to install the agents though, you must manually install them in the guest operating system or have them installed through some other method.

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.See Connect Windows computers to Azure Monitor or Connect Linux computers to Azure Monitor for details on deploying the Log Analytics agent. En este artículo se proporcionan detalles sobre Dependency Agent.Details for the Dependency agent are provided in this article.

Requisitos de firewallFirewall requirements

Los requisitos de firewall para el agente de Log Analytics se proporcionan en Introducción al agente de Log Analytics.Firewall requirements for the Log Analytics agent are provided in Log Analytics agent overview. 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.The VM insights Map Dependency agent doesn't transmit any data itself, and it doesn't require any changes to firewalls or ports. 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.The Map data is always transmitted by the Log Analytics agent to the Azure Monitor service, either directly or through the Operations Management Suite gateway if your IT security policies don't allow computers on the network to connect to the internet.

Dependency AgentDependency agent

Nota

La siguiente información que se describe en esta sección también se aplica a la solución Service Map.The following information described in this section is also applicable to the Service Map solution.

Puede descargar Dependency Agent desde estas ubicaciones:You can download the Dependency agent from these locations:

ArchivoFile SOOS VersiónVersion SHA-256SHA-256
InstallDependencyAgent-Windows.exeInstallDependencyAgent-Windows.exe WindowsWindows 9.10.7.127109.10.7.12710 CA29CC328F991D7301FD0360F4F56DF78275545BB8CDA853679899CA885E96F0CA29CC328F991D7301FD0360F4F56DF78275545BB8CDA853679899CA885E96F0
InstallDependencyAgent-Linux64.binInstallDependencyAgent-Linux64.bin LinuxLinux 9.10.7.127109.10.7.12710 98380DBEB2E2A5848F2202BC22422C68B20B62090C1BFC1DECAB37ED5451ED8C98380DBEB2E2A5848F2202BC22422C68B20B62090C1BFC1DECAB37ED5451ED8C

Instalar Dependency Agent en WindowsInstall the Dependency agent on Windows

Para instalar Dependency Agent manualmente en equipos Windows, puede ejecutar InstallDependencyAgent-Windows.exe.You can install the Dependency agent manually on Windows computers by running 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.If you run this executable file without any options, it starts a setup wizard that you can follow to install the agent interactively. Necesita privilegios de administrador en el sistema operativo invitado para instalar o desinstalar el agente.You require Administrator privileges on the guest OS to install or uninstall the agent.

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.The following table highlights the parameters that are supported by setup for the agent from the command line.

ParámetroParameter DescripciónDescription
/?/? Devuelve una lista de las opciones de la línea de comandos.Returns a list of the command-line options.
/S/S Realiza una instalación silenciosa sin interacción del usuario.Performs a silent installation with no user interaction.

Por ejemplo, para ejecutar el programa de instalación con el parámetro /?, escriba InstallDependencyAgent-Windows.exe /? .For example, to run the installation program with the /? parameter, enter InstallDependencyAgent-Windows.exe /?.

Los archivos de Dependency Agent para Windows se instalan en C:\Archivos de programa\Microsoft Dependency Agent de manera predeterminada.Files for the Windows Dependency agent are installed in C:\Program Files\Microsoft Dependency Agent by default. Si Dependency Agent no se inicia una vez completada la instalación, compruebe los registros para obtener información detallada del error.If the Dependency agent fails to start after setup is finished, check the logs for detailed error information. El directorio de registro es %Programfiles%\Microsoft Dependency Agent\logs.The log directory is %Programfiles%\Microsoft Dependency Agent\logs.

Script de PowerShellPowerShell script

Use el siguiente script de PowerShell de ejemplo para descargar e instalar el agente:Use the following sample PowerShell script to download and install the agent:

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

.\InstallDependencyAgent-Windows.exe /S

Instalación de Dependency Agent en LinuxInstall the Dependency agent on Linux

Dependency Agent se instala en los servidores Linux desde InstallDependencyAgent-Linux64.bin, un script de shell con un archivo binario autoextraíble.The Dependency agent is installed on Linux servers from InstallDependencyAgent-Linux64.bin, a shell script with a self-extracting binary. Puede ejecutar el archivo mediante sh o agregar permisos de ejecución al propio archivo.You can run the file by using sh or add execute permissions to the file itself.

Nota

Es necesario el acceso raíz para instalar o configurar el agente.Root access is required to install or configure the agent.

ParámetroParameter DescripciónDescription
-help-help Obtenga una lista de las opciones de la línea de comandos.Get a list of the command-line options.
-S-s Realice una instalación silenciosa sin preguntas.Perform a silent installation with no user prompts.
--check--check Compruebe los permisos y el sistema operativo, pero no instale el agente.Check permissions and the operating system, but don't install the agent.

Por ejemplo, para ejecutar el programa de instalación con el parámetro -help, escriba InstallDependencyAgent-Linux64.bin -help.For example, to run the installation program with the -help parameter, enter InstallDependencyAgent-Linux64.bin -help. Para instalar Dependency en Linux como raíz, ejecute el comando sh InstallDependencyAgent-Linux64.bin.Install the Linux Dependency agent as root by running the command sh InstallDependencyAgent-Linux64.bin.

Si Dependency Agent no se inicia, compruebe los registros para obtener información detallada del error.If the Dependency agent fails to start, check the logs for detailed error information. En los agentes de Linux, el directorio de registro es /var/opt/microsoft/dependency-agent/log.On Linux agents, the log directory is /var/opt/microsoft/dependency-agent/log.

Los archivos de Dependency Agent se colocan en los directorios siguientes:Files for the Dependency agent are placed in the following directories:

ArchivosFiles LocationLocation
Archivos principalesCore files /opt/microsoft/dependency-agent/opt/microsoft/dependency-agent
Archivos de registroLog files /var/opt/microsoft/dependency-agent/log/var/opt/microsoft/dependency-agent/log
Archivos de configuraciónConfig files /etc/opt/microsoft/dependency-agent/config/etc/opt/microsoft/dependency-agent/config
Archivos ejecutables de servicioService executable files /opt/microsoft/dependency-agent/bin/microsoft-dependency-agent/opt/microsoft/dependency-agent/bin/microsoft-dependency-agent
/opt/microsoft/dependency-agent/bin/microsoft-dependency-agent-manager/opt/microsoft/dependency-agent/bin/microsoft-dependency-agent-manager
Archivos binarios de almacenamientoBinary storage files /var/opt/microsoft/dependency-agent/storage/var/opt/microsoft/dependency-agent/storage

Script de shellShell script

Use el siguiente script de shell de ejemplo para descargar e instalar el agente:Use the following sample shell script to download and install the agent:

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

Configuración de estado deseadoDesired State Configuration

Para implementar Dependency Agent mediante Desired State Configuration (DSC), puede usar el módulo xPSDesiredStateConfiguration con el siguiente código de ejemplo:To deploy the Dependency agent using Desired State Configuration (DSC), you can use the xPSDesiredStateConfiguration module with the following example code:

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 problemasTroubleshooting

La VM no aparece en la asignaciónVM doesn't appear on the map

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.If your Dependency agent installation succeeded, but you don't see your computer on the map, diagnose the problem by following these steps.

  1. ¿Se ha instalado Dependency Agent correctamente?Is the Dependency agent installed successfully? Para validarlo, compruebe si el servicio está instalado y se ejecuta.You can validate this by checking to see if the service is installed and running.

    Windows: Busque el servicio llamado "Microsoft Dependency Agent".Windows: Look for the service named "Microsoft Dependency agent."

    Linux: Busque el proceso en ejecución "microsoft-dependency-agent".Linux: Look for the running process "microsoft-dependency-agent."

  2. ¿Está en el plan de tarifa gratuito de Log Analytics ?Are you on the Free pricing tier of Log Analytics? El plan gratuito permite hasta cinco equipos únicos.The Free plan allows for up to five unique computers. Ningún equipo posterior aparecerá en la asignación, incluso si los cinco anteriores ya no envían datos.Any subsequent computers won't show up on the map, even if the prior five are no longer sending data.

  3. ¿El equipo envía datos de registro y de rendimiento a los registros de Azure Monitor?Is the computer sending log and perf data to Azure Monitor Logs? Realice la consulta siguiente para el equipo:Perform the following query for your computer:

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

    ¿Devolvió uno o más resultados?Did it return one or more results? ¿Son los datos recientes?Is the data recent? Si es así, el agente de Log Analytics funciona correctamente y se comunica con el servicio.If so, your Log Analytics agent is operating correctly and communicating with the service. 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.If not, check the agent on your server: Log Analytics agent for Windows troubleshooting or Log Analytics agent for Linux troubleshooting.

El equipo aparece en la asignación, pero no tiene ningún procesoComputer appears on the map but has no processes

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ó.If you see your server on the map, but it has no process or connection data, that indicates that the Dependency agent is installed and running, but the kernel driver didn't load.

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).Check the C:\Program Files\Microsoft Dependency Agent\logs\wrapper.log file (Windows) or /var/opt/microsoft/dependency-agent/log/service.log file (Linux). Las últimas líneas del archivo deben indicar por qué no se cargó el kernel.The last lines of the file should indicate why the kernel didn't load. Por ejemplo, es posible que el kernel no sea compatible con Linux si actualizó el kernel.For example, the kernel might not be supported on Linux if you updated your kernel.

Pasos siguientesNext steps

Ahora que la supervisión está habilitada para las máquinas virtuales, esta información está disponible para analizarse con VM Insights.Now that monitoring is enabled for your virtual machines, this information is available for analysis with VM insights.