Prometheus
Séries são identificadas por nome e labels. O poder do PromQL vem com risco de cardinalidade.
Ponto técnico 1
Modelo: Séries são identificadas por nome e labels. O poder do PromQL vem com risco de cardinalidade.
Ponto técnico 2
PromQL: Valide consultas progressivamente no Explore antes de levá-las a dashboards ou alertas.
Ponto técnico 3
Labels: Evite valores quase únicos como labels; cardinalidade afeta armazenamento e consulta.
Ponto técnico 4
Counters: Use rate/increase quando semanticamente adequado e respeite scrape interval.
Ponto técnico 5
Alerting: Mantenha labels de roteamento e annotations com contexto e runbook.
Ponto técnico 6
Diagnóstico: No data pode ser query, label, janela, scrape falhando ou métrica inexistente.
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
rate(node_network_receive_bytes_total[5m])
sum by (instance) (rate(node_network_receive_bytes_total[5m]))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.
Sintoma → escopo → camada → evidência → hipótese → validação
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.
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.
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.