Ir para o conteúdo principal

APM ELK - Configuração dos serviços apm-server e metricbeat

Data: 17/09/21

Autores:

  1. Lucas Gabriel de Lima Gonçalves (Assessor)
  2. Michel Farias Ferreira (Assessor)

1. Objetivo

Estudo para analisar e definir a melhor configuração dos serviços apm-server e o módulo metricbeat na APM ELK para o ambiente da SETIC


2. Introdução

Presente à necessidade  da disponibilização da ferramenta ELK se faz necessário realizar o estudo para identificar qual a melhor configuração se adequa para verificar se a solução pode atender a SETIC nas questões de Monitoramento, Observabilidade e Telemetria.

3. Desenvolvimento

3.1 CONFIGURAÇÃO DOS SERVIÇOS apm-server
O servidor do APM funciona como um processador de dados, encaminhando os dados do APM dos agentes do APM para a Elasticsearch.

Foi criado um projeto no openshift em docker nomeado como “DOCKER ELK” no projeto foi necessário subir os serviços (elasticsearch; kibana; logstash). Além do APM.

As imagens do Docker para o APM Server estão disponíveis no registro do Elastic Docker. A imagem de base é centos: 7 

O Serviço apm foi disponibilizado com as seguintes configurações.:

imagem: registry.okd.local/apm/apm-server:7.14.0

 

Variáveis:

3.2 Instalação do módulo metricbeat no contêiner

O atual status da instalação do módulo metricbeat está (em andamento), na atual sprint de número 45 não foi possível concluir toda a instalação e configuração. Abaixo segue o tutorial orientado pela documentação e analisado pelo time.

Para a instalação é necessário efetuar o download e a instalação do metricbeat no contêiner do kibana

 

curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-7.14.0-amd64.deb

 

sudo dpkg -i metricbeat-7.14.0-amd64.deb

 

Edite as configurações do yml: sudo su vim /etc/metricbeat/metricbeat.yml

Em “elasticsearch output”, descomente e defina os parâmetros de (username; password)

Salve e saia do arquivo.

 

Habilite o modo docker com o comando:

sudo metricbeat modules enable docker

 

Após habilitado configure o módulo para fazer a coleta das métricas:

/etc/metricbeat/modules.d/docker.yml

 

Altere a configuração dos metricsets descomentando os que serão utilizados para coletar dados.

 

Reinicie o serviço metricbeat

sudo service metricbeat restart

 

Verifique o log no terminal e faça um teste de conexão no kibana para verificar se os dados estão sendo coletados.

Caso você receba a mensagem de dados não recebidos, repita o processo.

Após a configuração, crie um dashboard para visualizar os dados recebidos.
4. Conclusão

Tal estudo tem o objetivo de orientar na configuração do APM. É um estudo objetivo com configurações testadas e validadas

5. Referências 

Tutorial para adicionar metricbeat docker

https://kibana.okd.local/app/home#/tutorial/dockerMetrics

 

Configurar módulo metricbeat

https://www.elastic.co/guide/en/beats/metricbeat/current/configuration-metricbeat.html

 

Configurando e executando o servidor APM

https://www.elastic.co/guide/en/apm/server/6.6/setting-up-and-running.html