Grafana, gráficos e alertas

Esta é a referência técnica de dashboards, consultas e regras. Para uma introdução sem SQL ou programação, leia como interpretar os painéis e alertas e Admin.

Grafana consulta o PostgreSQL. Ele não lê os inversores e não é o responsável por persistir medições.

Dashboards versionados

Dashboard	Uso
Energia Solar - IFSP Campus Boituva	Visão institucional de potência, energia e comparação
Inverters	Seleção de inversor e investigação de grandezas
Telemetry Generic	Exploração por dispositivo e métrica
Galeria de visualizações — DEMONSTRAÇÃO	Catálogo de 54 visualizações em dez seções, com dados fictícios

As definições de dashboards ficam em grafana/dashboards/, em arquivos JSON. São a referência dos cálculos descritos aqui; a versão aplicada em cada ambiente depende do deploy.

A galeria usa exclusivamente a fonte nativa TestData, sem consultar a telemetria operacional. Potências, temperaturas, metas, estados e posições do mapa são inventados. As cores não representam critérios de alerta aprovados; o mapa não localiza equipamentos do campus. O catálogo técnico está em docs/grafana-galeria.md no repositório. O acesso ao Grafana depende das permissões concedidas.

Consultas que respeitam o dado

Energia diária é contador: o institucional usa o máximo diário por inversor e soma esses resultados, sujeito a cobertura e resets. Não somar todas as amostras de um acumulado.

“Último no período” não é sempre “atual”. O institucional usa uma janela de dez minutos para potência recente. Contadores podem ser mais antigos. Pico agregado por buckets é aproximado, não uma soma comprovada de máximos simultâneos.

Qualificar colunas em JOIN e conferir unidades, fuso, filtros de active e lacunas. Compare equipamentos de capacidades diferentes com contexto.

Regra única do Grafana

A1 — inversor sem geração observada por 30 minutos. Abrange devices ativos Solis, SAJ e Ingeteam, das 08h às 17h de São Paulo; primeira cobrança às 08h30. Não depende dos códigos de status nem da geração de pares. Sem potência positiva válida recente, inclusive por falta de dados, produz a condição de disparo. Não há pending extra: avaliação a cada minuto.

Recuperação de 3 min após potência positiva. A condição também encerra fora do horário, sem confirmar reparo. NaN, infinidades e timestamps futuros não são prova de geração. Não é uma regra de eficiência ou diagnóstico elétrico. NoData para frota vazia é normal; erro de consulta continua erro. Um inversor elegível sem dados permanece representado na consulta.

O provisioning rules-telemetry.yml contém a regra e a exclusão explícita dos oito UIDs anteriores. Reaplicar preserva o novo UID e não remove regras de terceiros. O canal de e-mail usa configuração do ambiente; disparo não comprova recebimento.

Configuração e consulta administrativa

As regras podem ser preparadas na interface do Grafana ou em arquivos de provisioning. IA pode ajudar a elaborar o SQL e a configuração, mas a regra precisa de revisão e teste; quem a avalia é o Grafana.

O Admin oferece catálogo e estado resumido do alerta único, não edição. Avaliação ausente, antiga ou indisponível aparece como desconhecida.

Esta documentação não expõe destinatários, credenciais SMTP ou links privados.

Referência externa: avaliação de regras no Grafana.

Revisão: 10/11/2026. Base: JSONs dos dashboards, docs/grafana-galeria.md, rules-telemetry.yml, alerts.tsx e alerts/status.ts.