Construa um Sistema de Monitoramento com Grafana e Prometheus no Debian 12

Grafana é uma plataforma de visualização de dados de código aberto e multi-plataforma desenvolvida pela Grafana Labs. Grafana fornece um aplicativo web interativo de visualização de dados que inclui gráficos, gráficos e alertas. Com o Grafana, você pode consultar, visualizar, configurar alertas e explorar métricas, logs e rastros de TSDB. É uma ferramenta poderosa que transforma dados de banco de dados de séries temporais (TSDB) em um gráfico e visualização perspicazes.

No Grafana, você pode adicionar seus dados de banco de dados de séries temporais através da ‘Fonte de Dados’. O Grafana suporta várias fontes de dados, como Prometheus, InfluxDB, PostgreSQL, Loki, Jaeger, Graphite, Google Cloud Monitoring, AWS CloudWatch, Azure Monitor e muitos mais.

Neste guia, você instalará o Grafana no servidor Debian 12 com Nginx como um proxy reverso, em seguida, adicionará o Prometheus como a fonte de dados e configurará o Painel do Grafana para monitoramento do sistema.

Pré-requisitos

Antes de prosseguir, certifique-se de que você possui o seguinte:

• Um servidor Debian 12 para a instalação do Grafana.
• Um servidor Debian 12 com Prometheus e Node Exporter Instalados - Como Instalar Prometheus e Node Exporter no Debian 12.
• Um usuário não-root com privilégios de administrador sudo.

Adicionando o Repositório do Grafana

Neste guia, você instalará o Grafana através do repositório oficial do Grafana. Para fazer isso, você deve adicionar o repositório do Grafana ao seu servidor Debian.

Para começar, execute o seguinte comando para instalar as dependências básicas na sua máquina Debian.

sudo apt install gnupg2 apt-transport-https software-properties-common wget

Agora adicione a chave GPG do Grafana e o repositório executando o seguinte comando.

curl -fsSL https://packages.grafana.com/gpg.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/grafana.gpg  
echo 'deb [signed-by=/etc/apt/trusted.gpg.d/grafana.gpg] https://packages.grafana.com/oss/deb stable main' | sudo tee /etc/apt/sources.list.d/grafana.list

Por último, atualize e atualize o índice de pacotes do Debian para aplicar as alterações.

sudo apt update

Instalando o Grafana

Agora que você adicionou o repositório do Grafana, você instalará o Grafana via APT. Em seguida, você configurará o usuário administrador e a senha para sua instalação do Grafana.

Instale o Grafana no seu sistema Debian usando o seguinte comando. Digite y para prosseguir com a instalação.

sudo apt install grafana

Após a conclusão da instalação, recarregue o gerenciador systemd executando o seguinte comando.

sudo systemctl daemon-reload

Em seguida, inicie e habilite o serviço grafana-server usando o comando abaixo.

sudo systemctl start grafana-server  
sudo systemctl enable grafana-server

Uma vez que o grafana-server esteja em execução, verifique-o usando o comando abaixo. Se tudo correr bem, você deve ver que o grafana-server está habilitado e em execução.

sudo systemctl status grafana-server

Por último, abra seu navegador web e visite o endereço IP do seu servidor com a porta padrão do Grafana 3000, como http://192.168.5.20:3000/.

Digite o usuário padrão admin e a senha admin, em seguida, clique em Login.

Agora mude a senha padrão do admin para uma nova senha. Em seguida, clique em Submit para confirmar.

Quando o processo estiver concluído, você deve ver o painel do Grafana como o seguinte:

Configurando o Grafana

Com o Grafana instalado, o próximo passo é configurar o Grafana modificando a configuração padrão /etc/grafana/grafana.ini e configurar o http_addr para localhost, http_port para 3000, e o domínio com um nome de domínio local grafana.howtoforge.local.

Abra a configuração padrão do Grafana /etc/grafana/grafana.ini usando o seguinte comando do editor nano.

sudo nano /etc/grafana/grafana.ini

Altere a configuração padrão com as seguintes linhas. Neste exemplo, você executará o Grafana em localhost e com o nome de domínio local grafana.howtoforge.local.

[server]  
# O endereço IP para vincular, vazio vinculará a todas as interfaces  
http_addr = localhost  
  
# A porta http a ser usada  
http_port = 3000  
  
# O nome de domínio público usado para acessar o grafana a partir de um navegador  
domain = grafana.howtoforge.local

Quando terminar, salve e saia do arquivo.

Agora execute o seguinte comando systemctl para reiniciar o grafana-server e aplicar as alterações. Com isso, sua instalação do Grafana está rodando apenas no localhost.

sudo systemctl restart grafana-server

Instalando o Nginx como um Proxy Reverso

Neste guia, você executará o Grafana com o Nginx como um proxy reverso. Agora, complete as seguintes tarefas para instalar e configurar o Nginx como um proxy reverso para sua instalação do Grafana.

Execute o seguinte comando para instalar o servidor web Nginx na sua máquina Debian. Digite y para prosseguir com a instalação.

sudo apt install nginx

Após a instalação do Nginx, execute o seguinte comando do editor nano para criar um novo arquivo de bloco de servidor /etc/nginx/sites-available/grafana.conf.

sudo nano /etc/nginx/sites-available/grafana.conf

Insira a seguinte configuração e tenha certeza de mudar o nome do domínio dentro do parâmetro server_name.

# Isso é necessário para proxy Grafana Live WebSocket connections.  
map $http_upgrade $connection_upgrade {  
    default upgrade;  
    '' close;  
}  
  
server {  
    listen      80;  
    server_name grafana.howtoforge.local;  
  
    root /usr/share/nginx/html;  
    index index.html index.htm;  
  
    access_log /var/log/nginx/grafana-access.log;  
    error_log /var/log/nginx/grafana-error.log;  
  
    location / {  
        proxy_set_header Host $http_host;  
        proxy_pass http://localhost:3000/;  
    }  
  
    # Proxy Grafana Live WebSocket connections.  
    location /api/live {  
        rewrite  ^/(.*)  /$1 break;  
        proxy_http_version 1.1;  
        proxy_set_header Upgrade $http_upgrade;  
        proxy_set_header Connection $connection_upgrade;  
        proxy_set_header Host $http_host;  
        proxy_pass http://localhost:3000/;  
    }  
}

Salve e feche o arquivo quando terminar.

Em seguida, execute o seguinte comando para ativar o arquivo de bloco de servidor /etc/nginx/sites-available/grafana.conf. Então, verifique a sintaxe do Nginx para garantir que você tenha uma sintaxe adequada.

sudo ln -s /etc/nginx/sites-available/grafana.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Se você tiver a sintaxe correta do Nginx, você deve obter a saída ‘teste bem-sucedido - sintaxe está ok‘.

Por último, execute o seguinte comando systemctl para reiniciar o serviço Nginx e aplicar as alterações. Em seguida, verifique o Nginx para garantir que o serviço esteja em execução.

sudo systemctl restart nginx  
sudo systemctl status nginx

Na saída a seguir, você deve ver que o serviço Nginx está em execução.

Para acessar seu servidor Grafana, você pode modificar o arquivo /etc/hosts na sua máquina local se você for um usuário Linux ou MacOS. Para usuários do Windows, edite o arquivo C:\Windows\System32\drivers\etc\hosts como administrador.

Insira a seguinte configuração no arquivo.

192.168.5.15    grafana.howtoforge.local

Salve e feche o arquivo quando terminar.

Agora volte ao navegador web e visite seu nome de domínio local para o servidor Grafana, como http://grafana.howtoforge.local/. Se sua configuração for bem-sucedida, você será redirecionado para a página de login do Grafana.

Faça login com seu usuário e senha de admin, em seguida, clique em Login para confirmar.

Agora você deve obter o painel de admin do Grafana.

Adicionando Autenticação ao Servidor Prometheus

Antes de adicionar o Prometheus ao Grafana, você configurará a autenticação básica para o Prometheus. Você gerará a senha de autenticação básica com apache2-utils, em seguida, habilitará basic_auth para o servidor Prometheus.

Neste exemplo, o Prometheus e o Node Exporter estão instalados em servidores diferentes com o endereço IP 192.168.5.15 e o nome do host prometheus.

Faça login no servidor Prometheus e instale o pacote apache2-utils via o comando apt abaixo.

sudo apt install apache2-utils -y

Depois disso, gere a nova senha para a autenticação básica do Prometheus. Digite sua senha e copie a senha gerada para suas anotações.

htpasswd -nB promadmin

Agora, crie uma nova configuração do Prometheus /etc/prometheus/web.yml usando o seguinte comando do editor nano.

sudo nano /etc/prometheus/web.yml

Adicione a seguinte configuração para proteger o painel de administração do Prometheus com o módulo basic_auth.

# basic_auth  
basic_auth_users:  
  promadmin: $2y$05$UlvHd4An.oQRt2UdUXzr9eZ6ShRLe3xYbMhw8ePfvGeLuu0khO4Bu

Salve e feche o arquivo quando terminar.

Em seguida, 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

Adicione a configuração basic_auth abaixo dentro do trabalho do Prometheus. Certifique-se de alterar os detalhes do usuário e senha com seus dados.

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'  
    # esquema padrão é 'http'.  
    # Adicione configurações para certificado e autenticação  
    scheme: http  
    basic_auth:  
      username: 'promadmin'  
      password: 'password'

Salve e feche o arquivo quando terminar.

Em seguida, execute o seguinte comando para editar o arquivo de serviço do prometheus.

sudo systemctl edit --full prometheus

Altere a opção ExecStart padrão com o seguinte.

ExecStart=/usr/bin/prometheus --config.file=/etc/prometheus/prometheus.yml --web.config.file=/etc/prometheus/web.yml

Salve e feche o arquivo quando terminar.

Agora, execute o seguinte comando systemctl para recarregar o gerenciador systemd e aplicar as alterações. Em seguida, reinicie o serviço prometheus.

sudo systemctl daemon-reload  
sudo systemctl restart prometheus

Verifique o serviço prometheus usando o comando abaixo.

sudo systemctl status prometheus

Dentro da seção ExecStart, o comando foi alterado como o seguinte.

Por último, abra seu navegador web e visite o endereço IP do Prometheus com a porta 9090 (ou seja: http://192.168.10.15:9090/). Você será solicitado com a autenticação básica do Prometheus, insira seu usuário admin e senha, em seguida, clique em Sign In.

Se sua configuração for bem-sucedida, você deve ver o painel do Prometheus como o seguinte.

Integrando o Prometheus com o Painel do Grafana

Após configurar a autenticação básica no Prometheus, você pode adicionar o Prometheus como a fonte de dados ao painel do Grafana. Existem duas etapas que você deve completar: adicionar o Prometheus como a fonte de dados e, em seguida, importar ou criar um painel do Grafana para o monitoramento do seu sistema.

Adicionando Fonte de Dados do Prometheus

Volte ao Painel do Grafana, clique no menu Conexões e selecione Fonte de dados.

Clique em Adicionar fonte de dados para continuar.

Selecione o banco de dados de séries temporais Prometheus.

Digite o nome da nova fonte de dados e o host do Prometheus para http://192.168.5.15:9090/. Dentro da seção Autenticação, selecione Autenticação Básica e insira o nome de usuário e a senha para o Prometheus.

Role para baixo e clique em Salvar & testar para confirmar. A saída ‘Consulta à API do Prometheus bem-sucedida.‘ confirma que o Prometheus foi adicionado ao Grafana.

Importando Painel de Monitoramento

Clique no menu + no canto superior direito e selecione Importar Painel.

Encontre seu Painel desejado em https://grafana.com/grafana/dashboards/. Em seguida, copie e cole o ID do painel e clique em Carregar para confirmar. Neste caso, usaremos o ID do Painel 15172.

Digite o nome do painel e selecione a fonte de dados do Prometheus. Em seguida, clique em Importar para confirmar.

Abaixo está um exemplo do Painel do Grafana melhorado com Prometheus para monitorar o sistema.

Agora você instalou com sucesso o Grafana em um servidor Debian 12 com Nginx como um proxy reverso, adicionou o Prometheus como a fonte de dados ao Grafana e importou o painel do Grafana para monitoramento do sistema.