Criar os seus próprios dashboards Grafana

O Grafana disponibilizado não é apenas de leitura. Cada portefólio tem o seu próprio espaço de trabalho Grafana, no qual pode construir dashboards sobre as mesmas séries temporais em bruto que a plataforma regista — desde que respeite uma regra: o dashboard de resumo fornecido pela Mirox é gerido e é substituído em cada rollout de versão, pelo que deve construir os seus próprios dashboards como cópias, nunca editando-o. Este guia explica como o Grafana está estruturado, o que pode alterar e como as séries temporais da plataforma devem ser lidas para dar números corretos.

Se apenas quiser abrir o dashboard fornecido, consulte Utilizar o Grafana como Plataforma Externa de Leitura. Para o catálogo de métricas, consulte Recolha de Métricas.

Como o Grafana está estruturado

Uma organização Grafana por portefólio

A Mirox disponibiliza uma organização Grafana por portefólio, com o nome <organização> - <portefólio>. Tudo o que está dentro dela é partilhado pelos membros do portefólio:

• Uma fonte de dados (<organização> - <portefólio>), limitada às centrais desse portefólio. Cada consulta que escreve corre contra esta fonte de dados e só consegue ver as centrais do portefólio — não há nada a configurar nem nada que possa escapar.
• Um dashboard gerido, Portfolio Overview - <portefólio>, fornecido pela Mirox (ver abaixo).
• Os seus próprios dashboards e pastas, visíveis para todos os que podem ver o portefólio.

Como o portefólio é a unidade de partilha de recursos, uma central que pertence a vários portefólios é acessível a partir de cada uma das suas organizações Grafana, e um dashboard que construa num portefólio não aparece noutro. Coloque um dashboard onde as pessoas que precisam dele são membros.

Quem pode ver e quem pode editar

A pertença ao Grafana segue as permissões da plataforma e é atualizada automaticamente sempre que estas mudam — não existe uma gestão de utilizadores Grafana separada:

As pertenças e as funções são sincronizadas quando uma permissão é concedida ou revogada; uma sessão Grafana aberta é atualizada, pelo que um editor recém-promovido não precisa de terminar sessão e voltar a entrar.

O dashboard de resumo gerido

Portfolio Overview - <portefólio> é gerado pela Mirox a partir de uma versão de template publicada. As tags do dashboard transportam a versão (mirox-template-v<N>) e a sua descrição indica o conteúdo exato publicado. Os administradores Mirox lançam novas versões a partir da área de administração da plataforma, e um rollout elimina e recria o dashboard — é isto que mantém cada portefólio num template conhecido e testado.

O que fazer em vez disso:

1. Abra o dashboard gerido e use Edit → Save as copy (ou Export → Export as JSON e Import) para criar a sua própria cópia com um nome novo. Coloque-a numa pasta sua.
2. Construa sobre a cópia: adicione painéis, altere consultas, adicione variáveis. A cópia é sua — nenhum rollout lhe toca.
3. Depois do rollout de uma nova versão do template, abra uma vez o dashboard gerido para ver se ganhou painéis que queira transportar para a sua cópia.

O mesmo se aplica a qualquer dashboard que crie de raiz: tudo o que não seja o resumo gerido é deixado intacto pela plataforma.

Ler corretamente as séries temporais

O Grafana mostra o que uma consulta devolve, pelo que uma leitura errada parece exatamente igual a uma correta. As regras abaixo são as que a própria plataforma segue nos seus relatórios; um dashboard personalizado que as respeite mostra os mesmos números que as páginas de relatórios.

Labels: o que é uma série

Cada série é identificada pelo seu nome de métrica mais as suas labels. As labels pelas quais vai filtrar e agrupar:

Duas coisas deliberadamente não são labels: os nomes dos componentes (ver a secção seguinte) e as unidades — cada valor é armazenado em unidades SI base: W, Wh, V, A, Hz, °C, W/m², Wh/m². Defina a unidade do Grafana como watt / watt-hour e deixe o Grafana escalar para kW / MWh; nunca divida na consulta.

Mostrar os nomes atuais dos componentes

A telemetria transporta identificadores de componentes, não nomes: uma renomeação na Mirox não deve dividir uma série em «antes» e «depois». Os nomes atuais são publicados como séries de informação próprias — powerplant_inverter_info, powerplant_gak_info, powerplant_string_info, powerplant_feedin_info, powerplant_turbine_info — indexadas exatamente como a telemetria e com o nome como label (inverter_name, gak_name, string_name, meter_name, turbine_name). Junte-as à telemetria com o seguinte padrão (é o que o dashboard gerido faz):

sum by (inverter_id, inverter_name) (
  (
    powerplant_inverter_power_ac{park="${park}"}
    * on (park, inverter_id) group_left(inverter_name)
    sgn(topk_last(1, last_over_time(powerplant_inverter_info{park="${park}"}[7d] @ (now()))) by (park, inverter_id))
  )
  or on (park, inverter_id) powerplant_inverter_power_ac{park="${park}"}
)

Como funciona: last_over_time(...[7d] @ (now())) escolhe para cada componente o ponto de informação mais recente no instante atual, pelo que uma renomeação se reflete em qualquer intervalo de tempo; sgn() transforma-o num 1 que a multiplicação mantém; group_left(inverter_name) copia o nome para a telemetria; e o ramo or on (...) mantém um componente visível (pelo seu identificador) se ainda não tiver série de informação. Para uma caixa de junção junte por (park, inverter_id, gak_id) com gak_name; para uma string por (park, inverter_id, gak_id, string_number) — a série de informação só transporta gak_id quando a string está atrás de uma caixa de junção, tal como a telemetria. Nunca grafique, some ou crie alertas sobre uma série de informação em si.

As quatro formas de uma série

O motor de relatórios lê cada série de uma de quatro maneiras. Use a mesma leitura e o seu dashboard concordará com as páginas de relatórios.

Totais da central e componentes

As séries analíticas derivadas de uma fonte (modelos, potência esperada, performance ratio, restrição) existem ao nível da central e uma vez por segmento. Selecione a série ao nível da central com segment_id!~".+", ou uma central segmentada é lida N + 1 vezes. O mesmo se aplica à liquidação eólica onshore: os pontos por turbina transportam turbine_id, a soma do parque não transporta nenhum — use turbine_id!~".+" para a via do parque.

Para painéis por componente agrupe pelas labels de identidade e, onde quiser nomes, junte as séries de informação como mostrado acima. A potência modelada e o PR por componente (powerplant_<source>_inverter_power, powerplant_<source>_inverter_pr e os gémeos gak / string) existem para as fontes pyranometer e weather.

Códigos de estado e estados

powerplant_inverter_vendor_status, powerplant_turbine_vendor_status, battery_*_vendor_status são os códigos do próprio fabricante: uma lacuna significa «não lido», e o valor é um código, nunca uma grandeza — não os some nem calcule a média. powerplant_inverter_operating_state e powerplant_turbine_operating_state são os estados padrão da plataforma (0 desconhecido … 8 falha), numerados para que max by (inverter_id) se leia como «o pior estado no intervalo». Mostre-os com um value mapping do Grafana em vez de uma linha.

Armadilhas comuns

• last_over_time(...[30y]) para obter «o último valor» percorre toda a retenção em cada atualização. Use uma janela adequada à cadência da série — [1h] para uma medida ao minuto, [1d] para um valor diário, [7d] para as séries de informação.
• Filtrar por nomes (inverter_name="WR 01") deixa de funcionar após uma renomeação. Filtre por inverter_id e mostre o nome através da junção com as séries de informação.
• Misturar vias: powerplant_pyranometer_power sem fixar clipping / pr devolve várias vias da mesma grandeza. Fixe a via que pretende — a tabela abaixo indica as labels fixadas que os relatórios usam.
• Centrais com vários contadores: powerplant_power_grid é uma série por contador. Faça sum(...) delas, ou leia powerplant_grid_power, que já é a série da central somada e alinhada ao minuto.
• Fuso horário: as séries são armazenadas em UTC e o Grafana mostra-as no fuso horário do navegador. Os valores diários (factos configurados, veredictos diários) são marcados à meia-noite local da central; defina o fuso horário do dashboard para o da central quando comparar dias.

O catálogo de séries dos relatórios

As páginas de relatórios e exportação da plataforma são construídas a partir de um catálogo fixo de séries, cada uma com uma leitura definida. A tabela lista cada item com a métrica que lê, a forma em que é lida (ver acima), as labels fixadas que os relatórios aplicam e o nível (central, por inversor, por caixa de junção, por string, por segmento). Os itens marcados como solar só são emitidos para centrais solares; a unidade do relatório é a que as páginas de relatórios mostram — a série armazenada está sempre em unidades base (Wh, W, Wh/m²). Uma label fixada period="<YYYY-MM>" seleciona o mês de entrega de uma via liquidada.

Contadores e registos de produção

Potência da central

Irradiância no plano dos módulos

Produção modelada, esperada e de céu limpo

Performance ratio

Sensores no local

Limites de potência

Restrição liquidada

Inversores

Caixas de junção

Strings

Bateria

Meteorologia

Preços de mercado

Infraestrutura

Documentação relacionada

• Utilizar o Grafana como Plataforma Externa de Leitura — aceder ao Grafana disponibilizado e ao dashboard gerido
• Recolha de Métricas — o catálogo completo de métricas com unidades e labels
• Linguagem de Consulta MiroxQL — as mesmas séries, consultadas a partir da plataforma e transformadas em métricas personalizadas para relatórios
• API de Exportação de Métricas — métricas limpas e agregadas em CSV ou JSON