Como instalar o Grafana no Linux (Ubuntu/Debian, CentOS/RHEL e Docker)

O Grafana é uma plataforma open-source para visualização de métricas e logs. Ele costuma trabalhar em conjunto com Prometheus, Loki, InfluxDB e vários outros bancos de dados. Neste guia você verá como instalar, iniciar, acessar e proteger o Grafana nas principais distros Linux — e também via Docker.

Resumo

Porta padrão: 3000/tcp

Login inicial: admin / admin (obriga trocar na 1ª vez)

Serviço systemd: grafana-server

1) Requisitos

Acesso sudo/root
Saída para internet (para baixar pacotes)
Abrir a porta 3000/tcp no firewall local (e no seu roteador se for acessar de fora)

2) Instalação no Ubuntu/Debian

Adicione o repositório oficial e instale:


sudo apt-get update
sudo apt-get install -y apt-transport-https software-properties-common wget gpg

# Chave e repositório
sudo mkdir -p /etc/apt/keyrings
wget -qO- https://apt.grafana.com/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/grafana.gpg
echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list

# Instalação
sudo apt-get update
sudo apt-get install -y grafana

# Habilitar e iniciar
sudo systemctl enable --now grafana-server

(Opcional) Firewall UFW


sudo ufw allow 3000/tcp
sudo ufw reload

3) Instalação no CentOS / RHEL / Rocky / AlmaLinux

Crie o repositório e instale:


# Repositório oficial
sudo tee /etc/yum.repos.d/grafana.repo <<'EOF'
[grafana]
name=Grafana OSS
baseurl=https://packages.grafana.com/oss/rpm
repo_gpgcheck=1
enabled=1
gpgcheck=1
gpgkey=https://packages.grafana.com/gpg.key
EOF

# Instalação
sudo yum install -y grafana

# Habilitar e iniciar
sudo systemctl enable grafana-server
sudo systemctl start grafana-server

(Opcional) firewalld


sudo firewall-cmd --add-port=3000/tcp --permanent
sudo firewall-cmd --reload

Dica SELinux: se for publicar o Grafana por trás de um Nginx/Apache na porta 80/443, normalmente não precisa ajustar SELinux. Caso queira expor o Grafana direto numa porta não-padrão do contexto http, é possível mapear com:
sudo semanage port -a -t http_port_t -p tcp 3000  # se necessário

4) Acessando o Grafana

No navegador, abra:


http://IP_DO_SERVIDOR:3000

Usuário: admin
Senha: admin → ele obrigará você a definir uma nova senha.

Reset da senha admin (se esquecer):


sudo grafana-cli admin reset-admin-password NOVA_SENHA
sudo systemctl restart grafana-server

5) Instalação via Docker (alternativa rápida)


docker run -d --name=grafana \
  -p 3000:3000 \
  -e GF_SECURITY_ADMIN_PASSWORD="TroqueEstaSenha" \
  -v grafana-storage:/var/lib/grafana \
  grafana/grafana-oss:latest

Dados persistidos em grafana-storage
Pare/inicie com docker stop grafana && docker start grafana

6) Solução de problemas comuns

“Site não abre / conexão recusada”
- Verifique o serviço:
```
sudo systemctl status grafana-server
sudo journalctl -u grafana-server -f
```
- Libere a porta 3000 no firewall.
Porta em uso (outra aplicação usando 3000)
- Descubra quem usa:
```
sudo ss -tulnp | grep :3000
```
- Troque a porta inicial do Grafana:
  - Edite /etc/grafana/grafana.ini → http_port = 3001
  - Reinicie o serviço.
Sem internet / sem repositório
- Confira DNS e rota:
```
ping -c 3 google.com
cat /etc/resolv.conf
```

Erro de plugin

Atualize ou remova o plugin problemático:


grafana-cli plugins ls
grafana-cli plugins update-all
sudo systemctl restart grafana-server

7) Próximos passos (recomendado)

Prometheus + Blackbox Exporter para monitorar sites e disponibilidade da internet
Loki + Promtail para centralizar logs
Alertas do Grafana para e-mail/Telegram/Slack quando um serviço cair
Dashboards custom com os principais KPIs do seu ambiente

Conclusão

Em poucos minutos você tem o Grafana rodando no Linux e pronto para virar o seu “painel de controle” de métricas. A partir daqui, basta conectar fontes de dados, importar (ou criar) dashboards e — se necessário — configurar alertas.