Como Instalar Prometheus e Node Exporter no Debian 12

Prometheus é uma plataforma de monitoramento e alerta de código aberto. Originalmente, o Prometheus foi criado pela Soundcloud em 2012. Desde então, o projeto Prometheus adotado por algumas empresas famosas se tornou um projeto maior com desenvolvedores e uma comunidade muito ativa. Em 2016, o projeto Prometheus foi graduado sob a Cloud Native Computing Foundation (CNCF).

Este guia mostrará como instalar o Prometheus e o Node Exporter no servidor Debian 12.

Pré-requisitos

Para começar, certifique-se de ter o seguinte:

• Um servidor Debian 12.
• Um usuário não-root com privilégios de administrador sudo.

Conceitos Básicos que Você Deve Conhecer

Basicamente, o Prometheus coleta dados e métricas através de endpoints HTTP de servidores-alvo e, em seguida, armazena todos os dados como séries temporais. No Prometheus, os dados de séries temporais são identificados pelo nome da métrica e pares chave/valor.

O Prometheus oferece flexibilidade através da Linguagem de Consulta Prometheus (PromQL). Você pode usar o PromQL para consultar o banco de dados de séries temporais do Prometheus.

Nos servidores-alvo, você deve instalar o aplicativo ‘exporter’ que expõe todos os dados e métricas para o Prometheus. O ‘Node Exporter’ é um exporter comumente usado para monitorar máquinas Linux.

O Node Exporter expõe métricas relacionadas ao hardware e ao kernel de máquinas Linux. Ele vem como um único arquivo binário que exporá dados e métricas para o servidor Prometheus.

Instalando Prometheus e Node Exporter

O Prometheus é um sistema de monitoramento de código aberto para coletar métricas de sistemas. O Prometheus usa um exporter para coletar métricas do sistema, como o Node Exporter, que permite coletar métricas para o seu sistema.

Na versão mais recente do Debian, tanto o Prometheus quanto o Node Exporter estão disponíveis no repositório e podem ser instalados usando o gerenciador de pacotes APT.

Primeiro, atualize e atualize o índice de pacotes do Debian executando o seguinte comando.

sudo apt update

Agora instale o Prometheus e o Node Exporter através do comando apt abaixo. O repositório Debian fornece o Prometheus 2.42.0 e o Node Exporter 1.5.0.

sudo apt install prometheus prometheus-node-exporter

Digite Y para prosseguir com a instalação.

Após a instalação ser concluída, tanto o Prometheus quanto o Node Exporter estarão em execução como um serviço systemd e habilitados automaticamente. O Prometheus terá o serviço prometheus, e o Node Exporter terá o serviço prometheus-node-exporter.

Verifique o serviço prometheus usando o seguinte comando.

sudo systemctl is-enabled prometheus  
sudo systemctl status prometheus

A saída exibida abaixo revela que o serviço prometheus está em execução e habilitado. E por padrão, ele está em execução na porta 9090.

Agora verifique o serviço prometheus-node-exporter executando o seguinte comando.

sudo systemctl is-enabled prometheus-node-exporter  
sudo systemctl status prometheus-node-exporter

A saída exibida será semelhante, revelando que o serviço prometheus-node-exporter está em execução e habilitado. A porta padrão para o Node Exporter é 9100.

Em seguida, execute o comando prometheus abaixo para verificar a versão do Prometheus.

prometheus --version

Então, verifique o caminho binário do promtool e sua versão assim. O promtool é uma linha de comando para gerenciar o sistema de monitoramento Prometheus.

which promtool  
promtool --version

Com base na saída exibida, o Prometheus e o promtool 2.42.0 estão instalados.

Por último, verifique o caminho binário do Node Exporter prometheus-node-exporter e sua versão usando o seguinte comando.

which prometheus-node-exporter  
prometheus-node-exporter --version

A saída exibida abaixo confirma que o Node Exporter 1.5 está instalado.

Configurando o Prometheus

Após instalar o Prometheus e o Node Exporter, o próximo passo é configurar o Prometheus editando o arquivo de configuração padrão prometheus.yml que está localizado no diretório de configuração do prometheus /etc/prometheus.

Abra a configuração padrão do Prometheus /etc/prometheus/prometheus.yml usando o seguinte comando do editor nano.

sudo nano /etc/prometheus/prometheus.yml

Dentro da seção scrape_configs, adicione um novo trabalho prometheus com o endpoint alvo 192.168.10.15:9090, que é o próprio servidor Prometheus.

# Uma configuração de scrape contendo exatamente um endpoint para scrape:  
# Aqui está o Prometheus em si.  
scrape_configs:  
  # O nome do trabalho é adicionado como um rótulo `job=` a qualquer série temporal raspada a partir desta configuração.  
  - job_name: "prometheus"  
  
    # metrics_path padrão é '/metrics'  
    # scheme padrão é 'http'.  
  
    static_configs:  
      - targets: ["192.168.10.15:9090"]

Salve o arquivo e saia do editor quando terminar.

Agora execute o comando systemctl abaixo para reiniciar o serviço prometheus e aplicar as alterações que você fez.

sudo systemctl restart prometheus

Agora abra seu navegador da web e visite sua instalação do Prometheus, como http://192.168.10.15:9090. Se tudo estiver funcionando corretamente, você deve ver o painel do Prometheus no seguinte comando.

Clique no menu Status > Targets para obter a lista de endpoints do sistema de monitoramento alvo. Você deve ver o endpoint prometheus com o status Up.

Por último, você também pode verificar as métricas do Prometheus visitando o caminho URL /metrics, como http://192.168.10.15:9090/metrics. Você deve ver dados de métricas semelhantes gerados pelo Prometheus.

Adicionando Node Exporter ao Prometheus

Agora que você configurou o Prometheus, o próximo passo é adicionar o Node Exporter à sua instalação do Prometheus. O Node Exporter coletará métricas do seu servidor. Para isso, você deve completar o seguinte:

• Verificando o Status do Node Exporter: Isso garantirá que o Node Exporter esteja em execução antes de prosseguir.
• Adicionando Novo Trabalho ao Prometheus: Isso mostrará como adicionar um sistema de monitoramento alvo ao Prometheus.

Agora vamos começar.

Verificando o Status do Node Exporter

Antes de adicionar o Node Exporter ao Prometheus, você deve garantir que o Node Exporter esteja em execução sem erros. Isso pode ser alcançado verificando o status do serviço prometheus-node-exporter, verificando a porta 9100 que é usada pelo Node Exporter e acessando as métricas do Node Exporter a partir do seu navegador.

Verifique o status do serviço prometheus-node-exporter executando o seguinte comando.

sudo systemctl status prometheus-node-exporter

Se estiver em execução, o status do serviço prometheus-node-exporter deve ser assim:

Agora execute o comando abaixo para garantir que a porta 9100 esteja no estado LISTEN, que o Node Exporter usa.

ss -tulpn | grep 9100

A saída a seguir confirma que o Node Exporter usa a porta 9100.

Por último, abra seu navegador da web e visite a URL das métricas do Node Exporter, como http://192.168.10.15:9100/metrics. Você deve ver as métricas geradas pelo Node Exporter como a seguinte:

Adicionando Novo Trabalho ao Prometheus

Agora que o Node Exporter está em execução, você está pronto para adicionar o Node Exporter ao Prometheus.

Abra a configuração do Prometheus /etc/prometheus/prometheus.yml usando o seguinte comando do editor nano.

sudo nano /etc/prometheus/prometheus.yml

Dentro da seção scrape_configs, adicione um novo trabalho prometheus-node-exporter com o endpoint das métricas do Node Exporter como o seguinte.

  - job_name: 'prometheus-node-exporter'  
    scrape_interval: 5s  
    static_configs:  
      - targets: ['192.168.10.15:9100']

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o seguinte comando systemctl para reiniciar o serviço prometheus e aplicar as alterações.

sudo systemctl restart prometheus

Por último, volte ao painel do Prometheus e clique no menu Status > Targets. Se tudo correr bem, você deve ver o Node Exporter no endpoint alvo.

Uso Básico do Painel do Prometheus

Nesta seção, você aprenderá a consulta básica do Prometheus e do Node Exporter, que pode ser executada a partir do painel do Prometheus.

Digite a consulta node_os_info e clique no botão Executar. A node_os_info é uma linguagem de consulta fornecida pelo Node Exporter para verificar os detalhes do sistema operacional.

Na seção Console, você deve ver informações detalhadas do host como a seguinte:

Em seguida, digite outra consulta, como node_memory_Active_bytes para verificar a memória ativa no servidor alvo. Na seção Gráfico, você deve ver resultados semelhantes como a seguinte:

Além disso, você também pode usar o PromQL (Linguagem de Consulta Prometheus) para obter dados específicos, como node_memory_Active_bytes[5] que mostrará dados dos últimos 5 minutos.

Conclusão

Para concluir, você completou a instalação do Prometheus e do Node Exporter no servidor Debian 12 passo a passo. Você instalou o Prometheus e o Node Exporter via APT do repositório oficial do Debian. Você também aprendeu o uso básico do painel do Prometheus para testar consultas. Agora você pode instalar componentes adicionais, como Alert Manager e Grafana, em seu sistema de monitoramento.