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 API de Exportação de Métricas.
- Para consultar ou construir as suas próprias séries calculadas de forma programática, utilize o MiroxQL ou a API de exportação.
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 de exportação limpas e agregadas diariamente. É 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.
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.
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 |
| MiroxQL | As mesmas métricas em bruto, consultadas e combinadas nas suas próprias séries calculadas | Consultas programáticas ou personalizadas sobre os seus dados |
| API de Exportação de Métricas | Métricas limpas e agregadas diariamente em CSV ou JSON | 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
- API de Exportação de Métricas — métricas agregadas e prontas para exportação para relatórios
- Linguagem de Consulta MiroxQL — consulte os seus dados em bruto e defina métricas calculadas personalizadas