Utilizar o Grafana como Plataforma Externa de Leitura

O Mirox provisiona um Grafana pronto a usar para os seus dados e liga-o por si, para que possa abrir um espaço de trabalho de visualização completo para qualquer central com um clique — sem login do Grafana, instalação ou configuração de fonte de dados em separado. Este guia explica-lhe como aceder ao Grafana e ler os seus dados; para saber o que a incorporação faz nos bastidores, consulte Visualização de Gráficos.

Quando Utilizar o Grafana

Utilize o Grafana quando quiser explorar as medições em bruto por trás dos números principais — curvas de potência, contadores de energia, entradas meteorológicas e sinais ao nível dos componentes — com o intervalo de tempo e a resolução que escolher.

Para resumos de desempenho calculados (produção, perdas, disponibilidade, produção específica), utilize antes as vistas de KPI na plataforma — o Grafana representa as séries em bruto, não os KPI pré-agregados.
Para extrair dados em CSV ou JSON para folhas de cálculo e relatórios, utilize a exportação de métricas.
Para definir um indicador calculado próprio, crie uma métrica da sua organização. É escrita na linguagem de consulta com que são lidas as séries em bruto no Grafana.

Lê as Métricas em Bruto

O Grafana provisionado funciona sobre as mesmas métricas em bruto recolhidas que a plataforma regista a partir das suas centrais — séries de alta frequência e multidimensionais — e não sobre as métricas da coleção, que os relatórios e a exportação de métricas leem com uma leitura definida. É precisamente por isso que é a ferramenta certa para inspecionar um sinal em detalhe.

Os nomes não são etiquetas

As séries transportam as identidades dos componentes (inverter_id, gak_id, string_number), nunca os nomes atribuídos no Mirox — renomear um componente no Mirox não altera nada no Grafana, nem retroativamente nem para dados novos. Os nomes atuais chegam a uma legenda através das séries de informação (powerplant_inverter_info …); o padrão está em Criar os seus próprios painéis Grafana.

Onde é Provisionado o Grafana

O Grafana é provisionado por carteira. Quando cria uma carteira, os seus painéis são configurados automaticamente e ficam acessíveis de imediato — não tem de esperar por uma sincronização em segundo plano e não configura nenhuma fonte de dados.

Cada central a que tem acesso fica acessível através do painel da sua carteira, limitada a essa central. Só vê gráficos das centrais que a sua função lhe concede; a visibilidade segue as mesmas regras de permissão do resto da plataforma.

Isso inclui a exigência de dois fatores de uma organização. Se a organização proprietária de uma central exigir autenticação de dois fatores (2FA) e a sua conta não tiver segundo fator, os painéis dessa central não ficam disponíveis para si. Depois de ativar o 2FA, o Grafana acompanha a mudança em cerca de uma hora. Consulte Política de Segurança da Organização.

Disponível em Produção

A ligação ao Grafana está ativa no ambiente de produção. Se estiver a trabalhar num ambiente que não seja de produção, a ligação é apresentada mas está desativada.

Abrir o Grafana para uma Central

O Grafana abre a partir da navegação da central, limitado à central que tiver selecionado.

Abra a central que pretende visualizar.
Abrir no Mirox: service.mirox.io/#/monitor/solar/0/production
Na secção Site da barra lateral, clique em Grafana.
O Grafana abre num novo separador do navegador, já com sessão iniciada através da sua sessão Mirox e já a mostrar o painel de visão geral da central.

Sem Segundo Login

A sua sessão Mirox transita para o Grafana — não há nenhum nome de utilizador, palavra-passe, URL de servidor ou token separado para introduzir antes de poder visualizar uma central.

O Grafana não tem um início de sessão próprio. Fica aberto enquanto o seu início de sessão Mirox estiver ativo, e fecha com ele:

Quando termina a sessão no Mirox, ou quando o seu início de sessão termina, um painel aberto deixa de carregar dados. Os seus gráficos mostram erros até voltar a iniciar sessão no Mirox e reabrir o painel.
A duração de um início de sessão é definida pela sua organização. Se a sua organização tiver definido um intervalo de reverificação 2FA, uma conta com 2FA (aplicação de autenticação ou passkey) tem, além disso, de voltar a iniciar sessão a esse intervalo. Consulte Política de Segurança da Organização.

Ecrãs de Parede

Um painel num ecrã de parede que funciona com uma conta pessoal fica com a sessão terminada quando o início de sessão dessa conta termina. Alguém tem então de voltar a iniciar sessão no ecrã. O Grafana que o Mirox disponibiliza não tem uma conta nem um token separados para ecrãs, por isso tenha isto em conta ao montar um ecrã que deva funcionar sem supervisão.

Ler os Seus Dados

O painel abre na vista de visão geral da central e dá-lhe o conjunto de ferramentas padrão do Grafana aplicado às métricas da sua central:

Escolher um intervalo de tempo — escolha qualquer janela e, depois, aplique zoom e deslocação até ao momento de interesse.
Ajustar a resolução — veja amostras em bruto detalhadas para uma curva de potência ou agregados mais grosseiros para tendências de longo prazo.
Ler valores exatos — passe o rato ou clique numa série para ler o valor num determinado momento.
Comparar sinais — represente em conjunto métricas com unidades diferentes (por exemplo, potência face a irradiância).

O painel chega já limitado à central para a qual o abriu, pelo que a produção e os sinais principais dessa instalação já estão à vista.

Crie os Seus Próprios Dashboards — Nunca Edite o Fornecido

Portfolio Overview - <portefólio> é gerido pela Mirox e é substituído sempre que uma nova versão do template é lançada — qualquer painel que adicione ou consulta que altere nele perde-se. Para personalizar, guarde uma cópia (Edit → Save as copy) ou crie um novo dashboard na organização Grafana do portefólio; as cópias e os seus próprios dashboards nunca são tocados. Como o Grafana está estruturado por portefólio, quem pode editar e como as séries da plataforma devem ser lidas para dar números corretos está explicado em Criar os seus próprios dashboards Grafana. Os dashboards fornecidos em si são descritos em Visualização de Gráficos.

Distinção de Superfícies Relacionadas

É fácil confundir os locais onde os dados de métricas aparecem no Mirox. Cada um serve uma necessidade diferente:

Superfície	O que mostra	Quando utilizar
Grafana provisionado	Séries temporais em bruto e agregadas em gráficos interativos, pré-ligadas às suas centrais	Investigar um sinal em detalhe dentro do Mirox, sem nada para configurar
Métricas	Indicadores que a sua organização define sobre as séries de 15 minutos	Indicadores próprios, em relatórios e exportações
Exportação de métricas	As métricas da coleção em CSV ou JSON, em passos de 1 minuto a um ano	Extrair dados para folhas de cálculo, relatórios ou ferramentas externas

Documentação Relacionada

Criar os seus próprios dashboards Grafana — estrutura por portefólio, direitos de edição, a regra «copiar, não editar» e como ler corretamente as séries
Visualização de Gráficos — como funciona a superfície Grafana incorporada e que painéis são fornecidos
Exportação de métricas — exporte qualquer métrica como série temporal
Métricas — defina indicadores calculados próprios
Política de Segurança da Organização — quanto tempo dura um início de sessão e quando é exigido o 2FA
Segurança da conta — Perguntas frequentes — porque é que a sua sessão foi terminada e porque podem faltar centrais