Como instalar o Grafana no Saplo (dashboards e monitorização)

A Grafana Cloud, num plano pago, pode custar bastante mais de 100 euros por mês, antes sequer de ligares a primeira fonte de dados, porque a faturação depende do número de séries de métricas e da duração do seu armazenamento. A Grafana OSS tem exatamente o mesmo motor de gráficos e alertas, de código aberto, que instalas no teu próprio Box, de uma só vez, sem uma fatura mensal dependente de quantas métricas recolhes. Abaixo, discover passo a passo como instalar a Grafana no Saplo.

Porquê Grafana no teu próprio Box em vez de Grafana Cloud

Os planos pagos da Grafana Cloud têm duas características que doiam especialmente quando se monitorizam vários projetos em simultâneo:

• custo que aumenta com o número de métricas e o tempo de retenção - quanto mais servidores e aplicações monitorizas e mais tempo queres manter o histórico, mais alta é a fatura mensal,
• limite do plano gratuito que mais cedo ou mais tarde acaba por ser excedido - o nível gratuito chega para um pequeno projeto, mas não para vários clientes ao mesmo tempo.

A Grafana OSS é o mesmo motor que colocas em execução no teu próprio Box. Sem custos dependentes do número de métricas, os dados de telemetria ficam na tua infraestrutura, e o aspeto e a lógica de criação de dashboards são idênticos aos da versão na nuvem.

Requisitos

Para colocar o Grafana a funcionar no Saplo, precisas de:

• um Box com o Docker em funcionamento (o motor ativa-o automaticamente durante a instalação a partir do catálogo; é necessário o aninhamento em contentores, que o Saplo inclui por predefinição),
• pelo menos 512 MB de RAM livres no Box e 2 GB de espaço em disco para a base de dados interna,
• domínios ou subdomínios *.saploapp.pl incluídos no preço de cada plano.

Vale a pena distinguir desde logo o que o Grafana é e o que não é. O Grafana, por si só, não recolhe quaisquer métricas, é apenas um motor de gráficos, dashboards e alertas. A fonte de dados, por exemplo o Prometheus, que recolhe métricas dos servidores, o InfluxDB com dados temporais ou uma base de dados MySQL ou Postgres normal, com tabelas para análise, é ligada manualmente após a primeira execução, no separador Connections. O Grafana no Saplo guarda os seus próprios dados, ou seja, dashboards guardados, contas de utilizador e a configuração das fontes, numa base de dados SQLite separada, dentro do volume de dados. Por isso, não precisas de nenhuma base de dados externa para a própria instalação.

Instalação passo a passo

1. No painel Saplo, entra no Catálogo de aplicações e escolhe Grafana (categoria "Dados").
2. Indica o Box onde deve ficar alojada e o domínio ou subdomínio sob o qual a aplicação estará disponível.
3. Confirma a instalação. O motor cria um contentor Docker com a imagem oficial grafana/grafana-oss, prepara um volume para os dados, gera uma conta de administrador aleatória e disponibiliza o painel no domínio indicado através do nginx, com SSL gratuito.
4. O motor espera que a Grafana responda efetivamente ao pedido de verificação de saúde antes de considerar a instalação concluída, pelo que, se a imagem não arrancar, verás um erro em vez de um domínio sem resposta.
5. Após a conclusão, no Catálogo de aplicações do Box, encontras o ficheiro GRAFANA-SETUP.txt com o nome de utilizador e a palavra-passe gerados para aceder ao painel.

Primeira configuração

O Grafana, tal como o MinIO ou o Vaultwarden, cria automaticamente uma conta de administrador durante a instalação, em vez de solicitar uma no assistente.

1. Inicia sessão no Painel com os dados do ficheiro GRAFANA-SETUP.txt e altera a palavra-passe em Administration -> Users, antes de fazeres mais alguma coisa, sobretudo se estiveres a partilhar o acesso com a equipa.
2. Adiciona a primeira fonte de dados em Connections -> Data sources. O Grafana suporta, entre outros, Prometheus, InfluxDB, MySQL, PostgreSQL, Elasticsearch e Loki, e podes encontrar a lista das fontes suportadas na documentação oficial do Grafana.
3. Depois de ligares a fonte de dados, cria o primeiro dashboard em Dashboards -> New, ou importa um modelo pronto da galeria do Grafana, se estiveres a monitorizar um serviço popular, como um servidor nginx ou uma base de dados Postgres.
4. Configura alertas em Alerting, se quiseres receber uma notificação quando uma métrica ultrapassar o limite definido, por exemplo, quando a utilização do disco exceder 90 por cento.

Grafana na Saplo vs. Grafana Cloud

Perguntas mais frequentes

A Grafana recolhe métricas por si só ou preciso de mais alguma coisa? A Grafana não recolhe nada por si só, é apenas um motor de gráficos e alertas. As métricas são fornecidas por uma fonte de dados separada, por exemplo Prometheus ou uma base de dados SQL, que configuras manualmente após a instalação, no separador Connections.

Que fontes de dados posso ligar? A Grafana suporta, entre outras, Prometheus, InfluxDB, MySQL, PostgreSQL, Elasticsearch e Loki. A lista completa de plugins está disponível no painel de adição de uma nova fonte de dados.

Posso monitorizar o próprio Box onde a Grafana está a funcionar? Sim, mas precisas de uma aplicação separada que recolha métricas do sistema, por exemplo Prometheus com o respetivo exportador, e de a ligar como fonte de dados. A instalação da Grafana em si não recolhe estas métricas.

Os dados na Grafana têm cópia de segurança automática? Depende do plano Box que contratares. A cópia de segurança funciona ao nível de todo o Box, tal como nas outras aplicações do catálogo, e não é uma funcionalidade separada da Grafana.

Posso ter mais do que um dashboard e vários utilizadores? Sim, o número de dashboards e contas de utilizador não é limitado pela Grafana OSS. O único limite são os recursos do Box que comprares.

Se tiveres dúvidas ao instalar a Grafana no teu próprio Box ou ao ligar a primeira fonte de dados, escreve-nos. Ajudamos-te com a configuração inicial.