Guia
Grafana: o painel que alguém realmente lê
Grafana é a camada de visualização e de alerta: consulta fontes de dados, como Zabbix e Prometheus, e mostra o resultado em painéis. O que mais pesa é desenhar cada painel para uma pergunta e para um público, e dar dono a cada alerta.
Revisão editorial interna, sem parecer jurídico. aprovação pendente conteúdo a validar
Leitura de 13 min
A cena
Terça-feira, 14h
Na reunião mensal, o diretor pede uma coisa simples: a disponibilidade dos principais serviços no mês. O analista de infraestrutura abre o Grafana. Há dezenas de painéis. Três se chamam “Servidores”, dois “Servidores (cópia)”. Nenhum tem dono nem data.
Ele escolhe um, com gráficos de CPU empilhados em seis cores, e tenta explicar. O diretor olha, não entende e pergunta de novo. No dia seguinte, o analista monta a resposta numa planilha, à mão. O painel estava bonito e ninguém o usava.
A causa por trás: o painel sem dono. O painel foi feito para mostrar tudo o que a ferramenta consegue, e não para responder a uma pergunta de um público. Sem dono e sem data, vira cópia de cópia, e ninguém sabe qual é o certo.
Exemplo ilustrativo, com dados fictícios. Não é cliente nem resultado real. conteúdo a validar
Do dado ao painel e ao alerta com dono
- Fonte
Zabbix, Prometheus - Painel
uma pergunta, um público - Regra
condição e pendência - Rota
política e ponto de contato - Dono
equipe que age
O custo de não agir
O que acontece se nada mudar
Não agir, ou montar painéis sem desenho, tem custo em tempo: a resposta continua sendo montada à mão, e cada alerta novo vira mais ruído. Não há número de mercado com fonte aberta para esta página. O que a documentação oficial descreve são sinais de maturidade e riscos conhecidos.
- Baixa maturidadea documentação do Grafana descreve como nível baixo de gestão de painéis a edição aberta a todos, a proliferação de cópias e a falta de versionamento. Fonte: Grafana, documentação oficial v13.2, boas práticas de painéis, consulta em 23/10/2026. Descrição qualitativa, sem estatística. link
- Dívida técnicasegundo a documentação de alertas, alertas que nunca são revisados e não pedem resposta devem virar painel; do contrário, viram dívida técnica. Fonte: Grafana, documentação oficial v13.2, boas práticas de alertas, consulta em 23/10/2026. Princípio de método, não número. link
Normas e boas práticas
O que as normas e as boas práticas pedem
O Grafana tem documentação oficial própria com recomendações de painéis e de alertas. Elas coincidem com o princípio de método do livro de SRE do Google.
| Referência | O que diz | O que isso significa na prática | Fonte |
|---|---|---|---|
| Grafana v13.2, boas práticas de painéis | Cada painel deve contar uma história ou responder a uma pergunta e ser fácil de ler sob pressão. Para serviços, o método RED (taxa, erros, duração). Para recursos de infraestrutura, o método USE (utilização, saturação, erros). Evitar copiar painéis; o gráfico empilhado pode induzir a erro. | Um painel por público e por pergunta. Para a gestão, tendência e disponibilidade; para o plantão, estado agora. | Grafana, documentação oficial v13.2, consulta em 23/10/2026 |
| Grafana v13.2, boas práticas de alertas | Alertas devem apontar um problema real e ser acionáveis. Alertar primeiro por falhas que o usuário sente, e deixar CPU e memória para diagnóstico. Usar período de pendência para filtrar picos. Todo alerta deve ter dono (uma equipe responsável) e escopo. Anexar painéis e procedimentos (runbooks). | Alerta sem dono, sem pendência e sem procedimento vira ruído. O Grafana oferece os campos; a empresa precisa preenchê-los. | Grafana, documentação oficial v13.2, consulta em 23/10/2026 |
| Grafana v13.2, fundamentos de alertas | Uma regra de alerta combina consultas e uma condição e gera uma instância por série de dados. Pontos de contato (contact points) definem o destino. Políticas de notificação formam uma árvore que roteia por rótulos. Silêncios pausam uma vez; períodos de silêncio recorrentes (mute timings) pausam em horários fixos. | A rota do alerta é tão importante quanto a regra: é ela que decide quem é acionado. | Grafana, documentação oficial v13.2, consulta em 23/10/2026 |
| Livro de SRE do Google, cap. 6 | O monitoramento responde a duas perguntas: o que está quebrado (sintoma) e por quê (causa); vale gastar mais esforço em sintomas. | É o fundamento de painéis do usuário (RED) e de alertas por sintoma. | Google, SRE book, cap. 6 (publicação aberta) |
Métodos RED e USE
- RED (para serviços)
- Rate: taxa de pedidos
- Errors: erros
- Duration: duração
- USE (para infraestrutura)
- Utilization: utilização
- Saturation: saturação
- Errors: erros
O plano
Plano em 3 passos
- Escolher a fonte e a pergunta de cada público
Ligue o Grafana às fontes que já existem, como Zabbix (por plugin) ou Prometheus. Antes de desenhar, escreva a pergunta de cada público: a gestão quer disponibilidade por serviço e tendência; o plantão quer o que exige ação agora; o time técnico quer detalhe para investigar.
- Desenhar um painel por pergunta, com dono e data
Use RED para serviços e USE para infraestrutura, evite cópias (use variáveis em um painel mestre), mantenha o empilhado desligado por padrão e registre dono e data em cada painel. Defina quem edita e versione o JSON dos painéis.
- Criar alertas com dono, rota e pendência
Para cada regra, nomeie a equipe responsável, o escopo, o período de pendência, o ponto de contato e o procedimento. Defina onde cada alerta mora (Zabbix ou Grafana) para não haver regra duplicada. Revise a lista de painéis e de alertas em um dia fixo do mês.
Painéis por público
- Gestão (tendência)
- disponibilidade por serviço
- incidentes por severidade
- Operação (agora)
- estado por serviço
- alertas com dono
- Time técnico (investigação)
- séries detalhadas
- filtros por host
Serviço relacionado: pilar Operações confiáveis.
Escopo em proposta escrita
Como a RStack atua como guia e parceira
Escopo, entregas e valores só aparecem em proposta escrita. Não há prazo nem resultado prometido neste guia.
- Diagnóstico dos painéis e alertas existentes: o que é usado, o que é cópia e o que não tem dono.
- Desenho de painéis por público (gestão, plantão, time técnico) e dos indicadores, com a empresa decidindo as metas.
- Implantação ou revisão do Grafana, com fontes como Zabbix e Prometheus, conforme escopo em proposta.
- Desenho de alertas com dono, rota e procedimento, integrados ao atendimento.
- Relatório mensal previsto em contrato, gerado a partir dos mesmos dados dos painéis.
- Escopo, entregas e níveis de serviço ficam em proposta escrita. Não há prazo nem resultado prometido neste guia.
- Estado deste guia: revisado em . Aprovado por: aprovação pendente. Comandos, configurações e telas descritos aqui seguem a documentação oficial e não testado em ambiente próprio.
Painéis por público (proposta da empresa, a validar)
Ponto de partida para conversar com o seu time. Não há número nem meta aqui.
| Público | Pergunta que o painel responde | Conteúdo típico | Quando consultar |
|---|---|---|---|
| Gestão e diretoria | Os serviços estão disponíveis e para onde a tendência aponta? | Disponibilidade por serviço no mês, incidentes por severidade, itens abertos | Mensal e em revisões |
| Operação e plantão | O que exige ação agora? | Estado atual por serviço, alertas ativos com dono, manutenções em curso | Durante o turno |
| Time técnico | Por que isso aconteceu e onde? | Séries detalhadas, filtros por host e serviço, comparação com períodos anteriores | Na investigação |
O que evitar nos painéis e nos alertas
- Um painel para todos os públicos: separe gestão, plantão e time técnico.
- Copiar o painel a cada pequena mudança: use variáveis ou parâmetros de URL em um painel mestre.
- Gráfico empilhado por padrão: a documentação alerta que pode induzir a erro.
- Alertar por causa em vez de sintoma: CPU alta raramente corresponde a dano ao usuário.
- Regra duplicada no Zabbix e no Grafana: escolha onde cada alerta mora e registre.
- Painel sem dono nem data: marque os temporários e apague ao fim.
- Alerta sem período de pendência: um pico curto não é incidente.
- Alerta que ninguém revisa: ajuste ou remova.
Quando faz sentido
Você provavelmente precisa quando
- Os dados de monitoramento existem, mas só quem opera a ferramenta consegue lê-los.
- A gestão pede um número de disponibilidade e o time monta a resposta à mão, todo mês.
- Há mais de uma fonte (por exemplo, Zabbix e Prometheus) e se quer uma visão única.
- Existem muitos painéis copiados, sem dono e sem data.
- Os alertas chegam sem contexto e sem responsável.
Honestidade
Quando não contratar
Se você tem poucos indicadores e a ferramenta de monitoramento já mostra o que o time precisa, um painel a mais só cria mais um lugar para manter. Também não use o Grafana para duplicar regras de alerta que já funcionam bem na ferramenta de origem: duas fontes de verdade geram duas contagens do mesmo problema.
Glossário
Termos que aparecem neste guia
Painel (dashboard)
Tela com gráficos e indicadores, desenhada para responder a uma pergunta.
Fonte de dados (data source)
Sistema que o Grafana consulta, como Zabbix ou Prometheus.
RED
Método para serviços: taxa de pedidos, erros e duração.
USE
Método para recursos de infraestrutura: utilização, saturação e erros.
Regra de alerta
Consulta mais condição que, quando atendida, gera um alerta.
Ponto de contato (contact point)
Destino do alerta: e-mail, webhook, ferramenta de incidentes.
Política de notificação
Árvore que roteia alertas por rótulos até o ponto de contato certo.
Período de pendência
Tempo que a condição precisa durar antes de o alerta disparar, para filtrar picos.
Silêncio e período de silêncio
Pausam notificações, uma vez ou em horários recorrentes, sem parar a avaliação da regra.
Depois
O que muda depois
- Cada público abre um painel que responde à sua pergunta.
- O relatório de disponibilidade deixa de ser montado à mão: sai dos mesmos dados.
- Todo alerta tem equipe responsável, rota e procedimento.
- A lista de painéis é revisada em dia fixo; o que não tem dono é apagado.
- O que não muda: o Grafana mostra o que as fontes coletam. Se o dado é ruim, o painel é ruim. O trabalho está em definir o que medir.
FAQ
Perguntas frequentes
O Grafana substitui o Zabbix?
Não. O Grafana consulta e mostra; o Zabbix coleta e avalia regras. O plugin do Zabbix permite usar dados do Zabbix dentro do Grafana.
Como ligo o Grafana ao Zabbix?
Por um plugin de fonte de dados (alexanderzobnin-zabbix-app), com documentação própria. Em geral, use no Zabbix uma conta com permissão de leitura apenas nos grupos de hosts necessários. Confira a versão compatível e o endereço da API na página do plugin. não testado
Quem pode editar os painéis?
A documentação trata edição aberta a todos como sinal de baixa maturidade. Defina quem edita e use versionamento do JSON dos painéis.
O que são os métodos RED e USE?
RED (taxa, erros, duração) descreve o que o usuário sente de um serviço. USE (utilização, saturação, erros) descreve o estado de um recurso de infraestrutura. O Grafana recomenda alertar por sintomas, ligados aos painéis RED.
Como evito alerta duplicado entre Zabbix e Grafana?
Defina uma fonte de verdade por alerta e registre. Regras de trigger do Zabbix ficam no Zabbix; no Grafana, crie regras sobre o que só ele consulta.
Qual a diferença entre silêncio e período de silêncio?
Silêncio pausa notificações uma vez, como numa manutenção. Período de silêncio (mute timing) pausa em horários recorrentes, como noites e fins de semana. Nos dois casos a regra continua sendo avaliada.
Grafana na nuvem do fornecedor ou instalado por nós?
As duas opções têm documentação própria e diferenças de recursos e de custo. Compare na documentação oficial de cada uma e decida pelo seu requisito de dados. conteúdo a validar
Por que o gráfico empilhado é problema?
A documentação oficial avisa que o empilhado pode ser enganoso e esconder dados importantes, e recomenda mantê-lo desligado na maioria dos casos.
Devo alertar por CPU alta?
Em geral, não como primeira escolha. A documentação sugere alertar pelo que o usuário sente (erros, latência, disponibilidade) e deixar CPU e memória para diagnóstico e canais de menor severidade.
O Grafana serve para o relatório mensal?
Os mesmos dados dos painéis alimentam o relatório mensal previsto em contrato. O formato e as metas são definidos em proposta.
Fontes
Onde conferir
- Grafana v13.2, boas práticas de painéis, consulta em 23/10/2026
- Grafana v13.2, fundamentos de alertas, consulta em 23/10/2026
- Grafana v13.2, boas práticas de alertas, consulta em 23/10/2026
- Grafana v13.2, configurar a fonte de dados Prometheus (lida em consulta anterior; reconferir), consulta em 23/10/2026
- Plugin do Zabbix para o Grafana (alexanderzobnin-zabbix-app) (lida em consulta anterior; reconferir versão e endereço da API), consulta em 23/10/2026
- Google, SRE book, cap. 6: Monitoring Distributed Systems (citado por paráfrase), consulta em 23/10/2026
Consultado em 23/10/2026. Onde o texto diz "fonte secundária" ou "URL não conferida na fonte oficial", a fonte oficial ainda não foi aberta. conteúdo a validar
Próximo passo
Monte um painel por pergunta, e não por ferramenta
Diga quem olha o painel e que decisão ele deveria apoiar. Voltamos por escrito com o desenho do painel e dos alertas com dono.
Conversa inicial sem compromisso; o diagnóstico é pago e só começa depois que você aprova a proposta escrita.
Prefere começar devagar?