Como Instalar Grafana no Ubuntu: Guia Completo de Configuração

Grafana é uma das plataformas de código aberto mais poderosas para visualização de dados e monitoramento de infraestrutura. Quer esteja a rastrear o desempenho do servidor, métricas de aplicações ou KPIs comerciais, os painéis flexíveis do Grafana e o amplo suporte de fontes de dados tornam-o uma ferramenta indispensável para qualquer administrador de sistemas ou engenheiro DevOps.

Este guia abrangente orienta-o em cada etapa da instalação do Grafana no Ubuntu — desde a preparação inicial do sistema até à configuração de fontes de dados, construção do seu primeiro painel, configuração de alertas e segurança da sua implementação.

> Pré-requisitos: Um servidor Ubuntu em funcionamento (20.04 ou 22.04 LTS recomendado), privilégios sudo e uma ligação à Internet estável. Se precisar de um servidor fiável para alojar a sua instância Grafana, considere VPS Hosting da AlexHost — otimizado para cargas de trabalho de monitoramento críticas de desempenho.

Índice

1. Atualizar Pacotes do Sistema
2. Instalar Grafana através do Repositório APT Oficial
3. Iniciar e Ativar o Serviço Grafana
4. Aceder à Interface Web do Grafana
5. Configurar Fontes de Dados
6. Criar o Seu Primeiro Painel
7. Configurar Alertas
8. Proteger Grafana com HTTPS e Controlos de Acesso
9. Gerir e Atualizar Grafana

Passo 1: Atualizar Pacotes do Sistema {#step-1}

Antes de instalar qualquer novo software, é crítico sincronizar o índice de pacotes e aplicar todas as atualizações disponíveis. Isto garante compatibilidade e reduz o risco de conflitos de dependências.

sudo apt update && sudo apt upgrade -y

Permita que o processo seja concluído antes de prosseguir. Num servidor recém-provisionado, isto pode levar alguns minutos.

Passo 2: Instalar Grafana através do Repositório APT Oficial {#step-2}

Grafana mantém um repositório APT oficial para sistemas baseados em Debian, incluindo Ubuntu. Usar o repositório oficial garante que tem sempre acesso às versões estáveis mais recentes e patches de segurança.

Passo 2a: Instalar Dependências Necessárias

Primeiro, instale o pacote software-properties-common, que fornece o utilitário add-apt-repository:

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

Passo 2b: Importar a Chave de Assinatura GPG do Grafana

Adicionar a chave GPG permite que o seu sistema verifique a autenticidade dos pacotes descarregados do repositório Grafana:

wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -

Passo 2c: Adicionar o Repositório APT Oficial do Grafana

sudo add-apt-repository "deb https://packages.grafana.com/oss/deb stable main"

Passo 2d: Atualizar a Lista de Pacotes e Instalar Grafana

sudo apt update
sudo apt install grafana -y

Após a conclusão da instalação, verifique a versão instalada:

grafana-server -v

Passo 3: Iniciar e Ativar o Serviço Grafana {#step-3}

Após a instalação, inicie o daemon do servidor Grafana e configure-o para ser iniciado automaticamente no arranque do sistema:

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

Verifique que o serviço está a funcionar corretamente:

sudo systemctl status grafana-server

Deverá ver um resultado semelhante ao seguinte, confirmando que o serviço está ativo (em execução):

● grafana-server.service - Grafana instance
     Loaded: loaded (/lib/systemd/system/grafana-server.service; enabled)
     Active: active (running) since ...

Se o serviço não conseguir iniciar, verifique os registos para erros:

sudo journalctl -u grafana-server -f

Passo 4: Aceder à Interface Web do Grafana {#step-4}

Por padrão, Grafana escuta na porta 3000. Abra o seu navegador web e navegue para:

http://your_server_ip:3000

Substitua your_server_ip pelo endereço IP real ou nome de anfitrião do seu servidor.

Credenciais de Início de Sessão Padrão

No seu primeiro início de sessão, Grafana irá imediatamente pedir-lhe para definir uma nova palavra-passe segura. Não ignore este passo — deixar as credenciais padrão no lugar é um risco de segurança significativo.

> Nota de Firewall: Se estiver a executar UFW ou outra firewall, abra a porta 3000 para permitir acesso ao navegador:

> “`bash

> sudo ufw allow 3000/tcp

> sudo ufw reload

> “`

Passo 5: Configurar Fontes de Dados {#step-5}

Grafana é uma camada de visualização — não armazena métricas em si. Em vez disso, liga-se a fontes de dados externas como Prometheus, InfluxDB, Elasticsearch, MySQL, PostgreSQL e muitas outras. Configurar uma fonte de dados é o passo essencial antes de poder construir qualquer painel.

Passo 5a: Navegar para Fontes de Dados

1. Na barra lateral esquerda, clique no ícone de engrenagem (⚙) para abrir o menu Configuração.
2. Selecione Fontes de Dados.

Passo 5b: Adicionar uma Nova Fonte de Dados

1. Clique em Adicionar fonte de dados.
2. Navegue pela lista e selecione o tipo de fonte de dados desejado (por exemplo, Prometheus, InfluxDB, MySQL).

Passo 5c: Introduzir Detalhes de Ligação

Preencha os parâmetros de ligação para a sua fonte de dados escolhida. Por exemplo, se estiver a ligar-se a uma instância Prometheus em execução localmente:

• URL: http://localhost:9090
• Acesso: Server (default)
• Intervalo de raspagem: 15s (corresponder à sua configuração de raspagem Prometheus)

Para uma instância InfluxDB remota, forneceria o URL do anfitrião, nome da base de dados e credenciais de autenticação.

Passo 5d: Guardar e Testar a Ligação

Clique em Guardar e Testar. Grafana tentará ligar-se à fonte de dados e apresentará uma mensagem de sucesso ou erro. Uma confirmação verde “Data source is working” significa que está pronto para construir painéis.

Passo 6: Criar o Seu Primeiro Painel Grafana {#step-6}

Com uma fonte de dados ligada, pode agora criar painéis para visualizar as suas métricas em tempo real.

Passo 6a: Criar um Novo Painel

1. Na barra lateral esquerda, clique no ícone + (mais).
2. Selecione Painel.
3. Clique em Adicionar novo painel.

Passo 6b: Configurar o Painel

O editor de painel abre, dando-lhe controlo total sobre quais dados são apresentados e como são visualizados.

• Fonte de Dados: Selecione a fonte de dados que configurou no Passo 5.
• Consulta: Escreva a sua consulta de métrica. Para Prometheus, use PromQL. Por exemplo, para visualizar o uso de CPU:

  100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

• Tipo de Visualização: Escolha entre Time series, Gauge, Bar chart, Table, Stat, Heatmap e mais — dependendo da natureza dos seus dados.
• Título do Painel: Dê ao seu painel um nome descritivo (por exemplo, “Uso de CPU — Última 1 Hora”).

Passo 6c: Personalizar e Guardar

Use as opções do painel da direita para configurar limiares, esquemas de cores, rótulos de eixos e legendas. Após estar satisfeito:

1. Clique em Aplicar para adicionar o painel ao seu painel de controlo.
2. Repita o processo para adicionar múltiplos painéis — cada um rastreando uma métrica diferente.
3. Clique no ícone Guardar painel (disquete) no canto superior direito, dê um nome ao seu painel e clique em Guardar.

> Dica Profissional: A biblioteca oficial de painéis do Grafana oferece centenas de painéis pré-construídos contribuídos pela comunidade para pilhas populares como Node Exporter, Kubernetes, MySQL e NGINX. Pode importá-los diretamente usando um ID de painel.

Passo 7: Configurar Alertas {#step-7}

O motor de alertas integrado do Grafana permite-lhe definir regras baseadas em limiares e receber notificações quando as métricas ultrapassam níveis críticos — mantendo-o informado antes de pequenos problemas se tornarem grandes interrupções.

Passo 7a: Criar uma Regra de Alerta

1. Abra o painel que deseja monitorar e clique em Editar.
2. Navegue para o separador Alerta dentro do editor de painel.
3. Clique em Criar Alerta.

Passo 7b: Definir Condições de Alerta

Configure as condições que acionam o alerta. Por exemplo:

• Condição: WHEN avg() OF query(A, 5m, now) IS ABOVE 90
• Isto aciona um alerta quando o valor médio da sua métrica excede 90 nos últimos 5 minutos.

Defina os campos Avaliar cada e Por para controlar com que frequência a regra é avaliada e quanto tempo a condição deve persistir antes de disparar.

Passo 7c: Configurar Canais de Notificação

1. Vá para Alertas → Canais de notificação na barra lateral esquerda.
2. Clique em Adicionar canal e escolha o seu método preferido:

• Email — requer configuração SMTP em grafana.ini
• Slack — requer um URL de webhook Slack
• PagerDuty, OpsGenie, Webhook e mais

Atribua o canal de notificação à sua regra de alerta para que as pessoas certas sejam notificadas quando os limiares forem excedidos.

Passo 8: Proteger Grafana com HTTPS e Controlos de Acesso {#step-8}

Executar Grafana num ambiente de produção sem endurecimento de segurança adequado é um risco grave. Siga estas melhores práticas para proteger a sua infraestrutura de monitoramento.

8a: Ativar HTTPS com um Certificado SSL

Encriptar o tráfego para a sua instância Grafana é essencial, especialmente se for acessível pela Internet pública. Precisará de um certificado SSL válido — AlexHost oferece Certificados SSL acessíveis que são fáceis de implementar.

Após ter o seu certificado e chave privada, edite o ficheiro de configuração do Grafana:

sudo nano /etc/grafana/grafana.ini

Localize a secção [server] e atualize os seguintes parâmetros:

[server]
protocol = https
http_port = 3000
cert_file = /etc/grafana/ssl/grafana.crt
cert_key = /etc/grafana/ssl/grafana.key

Guarde o ficheiro e reinicie Grafana:

sudo systemctl restart grafana-server

Grafana será agora acessível sobre HTTPS na porta 3000.

> Alternativa Recomendada: Coloque Grafana atrás de um proxy inverso (por exemplo, Nginx ou Apache) e termine SSL ao nível do proxy. Esta é uma abordagem mais flexível e amplamente adotada em ambientes de produção.

8b: Restringir Acesso de Administrador e Gerir Utilizadores

1. Navegue para Server Admin → Utilizadores na interface Grafana.
2. Revise e ajuste as funções de utilizador:

• Admin — acesso total
• Editor — pode criar e editar painéis
• Viewer — acesso apenas de leitura

1. Desative ou elimine contas não utilizadas.
2. Considere ativar LDAP ou OAuth (Google, GitHub, GitLab) para autenticação centralizada.

8c: Recomendações Adicionais de Endurecimento

• Desative o acesso anónimo em grafana.ini:

  [auth.anonymous]
  enabled = false

• Altere a porta HTTP padrão se Grafana for exposto publicamente.
• Restrinja as ligações de saída do servidor Grafana usando regras de firewall.
• Ative o registo de auditoria para rastrear a atividade do utilizador.

Passo 9: Gerir e Atualizar Grafana {#step-9}

Manter Grafana atualizado é crítico para segurança e acesso a novas funcionalidades. Como instalou Grafana a partir do repositório APT oficial, as atualizações são simples.

Atualizar Grafana

sudo apt update
sudo apt upgrade grafana -y

Comandos Comuns de Gestão de Serviços

Fazer Cópia de Segurança dos Dados do Grafana

Grafana armazena a sua configuração, painéis e dados de utilizador numa base de dados SQLite por padrão, localizada em:

/var/lib/grafana/grafana.db

Faça cópia de segurança deste ficheiro regularmente, especialmente antes de realizar atualizações:

sudo cp /var/lib/grafana/grafana.db /var/lib/grafana/grafana.db.backup-$(date +%F)

Para implementações maiores, considere migrar para um backend dedicado MySQL ou PostgreSQL para melhor fiabilidade e gestão de cópias de segurança mais fácil.

Resolução de Problemas Comuns