Base de Conhecimento

Grafana na VPS: painéis de monitoramento no seu servidor

  • grafana, monitoramento, nginx, vps, docker
  • Usuários acharam útil: 0

Passo a passo para instalar o Grafana numa VPS com Ubuntu pelo APT oficial: iniciar o serviço, trocar a senha admin, usar proxy reverso Nginx e Docker como alternativa.

Por Redação Eleven Host · @robson.direitodigital · 3 de novembro de 2026 · 7 min de leitura

Arte da Eleven Host: janela de terminal com o título: Grafana na VPS: painéis de monitoramento no seu servidor

Capa da Redação Eleven Host para o guia: Grafana na VPS: painéis de monitoramento no seu servidor Arte: Eleven Host

Grafana na VPS é a forma de montar painéis de monitoramento num servidor seu, instalando o Grafana pelo repositório APT oficial no Ubuntu. Segundo o GitHub do projeto, ele é uma plataforma aberta e componível de observabilidade e visualização de dados.

Neste passo a passo você instala o pacote, inicia o serviço, troca a senha do administrador e coloca o Grafana atrás de um proxy reverso Nginx. Se você ainda não conhece o servidor VPS, comece por O que é servidor VPS: guia simples para iniciantes. Os exemplos usam example.com no lugar do seu domínio.

O que é o Grafana e qual edição instalar

De acordo com o README do projeto, o Grafana permite consultar, visualizar, criar alertas e entender suas métricas, não importa onde elas estejam guardadas. Os painéis puxam dados de fontes como Prometheus, InfluxDB, Loki, MySQL e PostgreSQL, que estão na lista de data sources nativos da documentação. É possível acrescentar outras fontes como plugins.

A documentação de instalação em Debian e Ubuntu oferece duas edições. A Grafana Enterprise é a recomendada e a padrão: é gratuita e inclui os recursos da edição OSS. A edição OSS é o pacote grafana, e o README do projeto informa que o Grafana é distribuído sob a licença AGPL-3.0-only. Este guia instala a OSS, e você pode trocar pelo pacote grafana-enterprise se preferir a edição recomendada pela documentação.

A última versão publicada na página de releases do GitHub é a 13.3.0, de 27 de outubro de 2026.

Instalar o Grafana pelo APT

Os comandos abaixo são os da documentação oficial para Debian e Ubuntu. Primeiro, os pacotes necessários para o APT usar repositórios HTTPS e para baixar a chave:

sudo apt-get install -y apt-transport-https wget gnupg

Depois, baixe a chave do repositório e deixe-a legível:

sudo mkdir -p /etc/apt/keyrings

sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key

sudo chmod 644 /etc/apt/keyrings/grafana.asc

Adicione o repositório estável:

echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list

Atualize a lista de pacotes e instale a edição OSS:

sudo apt-get update

sudo apt-get install grafana

Para a edição Enterprise, o último comando troca para sudo apt-get install grafana-enterprise.

Segundo a documentação, quem instala o pacote .deb manualmente precisa atualizar o Grafana a cada versão nova.

Procurando uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer a VPS

Iniciar o serviço

A documentação de inicialização usa o systemd. O guia systemctl: como iniciar, parar e ver serviços na VPS explica cada um desses comandos. Os da página oficial são estes:

sudo systemctl daemon-reload

sudo systemctl start grafana-server

sudo systemctl status grafana-server

Para o Grafana subir junto com o servidor, habilite o serviço:

sudo systemctl enable grafana-server.service

E, quando você mudar alguma configuração, reinicie para ela valer:

sudo systemctl restart grafana-server

Primeiro acesso: porta 3000 e senha do admin

Por padrão, o Grafana responde na porta 3000, no endereço http://localhost:3000 da própria máquina. A documentação de login informa que o usuário e a senha iniciais são admin, e que o Grafana mostra um aviso para você trocar a senha. A recomendação da documentação é forte: troque a senha padrão do administrador.

No arquivo de configuração, o parâmetro admin_password é definido uma vez, na primeira execução, e o padrão é admin. Faça a troca logo no primeiro login, antes de expor o painel a outras pessoas.

A porta é definida por http_port, cujo padrão é 3000.

Onde fica a configuração

Em instalações por pacote deb ou RPM, o arquivo de configuração fica em /etc/grafana/grafana.ini. A documentação avisa para não alterar o arquivo defaults.ini. As mudanças vão no grafana.ini, e o serviço precisa ser reiniciado depois.

Dois parâmetros importam para quem usa proxy: o domain, que a documentação diz ser usado apenas como parte do root_url, e o próprio root_url, a URL completa usada para acessar o Grafana de um navegador.

Colocar o Grafana atrás do Nginx

O tutorial oficial de proxy reverso do Grafana usa o Nginx. Primeiro, informe o domínio no grafana.ini, na seção [server]:

[server]

domain = example.com

Depois, o arquivo de configuração do Nginx do tutorial. As linhas abaixo são as do exemplo oficial, e o bloco /api/live/ existe para as conexões WebSocket do Grafana Live:

# This is required to proxy Grafana Live WebSocket connections.

map $http_upgrade $connection_upgrade {

default upgrade;

'' close;

}

upstream grafana {

server localhost:3000;

}

server {

listen 80;

root /usr/share/nginx/html;

index index.html index.htm;

location / {

proxy_set_header Host $host;

proxy_pass http://grafana;

}

# Proxy Grafana Live WebSocket connections.

location /api/live/ {

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection $connection_upgrade;

proxy_set_header Host $host;

proxy_pass http://grafana;

}

}

O tutorial acrescenta que o Grafana Live pode exigir um worker_connections acima do padrão de 512 no Nginx.

O endereço example.com é o do tutorial; troque pelo seu domínio. Se preferir servir o Grafana num subcaminho, como /grafana/, o tutorial mostra estas linhas no grafana.ini:

[server]

domain = example.com

root_url = %(protocol)s://%(domain)s:%(http_port)s/grafana/

serve_from_sub_path = true

HTTPS e porta 3000 fechada

A tela de login do Grafana pede uma senha, e ela não deve trafegar em texto puro. Recomendamos servir o painel por HTTPS, com um certificado no Nginx. Veja também o guia Nginx Proxy Manager: vários sites numa VPS só.

Também recomendamos que a porta 3000 não fique aberta para a internet quando o acesso passa pelo proxy. Um exemplo, se você usa o ufw, é manter a 3000 sem regra de liberação e abrir só as portas 80 e 443:

sudo ufw allow 80/tcp

sudo ufw allow 443/tcp

Se o proxy e o Grafana ficam na mesma máquina, o Nginx fala com o Grafana por localhost:3000, como no upstream do exemplo, e o acesso externo passa só pelas portas 80 e 443.

Grafana no Docker, como alternativa

A documentação também traz a instalação por contêiner. O comando oficial usa a imagem da edição Enterprise e publica a porta 3000:

docker run -d -p 3000:3000 --name=grafana grafana/grafana-enterprise

Para que os dados sobrevivam à recriação do contêiner, crie um volume e use-o no comando:

docker volume create grafana-storage

docker run -d -p 3000:3000 --name=grafana \

--volume grafana-storage:/var/lib/grafana \

grafana/grafana-enterprise

A edição OSS tem imagem própria, grafana/grafana. Um exemplo é trocar o nome da imagem no mesmo comando. Para gerenciar contêineres pelo navegador, veja Portainer na VPS: como gerenciar o Docker pelo navegador.

Conectar o Grafana ao Zabbix

O Zabbix não está na lista de data sources nativos do Grafana. A conexão é feita por um plugin: o catálogo do Grafana lista o Zabbix plugin for Grafana, identificado como alexanderzobnin-zabbix-app, com o desenvolvedor Grafana Labs, versão 6.10.2 e última atualização em 2 de novembro de 2026. O comando de instalação da página do plugin é:

grafana cli plugins install alexanderzobnin-zabbix-app

Resumo do caminho

A sequência abaixo reúne o que o guia apresentou, na ordem em que cada passo é feito.

Checklist do Grafana na VPS

  • Instalar os pré-requisitos, a chave grafana.asc e o repositório APT.
  • Instalar o pacote grafana (OSS) ou grafana-enterprise.
  • Iniciar o grafana-server e habilitar no boot.
  • Trocar a senha admin no primeiro login.
  • Definir o domain no grafana.ini e configurar o Nginx com o bloco /api/live/.
  • Servir por HTTPS e manter a porta 3000 fechada para a internet.

Quer comparar os planos de VPS da Eleven Host? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver planos de VPS

Perguntas frequentes

Qual é a senha inicial do Grafana?

O usuário e a senha iniciais são admin. A documentação mostra um aviso para trocar a senha no primeiro acesso e recomenda com ênfase que você troque a padrão.

Em qual porta o Grafana responde?

Na 3000, por padrão, segundo o parâmetro http_port da documentação. Em um servidor, o acesso externo deve passar pelo proxy Nginx.

Qual a diferença entre grafana e grafana-enterprise?

A documentação diz que a Enterprise é a edição recomendada e padrão, gratuita, com os recursos da OSS. O pacote grafana é a edição OSS, distribuída sob a licença AGPL-3.0-only, segundo o README.

O Grafana lê dados do Zabbix?

Sim, por meio do plugin alexanderzobnin-zabbix-app, já que o Zabbix não está entre os data sources nativos.

Esta resposta lhe foi útil?

Artigos Relacionados