Introdução
Em meu papel como especialista em observabilidade e monitoramento de sistemas, enfrento constantemente o desafio de prover soluções eficazes que atendam às necessidades de meus clientes. Diante dessa missão, deparei-me com a oportunidade de integrar as informações do VMWare com as informações de monitoramento realizadas pelo Cisco AppDynamics. Neste artigo, detalho o passo a passo da minha experiência implementando essa solução nos sistemas dos clientes.
Passo 1: Compreendendo a Necessidade
Primeiramente, analisei a demanda dos clientes por um monitoramento mais granular que pudesse vincular a performance das aplicações com a infraestrutura virtual e física da VMware. O agente Machine Agent nos permite execuções de extensões, desde forma, utilizei a extensão chamada "AppDynamics VMware Tag Extension" que cria tags automaticamente nos objetos do Cisco Appdynamics, por exemplo nos
Servers, Applications, Tiers e Nodes com as informações detalhadas da infraestrutura virtual e física do VMWare, facilitando assim a correlação entre a performance das aplicações e a infraestrutura virtual/física.A segunda funcionalidade da extensão é indiciar através de tags se houveram migrações nas
virtual machines (vMotion), caso tenha ocorrido, também serão criadas tags com as informações dos servidores (host) de origem e destino, além da data e hora que ocorreu.Por fim, a extensão também é capaz de publicar métricas sobre o consumo dos servidores (hosts). Assim como outras métricas no Cisco AppDynamics, estas também se beneficiam do recurso de linha de base dinâmica, proporcionando uma análise mais precisa e adaptativa do comportamento dos servidores ao longo do tempo.
Passo 2: Preparando o Terreno
Para garantir uma implementação bem-sucedida, precisamos assegurar todos os pré-requisitos:
- Uma conta ativa no AppDynamics;
- Usuário com permissão de leitura para acesso às APIs da VMware;
- O servidor que executa o Machine Agent deve ter pelo menos 4 vCPUs e 8 GB de RAM;
- Java 17 ou superior;
- Maven
Passo 3: Clonando o Repositório
Existem duas maneiras de se proceder com a execução da extensão: a primeira envolve clonar o repositório e compilar o código-fonte localmente; a segunda opção permite simplesmente realizar o download da extensão já compilada e pronta para uso.
Para clonar o repositório, abra o terminal no seu ambiente e execute o seguinte comando para clonar o repositório da extensão:
git clone https://github.com/FHDumont/appdynamics-vmware-tag-extension.gitPara fazer o download da extensão já compilada, acesse o link https://github.com/FHDumont/appdynamics-vmware-tag-extension/releases e selecione o arquivo ZIP da versão mais recente.
Passo 4: Compilando a Extensão
Se você optou pela primeira opção do passo 3, então utilize o Maven para compilar o projeto e gerar o artefato final. No diretório do projeto, execute o seguinte comando:
mvn clean installPasso 5: Instalando a Extensão no AppDynamics
Com a extensão compilada, descompacte o arquivo VMWareTagExtension.zip criado no diretório target ou utilize a extensão já compilada e copiada via download do passo 3 no diretório
monitors do seu Machine Agent, o resultado deve ser parecido com da imagem abaixo:
Passo 6: Configurando a extensão
Navegue até o diretório da extensão e abra o arquivo
config.yml. Aqui, você deverá inserir as informações de configurações necessárias, como as credenciais de acesso ao seu ambiente VMware e AppDynamics, a imagem abaixo é um exemplo da configuração esperada:
As propriedades
clientId e clientSecret não correspondem às credenciais de login do Cisco AppDynamics, mas sim a configurações de tokens de autenticação utilizados para realizar chamadas de API. Eles são criados especificamente para serem usados em conjunto com a extensão e são essenciais para garantir a comunicação segura com o AppDynamics por meio de sua API.Caso você ainda não tenha configurado um cliente de API, é necessário seguir as instruções da documentação oficial para criar seu próprio
clientId e clientSecret. Aqui está como você pode proceder: documentação Oficial para criar tokens de API.Lembre-se de que essas credenciais são sensíveis e devem ser tratadas como qualquer outra informação de segurança. Não compartilhe o seu
clientId e clientSecret publicamente ou com terceiros não autorizados.Quando a propriedade
publishMetrics é configurada como true, isso indica que a extensão irá publicar métricas relativas aos servidores físicos (hosts), fornecendo dados detalhados sobre o desempenho e o uso de recursos desses servidores no ambiente monitorado.Passo 7: Conferindo o resultado
O período necessário para efetuar a correlação entre os hosts e os servidores monitorados pelo Machine Agent é variável e será influenciado pelo volume total de hosts, máquinas virtuais e servidores sob monitoramento. Dependendo da complexidade e do tamanho do ambiente, esse processo pode ser bastante rápido, tomando apenas alguns segundos, ou pode exigir um tempo maior, estendendo-se por vários minutos.
Não é preciso tomar medidas adicionais para obter os resultados; basta aguardar a conclusão do processo. Uma vez finalizado, as informações correlacionadas estarão disponíveis e poderão ser verificadas por meio das visualizações fornecidas, conforme ilustrado nas imagens a seguir.
As seguintes tags serão criadas nos servers e nodes:
- ESX Cluster
- ESX Datacenter
- ESX Host Name
- ESX Overall CPU Usage %
- ESX Overall Memory Usage %
- ESX Total Virtual Machine
- ESX Had Migration Last 24h
- ESX Last Migration Created Date
- ESX Last Migration From
- ESX Last Migration To
- ESX Last Update
As seguintes tags serão nas applications e tiers:
- ESX Had Migration Last 24h
- ESX Last Update
A tag "ESX Last Update" indica a última vez que a extensão atualizou os valores das tags.
As métricas a seguir serão geradas para cada servidor físico detectado e publicadas na controller configurada no Machine Agent. Essas métricas serão organizadas numa estrutura hierárquica que reflete a disposição do datacenter, do cluster e do próprio host:
Conclusão
A extensão AppDynamics VMware Tag Extension é uma ferramenta poderosa para quem utiliza a combinação de AppDynamics e VMware, permitindo uma visão integrada e detalhada do desempenho de aplicações e infraestrutura virtual. Seguindo os passos acima, você será capaz de instalar e configurar a extensão com sucesso, aprimorando significativamente o monitoramento do seu ambiente.
Lembre-se de consultar a documentação oficial e o repositório no GitHub para informações atualizadas e detalhadas sobre a configuração e possíveis problemas durante a instalação. Com a extensão configurada, sua equipe de operações de TI estará melhor equipada para detectar e resolver problemas de desempenho, garantindo um serviço de qualidade para os usuários finais.
Referências
Link oficial da extension
Linkedin
Site oficial do autor
