Agente de dependência

O Agente de Dependência coleta dados sobre processos em execução na máquina virtual e suas dependências de processos externos. As atualizações incluem correções de bugs ou suporte a novos recursos ou funcionalidades. Este artigo descreve os requisitos do Agente de Dependência e como atualizá-lo manualmente ou por meio de automação.

Nota

O Agente de Dependência envia dados de pulsação para a tabela InsightsMetrics, para a qual você incorre em encargos de ingestão de dados. Esse comportamento é diferente do Azure Monitor Agent, que envia dados de integridade do agente para a tabela Heartbeat que é livre de cobranças de coleta de dados.

Requisitos do Agente de Dependência

  • O agente do Azure Monitor deve ser instalado na mesma máquina.
  • Coleta dados usando um serviço de espaço do usuário e um driver de kernel no Windows e Linux.
  • Suporta as mesmas versões do Windows que o Azure Monitor Agent suporta, exceto Windows Server 2008 SP2 e Azure Stack HCI. Para Linux, consulte Suporte Linux do Agente de Dependência.

Considerações sobre Linux

Considere o seguinte antes de instalar o Dependency agent for VM Insights em uma máquina Linux:

  • Apenas as versões de kernel padrão e SMP Linux são suportadas.
  • Versões não padrão do kernel, como extensão de endereço físico (PAE) e Xen, não são suportadas para nenhuma distribuição Linux. Por exemplo, um sistema com a cadeia de caracteres de lançamento 2.6.16.21-0.8-xen não é suportado.
  • Kernels personalizados, incluindo recompilações de kernels padrão, não são suportados.
  • Para distros Debian diferentes da versão 9.4, o recurso Mapa não é suportado. O recurso Desempenho está disponível somente no menu Azure Monitor. Ele não está disponível diretamente no painel esquerdo da VM do Azure.
  • O kernel CentOSPlus é suportado.
  • A instalação do agente de dependência contamina o kernel Linux e você pode perder o suporte da sua distribuição Linux até que a máquina seja redefinida.

O kernel Linux deve ser corrigido para as vulnerabilidades Spectre e Meltdown. Para obter mais informações, consulte seu fornecedor de distribuição Linux. Execute o seguinte comando para verificar a disponibilidade se o Spectre/Meltdown tiver sido atenuado:

$ grep . /sys/devices/system/cpu/vulnerabilities/*

A saída para este comando é semelhante à seguinte e especifica se uma máquina é vulnerável a qualquer um dos problemas. Se esses arquivos estiverem faltando, a máquina não será corrigida.

/sys/devices/system/cpu/vulnerabilities/meltdown:Mitigation: PTI
/sys/devices/system/cpu/vulnerabilities/spectre_v1:Vulnerable
/sys/devices/system/cpu/vulnerabilities/spectre_v2:Vulnerable: Minimal generic ASM retpoline

Instalar ou atualizar o Agente de Dependência

Nota

O Agente de Dependência é instalado automaticamente quando o VM Insights está habilitado em uma máquina para dados de processo e conexão. Se o VM Insights estiver habilitado exclusivamente para dados de desempenho, o Agente de Dependência não será instalado.

Você pode atualizar o Agente de Dependência para Windows e Linux manual ou automaticamente, dependendo do cenário de implantação e do ambiente em que a máquina está sendo executada, usando estes métodos:

Environment Método de instalação Método de atualização
VM do Azure Extensão de VM do Agente de Dependência para Windows e Linux O agente é atualizado automaticamente por padrão, a menos que você configure seu modelo do Azure Resource Manager para desativar definindo a propriedade autoUpgradeMinorVersion como false. A atualização para a versão secundária onde a atualização automática está desativada e uma atualização da versão principal seguem o mesmo método - desinstalar e reinstalar a extensão.
Imagens personalizadas da VM do Azure Instalação manual do Dependency Agent para Windows/Linux A atualização de VMs para a versão mais recente do agente precisa ser executada a partir da linha de comando que executa o pacote do instalador do Windows ou o pacote de shell script instalável e de extração automática do Linux.
VMs que não são do Azure Instalação manual do Dependency Agent para Windows/Linux A atualização de VMs para a versão mais recente do agente precisa ser executada a partir da linha de comando que executa o pacote do instalador do Windows ou o pacote de shell script instalável e de extração automática do Linux.

Instalar ou atualizar manualmente o Agente de Dependência no Windows

Atualize o agente em uma VM do Windows a partir do prompt de comando, com um script ou outra solução de automação ou usando o Assistente de Instalação do InstallDependencyAgent-Windows.exe.

Pré-requisitos

Usando o Assistente de configuração

  1. Inicie sessão no computador com uma conta que tenha direitos administrativos.

  2. Execute InstallDependencyAgent-Windows.exe para iniciar o Assistente de configuração.

  3. Siga o assistente de Configuração do Agente de Dependência para desinstalar a versão anterior do Agente de Dependência e, em seguida, instale a versão mais recente.

A partir da linha de comando

  1. Entre no computador usando uma conta com direitos administrativos.

  2. Execute o seguinte comando:

    InstallDependencyAgent-Windows.exe /S /RebootMode=manual
    

    O /RebootMode=manual parâmetro impede que a atualização reinicialize automaticamente a máquina se alguns processos estiverem usando arquivos da versão anterior e tiverem um bloqueio neles.

  3. Para confirmar que a atualização foi bem-sucedida, verifique as informações detalhadas de install.log configuração. O diretório de log é %Programfiles%\Microsoft Dependency Agent\logs.

Instalar ou atualizar manualmente o Agente de Dependência no Linux

A atualização de versões anteriores do Dependency Agent no Linux é suportada e executada seguindo o mesmo comando de uma nova instalação.

Pré-requisitos

curl -L -o DependencyAgent-Linux64.bin https://aka.ms/dependencyagentlinux

Nota

O Curl não define automaticamente as permissões de execução. Você precisa configurá-los manualmente usando chmod:

chmod +x DependencyAgent-Linux64.bin

A partir da linha de comando

  1. Entre no computador com uma conta de usuário que tenha privilégios sudo para executar comandos como root.

  2. Execute o seguinte comando:

    sudo <path>/InstallDependencyAgent-Linux64.bin
    

Se o Agente de Dependência falhar ao iniciar, verifique os logs para obter informações detalhadas sobre erros. Em agentes Linux, o diretório de log é /var/opt/microsoft/dependency-agent/log.

Desinstalar o Agente de Dependência

Nota

Se o Agente de Dependência tiver sido instalado manualmente, ele não será exibido no portal do Azure e precisará ser desinstalado manualmente. Ele só será exibido se foi instalado por meio do portal do Azure, PowerShell, implantação de modelo ARM ou política do Azure.

  1. No menu Máquinas Virtuais no portal do Azure, selecione sua máquina virtual.

  2. Selecione Extensões + aplicativos>DependencyAgentWindows ou DependencyAgentLinux>Desinstalar.

    Captura de tela mostrando a tela Extensões e aplicativos para uma máquina virtual.

Desinstalar manualmente o Agente de Dependência no Windows

Método 1: No Windows, vá para Adicionar e remover programas, encontre o Microsoft Dependency Agent, clique nas reticências para abrir o menu de contexto e selecione Desinstalar.

Método 2: Use o desinstalador localizado na pasta Microsoft Dependency Agent, por exemplo, C:\Program Files\Microsoft Dependency Agent"\Uninstall_v.w.x.y.exe (onde v.w.x.y é o número da versão).

Desinstale manualmente o Dependency Agent no Linux

  1. Entre no computador com uma conta de usuário que tenha privilégios sudo para executar comandos como root.

  2. Execute o seguinte comando:

    sudo /opt/microsoft/dependency-agent/uninstall -s
    

Suporte ao Dependency Agent Linux

Como o Dependency Agent funciona no nível do kernel, o suporte também depende da versão do kernel. A partir da versão 9.10.* do Dependency Agent, o agente suporta kernels *. A tabela a seguir lista a versão principal e secundária do sistema operacional Linux e as versões do kernel suportadas para o Dependency Agent.

Nota

Com o agente de dependência 9.10.15 e superior, a instalação não é bloqueada para versões de kernel não suportadas, mas o agente será executado em modo degradado. Nesse modo, os dados de conexão e porta armazenados nas tabelas VMConnection e VMBoundport não são coletados. A tabela VMProcess pode ter alguns dados, mas será mínima.

Distribuição Versão do Sistema Operativo Versão de kernel
Red Hat Linux 8 8.6 4.18.0-372.*el8.x86_64, 4.18.0-372.*el8_6.x86_64
8.5 4.18.0-348.*el8_5.x86_644.18.0-348.*el8.x86_64
8,4 4.18.0-305.*el8.x86_64, 4.18.0-305.*el8_4.x86_64
8.3 4.18.0-240.*el8_3.x86_64
8.2 4.18.0-193.*el8_2.x86_64
8.1 4.18.0-147.*el8_1.x86_64
8.0 4.18.0-80.*el8.x86_64
4.18.0-80.*el8_0.x86_64
Red Hat Linux 7 7,9 3.10.0-1160
7.8 3.10.0-1136
7.7 3.10.0-1062
7.6 3.10.0-957
7.5 3.10.0-862
7.4 3.10.0-693
Red Hat Linux 6 6.10 2.6.32-754
6.9 2.6.32-696
CentOS Linux 8 8.6 4.18.0-372.*el8.x86_64, 4.18.0-372.*el8_6.x86_64
8.5 4.18.0-348.*el8_5.x86_644.18.0-348.*el8.x86_64
8,4 4.18.0-305.*el8.x86_64, 4.18.0-305.*el8_4.x86_64
8.3 4.18.0-240.*el8_3.x86_64
8.2 4.18.0-193.*el8_2.x86_64
8.1 4.18.0-147.*el8_1.x86_64
8.0 4.18.0-80.*el8.x86_64
4.18.0-80.*el8_0.x86_64
CentOS Linux 7 7,9 3.10.0-1160
7.8 3.10.0-1136
7.7 3.10.0-1062
CentOS Linux 6 6.10 2.6.32-754.3.5
2.6.32-696.30.1
6.9 2.6.32-696.30.1
2.6.32-696.18.7
Ubuntu Server 20.04 5.8
5.4*
18.04 5.3.0-1020
5.0 (inclui kernel ajustado ao Azure)
4.18*
4.15*
16.04.3 4.15.*
16.04 4.13.*
4.11.*
4.10.*
4.8.*
4.4.*
14.04 3.13.*-genérico
4.4.*-genérico
Servidor SUSE Linux 12 Enterprise 12 SP5 4.12.14-122.*-default, 4.12.14-16.*-azure
12 SP4 4.12.* (inclui kernel ajustado ao Azure)
12.º SP3 4.4.*
12 SP2 4.4.*
Servidor SUSE Linux 15 Enterprise 15 SP1 4.12.14-197.*-default, 4.12.14-8.*-azure
15 4.12.14-150.*-padrão
Debian 9 4,9

Nota

O agente de dependência não é suportado para Máquinas Virtuais do Azure com processadores baseados em ARM Ampere Altra.

Próximos passos

Se você quiser parar de monitorar suas VMs por um tempo ou remover totalmente o VM Insights, consulte Desabilitar o monitoramento de suas VMs no VM Insights.