Grafana · Administração

Configuração

Pacotes DEB/RPM usam /etc/grafana/grafana.ini. Environment variables podem sobrescrever valores; documente precedência.

Ler módulo Índice técnico

grafana://Administração

$ platform: Grafana

$ topic: Configuração

$ mode: production

$ method: evidence-first_

Escopo técnico

Configuração

Pacotes DEB/RPM usam /etc/grafana/grafana.ini. Environment variables podem sobrescrever valores; documente precedência.

01 · Administração

Ponto técnico 1

grafana.ini: Pacotes DEB/RPM usam /etc/grafana/grafana.ini. Environment variables podem sobrescrever valores; documente precedência.

02 · Administração

Ponto técnico 2

Server/root_url: domain, root_url, protocol e http_port precisam refletir proxy e URL pública; erros afetam redirects, OAuth e links.

03 · Administração

Ponto técnico 3

Database: Defina type, host, name, user, TLS e pool. Use usuário dedicado.

04 · Administração

Ponto técnico 4

SMTP: Teste DNS, porta, TLS, autenticação e remetente; e-mail de alerting depende disso.

05 · Administração

Ponto técnico 5

Logs: Debug é ferramenta temporária. Em produção, use nível adequado e centralização.

06 · Administração

Ponto técnico 6

Segredos: Não versione passwords/tokens. Restrinja grafana.ini e use secret management apropriado.

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.

Comandos / fluxo de referência

[server]
domain = grafana.exemplo.local
root_url = https://grafana.exemplo.local/

[database]
type = postgres
host = db-grafana:5432
name = grafana
user = grafana

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

Registre um baseline saudável.
Induza uma falha controlada relacionada ao tema.
Identifique a camada com falha antes de reiniciar componentes.
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.