CIRCUITO
CARIOCA TI · DOCUMENTAÇÃO
♙
Grafana · Fundamentos

Introdução

Grafana é a camada de consulta, visualização, exploração e alerting. Data sources consultam dados onde eles já vivem; Grafana não deve ser confundido com coletor ou banco de métricas.

grafana://Fundamentos
$ platform: Grafana
$ topic: Introdução
$ mode: production
$ method: evidence-first_
Escopo técnico

Introdução

Grafana é a camada de consulta, visualização, exploração e alerting. Data sources consultam dados onde eles já vivem; Grafana não deve ser confundido com coletor ou banco de métricas.

01 · Fundamentos

Ponto técnico 1

Conceito: Grafana é a camada de consulta, visualização, exploração e alerting. Data sources consultam dados onde eles já vivem; Grafana não deve ser confundido com coletor ou banco de métricas.

02 · Fundamentos

Ponto técnico 2

Grafana 13.2: Esta base usa Grafana 13.2 como referência. A linha 13 trouxe Dynamic Dashboards e Git Sync GA; mudanças de versão exigem revisão de breaking changes.

03 · Fundamentos

Ponto técnico 3

Papel no NOC: Combine Zabbix, Prometheus, SQL, Loki e outras fontes em visões orientadas a impacto, tendência e diagnóstico.

04 · Fundamentos

Ponto técnico 4

Limites: Grafana não substitui automaticamente Zabbix, Prometheus, Loki ou SIEM. Separe coleta, retenção, visualização, alerta e resposta.

05 · Fundamentos

Ponto técnico 5

Prática: Construa um fluxo completo: fonte → query → painel → variável → alerta → investigação.

06 · Fundamentos

Ponto técnico 6

Erros comuns: Começar pelo visual sem definir pergunta; importar dashboard sem entender query; dar Editor para todos; usar credenciais privilegiadas.

Aplicação em produção

Procedimento de engenharia

Escopo e impacto

Defina serviço, owner, estado esperado e impacto antes de alterar o monitoramento.

Evidência primeiro

Valide fonte, caminho, credenciais, baseline e timestamps antes de alterar thresholds.

Mudança controlada

Altere uma variável por vez e mantenha um caminho de rollback.

Manutenção

Rotina operacional recomendada

  • Revise estados críticos, lacunas de coleta e falhas de entrega a cada turno.
  • Revise alertas ruidosos, objetos lentos, credenciais e erros recorrentes semanalmente.
  • Revise versões, backup/restore, permissões e capacidade periodicamente.
Troubleshooting por evidências

Sintoma → escopo → camada → evidência → hipótese → validação

Capture logs, timestamps, saídas e topologia antes da ação corretiva sempre que possível.
Laboratório guiado

Construa, quebre, diagnostique e recupere

  1. Registre um baseline saudável.
  2. Induza uma falha controlada relacionada ao tema.
  3. Identifique a camada com falha antes de reiniciar componentes.
  4. Corrija a causa identificada e valide a recuperação.
Checklist de produção

Pronto para produção?

Responsabilidade

Objetivo, escopo e owner estão definidos.

Segurança

Credenciais e integrações seguem menor privilégio.

Validação

Falha e recuperação foram testadas e documentadas.

Versão e referências

Documentação sensível à versão

Referência editorial revisada para Grafana 13.2. Recursos, APIs, breaking changes, plugins e comportamento de HA devem ser reconfirmados na documentação da versão efetivamente instalada.