Ativar insights em VM para uma máquina virtual híbridaEnable VM insights for a hybrid virtual machine

Este artigo descreve como permitir insights de VM para uma máquina virtual fora de Azure, incluindo no local e outros ambientes em nuvem.This article describes how to enable VM insights for a virtual machine outside of Azure, including on-premises and other cloud environments.

Importante

O método recomendado para permitir VMs híbridos é primeiro permitir o Arco Azure para servidores para que os VMs possam ser ativados para insights VM usando processos semelhantes aos VMs 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. Este artigo descreve como embarcar VMs híbridos se optar por não utilizar o Arco Azure.This article describes how to onboard hybrid VMs if you choose not to use Azure Arc.

Pré-requisitosPrerequisites

Descrição geralOverview

Máquinas virtuais fora de Azure requerem o mesmo agente log analytics e agente de dependência que são usados para VMs Azure.Virtual machines outside of Azure require the same Log Analytics agent and Dependency agent that are used for Azure VMs. Uma vez que não é possível utilizar extensões VM para instalar os agentes, deve instalá-los manualmente no sistema operativo do hóspede ou instalá-los através de outro 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.

Consulte os computadores Do Windows ao Azure Monitor ou ligue os computadores Linux ao Azure Monitor para obter mais informações sobre a implementação do agente Log Analytics.See Connect Windows computers to Azure Monitor or Connect Linux computers to Azure Monitor for details on deploying the Log Analytics agent. Os detalhes para o agente de Dependência são fornecidos neste artigo.Details for the Dependency agent are provided in this article.

Requisitos de firewallFirewall requirements

Os requisitos de firewall para o agente Log Analytics são fornecidos na visão geral do agente Log Analytics.Firewall requirements for the Log Analytics agent are provided in Log Analytics agent overview. O agente VM insights Map Dependency não transmite quaisquer dados em si, e não requer alterações em firewalls ou portas.The VM insights Map Dependency agent doesn't transmit any data itself, and it doesn't require any changes to firewalls or ports. Os dados do Mapa são sempre transmitidos pelo agente Log Analytics ao serviço Azure Monitor, quer diretamente quer através do gateway da Suite de Gestão de Operações, se as suas políticas de segurança de TI não permitirem que os computadores da rede se conectem à 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.

Agente de DependênciaDependency agent

Nota

As seguintes informações descritas nesta secção também são aplicáveis à solução Mapa de Serviço.The following information described in this section is also applicable to the Service Map solution.

Você pode baixar o agente Desafiada a partir destes locais:You can download the Dependency agent from these locations:

FicheiroFile SOOS VersãoVersion SHA-256SHA-256
InstallDependencyAgent-Windows.exeInstallDependencyAgent-Windows.exe WindowsWindows 9.10.7.127109.10.7.12710 CA29CC328F91D7301FD0360F4F56F78275545BB8856779899CA85E96F0CA29CC328F991D7301FD0360F4F56DF78275545BB8CDA853679899CA885E96F0
InstallDependencyAgent-Linux64.binInstallDependencyAgent-Linux64.bin LinuxLinux 9.10.7.127109.10.7.12710 98380DBEB2E2A5848F2202BC2422C68B20B62090C1BFC1DECAB37ED5451ED8C98380DBEB2E2A5848F2202BC22422C68B20B62090C1BFC1DECAB37ED5451ED8C

Instale o agente de dependência no WindowsInstall the Dependency agent on Windows

Pode instalar manualmente o agente Dependency nos computadores Windows, executando InstallDependencyAgent-Windows.exe .You can install the Dependency agent manually on Windows computers by running InstallDependencyAgent-Windows.exe. Se executar este ficheiro executável sem opções, inicia um assistente de configuração que pode seguir para instalar o agente interativamente.If you run this executable file without any options, it starts a setup wizard that you can follow to install the agent interactively. Exige que os privilégios do Administrador no so convidado instale ou desinstale o agente.You require Administrator privileges on the guest OS to install or uninstall the agent.

A tabela seguinte realça os parâmetros suportados pela configuração do agente a partir da linha de comando.The following table highlights the parameters that are supported by setup for the agent from the command line.

ParâmetroParameter DescriçãoDescription
/?/? Devolve uma lista das opções de linha de comando.Returns a list of the command-line options.
/S/S Executa uma instalação silenciosa sem interação do utilizador.Performs a silent installation with no user interaction.

Por exemplo, para executar o programa de instalação com o /? parâmetro, introduzaInstallDependencyAgent-Windows.exe /?. .For example, to run the installation program with the /? parameter, enter InstallDependencyAgent-Windows.exe /?.

Os ficheiros do agente de dependência do Windows são instalados em C:\Program Files\Microsoft Dependency Agent por padrão.Files for the Windows Dependency agent are installed in C:\Program Files\Microsoft Dependency Agent by default. Se o agente Desasusiting inificado após a configuração terminar, verifique se os registos são informativo sobre erros.If the Dependency agent fails to start after setup is finished, check the logs for detailed error information. O diretório de registos é %Programfiles%\Microsoft Dependency Agent\logs.The log directory is %Programfiles%\Microsoft Dependency Agent\logs.

Script do PowerShellPowerShell script

Utilize o seguinte script PowerShell para descarregar e instalar o 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

Instale o agente de dependência no LinuxInstall the Dependency agent on Linux

O agente Dependency é instalado em servidores Linux da InstallDependencyAgent-Linux64.bin, um script de concha com um binário auto-extrator.The Dependency agent is installed on Linux servers from InstallDependencyAgent-Linux64.bin, a shell script with a self-extracting binary. Pode executar o ficheiro utilizando sh ou adicionar permissões de execução ao próprio ficheiro.You can run the file by using sh or add execute permissions to the file itself.

Nota

Para instalar ou configurar o agente é preciso acesso à raiz.Root access is required to install or configure the agent.

ParâmetroParameter DescriçãoDescription
- ajudar-help Obter uma lista das opções da linha de comandos.Get a list of the command-line options.
-s-s Realizar uma instalação automática sem que seja solicitada a interação do utilizador.Perform a silent installation with no user prompts.
--verificar--check Verifique as permissões e o sistema operativo, mas não instale o agente.Check permissions and the operating system, but don't install the agent.

Por exemplo, para executar o programa de instalação com o -help parâmetro, insira instalar DependênciaAgent-Linux64.bin -help.For example, to run the installation program with the -help parameter, enter InstallDependencyAgent-Linux64.bin -help. Instale o agente de dependência Linux como raiz executando o comando sh InstallDependencyAgent-Linux64.bin .Install the Linux Dependency agent as root by running the command sh InstallDependencyAgent-Linux64.bin.

Se o agente de dependência não arrancar, verifique se os registos são informativo de erro.If the Dependency agent fails to start, check the logs for detailed error information. Nos agentes Linux, o diretório de registos é /var/opt/microsoft/dependency-agent/log.On Linux agents, the log directory is /var/opt/microsoft/dependency-agent/log.

Os ficheiros do agente de dependência são colocados nos seguintes diretórios:Files for the Dependency agent are placed in the following directories:

FicheirosFiles LocalizaçãoLocation
Ficheiros principaisCore files /opt/microsoft/dependency-agent/opt/microsoft/dependency-agent
Ficheiros de registoLog files /var/opt/microsoft/dependency-agent/log/var/opt/microsoft/dependency-agent/log
Ficheiros de configuraçãoConfig files /etc/opt/microsoft/dependency-agent/config/etc/opt/microsoft/dependency-agent/config
Ficheiros executáveis de serviçoService 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
Ficheiros de armazenamento bináriosBinary storage files /var/opt/microsoft/dependency-agent/storage/var/opt/microsoft/dependency-agent/storage

Script de conchaShell script

Utilize o seguinte script de amostra para descarregar e instalar o 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

Configuração do Estado PretendidoDesired State Configuration

Para implementar o agente de dependência utilizando a Configuração do Estado Desejado (DSC), pode utilizar o módulo xPSDesiredStateConfiguration com o seguinte código de exemplo: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"
        }
    }
}

Resolução de problemasTroubleshooting

VM não aparece no mapaVM doesn't appear on the map

Se a instalação do seu agente de dependência tiver sido bem sucedida, mas não vir o computador no mapa, diagnostice o problema seguindo estes passos.If your Dependency agent installation succeeded, but you don't see your computer on the map, diagnose the problem by following these steps.

  1. O Dependency Agent foi instalado com sucesso?Is the Dependency agent installed successfully? Pode verificar esta situação ao confirmar que o serviço está instalado e em execução.You can validate this by checking to see if the service is installed and running.

    Windows: Procure o serviço chamado "Microsoft Dependency agent".Windows: Look for the service named "Microsoft Dependency agent."

    Linux: Procure o processo de execução "microsoft-dependency-agent".Linux: Look for the running process "microsoft-dependency-agent."

  2. Está no nível de preços gratuitos do Log Analytics?Are you on the Free pricing tier of Log Analytics? O plano Free permite até cinco computadores únicos.The Free plan allows for up to five unique computers. Quaisquer computadores subsequentes não aparecerão no mapa, mesmo que os cinco anteriores já não estejam a enviar dados.Any subsequent computers won't show up on the map, even if the prior five are no longer sending data.

  3. O computador está a enviar registos e dados perf para registos do Monitor Azure?Is the computer sending log and perf data to Azure Monitor Logs? Execute a seguinte consulta para o seu computador:Perform the following query for your computer:

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

    Devolveu um ou mais resultados?Did it return one or more results? Os dados são recentes?Is the data recent? Em caso afirmativo, o seu agente Log Analytics está a funcionar corretamente e a comunicar com o serviço.If so, your Log Analytics agent is operating correctly and communicating with the service. Caso contrário, verifique o agente no seu servidor: Registar o agente Analytics para a resolução de problemas do Windows ou para o agente Desapeito de Registo para a resolução de problemas do Linux.If not, check the agent on your server: Log Analytics agent for Windows troubleshooting or Log Analytics agent for Linux troubleshooting.

Computador aparece no mapa mas não tem processosComputer appears on the map but has no processes

Se vir o seu servidor no mapa, mas não tiver dados de processo ou ligação, isso indica que o agente Dependency está instalado e a funcionar, mas o controlador de kernel não carregou.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.

Verifique o ficheiro C:\Programas\Microsoft Dependency Agent\logs\wrapper.log (Windows) ou o ficheiro /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). As últimas linhas do ficheiro devem indicar o motivo pelo qual kernel não carregou.The last lines of the file should indicate why the kernel didn't load. Por exemplo, o kernel poderá não ser suportado pelo Linux se tiver atualizado o kernel.For example, the kernel might not be supported on Linux if you updated your kernel.

Passos seguintesNext steps

Agora que a monitorização está ativada para as suas máquinas virtuais, esta informação está disponível para análise com insights VM.Now that monitoring is enabled for your virtual machines, this information is available for analysis with VM insights.