Alertas e administração

Os gráficos ajudam a explorar o histórico. Os alertas acompanham condições definidas e chamam atenção quando elas persistem. O Admin organiza informações administrativas e permite consultar um resumo dessas regras.

Como um alerta funciona

O Grafana consulta os dados armazenados a cada minuto, aplica a condição de uma regra e observa por quanto tempo ela permanece verdadeira. Quando o tempo exigido é atingido, a regra entra em estado de alerta.

Essa espera reduz avisos por ocorrências momentâneas. Um alerta pode encaminhar uma notificação conforme o canal e os destinatários configurados; disparar não comprova que alguém recebeu o aviso.

Qual situação o alerta acompanha?

A release começa com um único alerta: um inversor ativo ficou 30 minutos sem geração observada, incluindo falta de dados. Ele acompanha Solis, SAJ e Ingeteam entre 08h e 17h (horário de São Paulo), com tolerância inicial até 08h30.

Qualquer leitura válida de potência maior que zero conta como evidência de geração. A regra não mede eficiência e não depende de outro inversor estar funcionando. Também cobre ausência simultânea de todos os equipamentos, com uma instância por inversor da mesma regra.

Os 30 minutos já são medidos na consulta: não são somados a outra espera de 30 minutos. O Grafana avalia a cada minuto; a notificação tem ainda o tempo de agrupamento e entrega. O retorno de potência positiva inicia uma recuperação de três minutos. Às 17h a condição também termina: essa resolução por horário não confirma que o equipamento foi reparado.

Sem geração observada pode significar baixa luminosidade, falha de coleta/comunicação ou parada do inversor. Se o próprio servidor cair, ele não consegue enviar este alerta.

Como interpretar o estado apresentado

Estado	Significado
Normal	A avaliação disponível não aponta a condição de disparo.
Pendente	A condição apareceu, mas ainda não completou o tempo exigido.
Disparando	A condição persistiu e a regra entrou em alerta.
Em recuperação	A condição cessou e a regra aguarda o período de recuperação.
Desconhecido	O Admin não tem uma avaliação confiável e recente para apresentar.
Sem dados / erro / pausada	O estado exige consultar a avaliação ou a configuração da regra; não equivale a geração zero.

Uma regra pode ter várias instâncias, como avaliações separadas por inversor. O resumo do Admin não substitui o detalhe no Grafana nem é um histórico de notificações.

Silêncio de comunicação não comprova defeito elétrico. Uma regra normal também não certifica todos os equipamentos: o tratamento de ausência de dados depende da configuração da regra.

Para que serve o Admin?

O Admin é uma interface autenticada para responsáveis autorizados. Não há cadastro público.

Área	O que permite
Dispositivos	Consultar o catálogo e editar nome, marcação ativo/inativo e informações descritivas.
Métricas	Consultar e revisar unidade, descrição e marcação ativo/inativo.
Alertas	Ler a descrição do alerta único e consultar o estado resumido da avaliação.
Auditoria	Consultar quem fez alterações, quando e quais campos foram alterados.
Administradores	Gerenciar outras contas administrativas, respeitando as proteções da aplicação.

O catálogo é formado a partir da telemetria recebida. As edições humanas permitidas são preservadas quando chegam novas mensagens.

O que as ações administrativas não fazem

• Marcar um dispositivo como inativo no catálogo não desliga o inversor nem altera a habilitação da fonte física.
• Trocar uma unidade no catálogo não converte os valores históricos.
• Editar uma descrição não muda o protocolo ou as grandezas coletadas.
• A tela de alertas não cria nem edita regras. Essa configuração pertence ao Grafana ou aos arquivos de configuração do projeto.
• O Admin não envia comandos elétricos aos inversores.

As alterações são restritas e auditadas. Operações de manutenção exigem autorização própria; conhecer a interface não concede permissão para alterar o sistema.

Continue a leitura

Consulte o escopo do sistema e o glossário. Para aprofundar, veja Grafana e alertas, API administrativa e segurança do Admin.

Revisão: 10/11/2026. Fontes: rules-telemetry.yml; apps/admin/web/src/app.tsx, devices.tsx, metrics.tsx, alerts.tsx, types.ts; apps/admin/src/alerts/status.ts e documentação do Admin.