Exportação de métricas

A página Exportação de dados exporta qualquer métrica das suas centrais como série temporal: desde a injeção na rede de uma carteira inteira até um único sensor de irradiância, uma turbina ou uma célula de bateria. Escolhe as centrais, as métricas, o período e o passo, verifica a pré-visualização e transfere um ficheiro CSV. Cada exportação é também uma ligação que pode entregar ao Excel ou a um script.

Este guia trata da página em si. Os parâmetros por detrás de cada ligação de exportação estão descritos na API de exportação de métricas.

Uma só coleção de métricas

A exportação e os relatórios leem a mesma coleção de métricas. Uma métrica tem um só nome, uma só unidade e uma só definição, onde quer que a encontre: no seletor de dados do relatório, num relatório concluído e num ficheiro exportado.

A coleção contém:

• as métricas que o Mirox fornece, ordenadas por nível — central, inversor, caixa de junção, string, bateria, turbina eólica, sensor, contador, meteorologia, mercado e outros. Os níveis estão listados em Métricas disponíveis;
• as métricas que a sua organização definiu em Métricas. No seletor estão agrupadas em As minhas métricas.

Uma métrica marcada como Não validada em As minhas métricas só pode ser exportada depois de a sua expressão ser válida.

Os três separadores

Exportar métricas

1. Escolher as centrais

Em Centrais, abra a lista de centrais e assinale uma ou mais; a lista de carteiras ao lado adiciona carteiras inteiras. As listas são as mesmas da navegação à esquerda: cada linha traz o tipo da central — solar, eólica ou bateria — e a sua escolha aparece como etiquetas no campo. Centrais e carteiras podem misturar-se; uma central que também está numa carteira escolhida é exportada uma só vez. Pode exportar no máximo 50 centrais num ficheiro. Com mais de uma central, escolhe também se as centrais são combinadas numa coluna por métrica ou mostradas lado a lado — consulte Várias centrais. Centrais em fusos horários diferentes põem o ficheiro em UTC — consulte Hora local da central e UTC.

2. Adicionar métricas

Em Métricas, escreva no campo de pesquisa o que procura — um nome, uma palavra da descrição, um componente ou uma unidade, por exemplo inversor dc. Cada palavra escrita tem de ocorrer algures numa métrica: no nome, no ID, nos IDs que a exportação anterior usava, na unidade, no nível ou na descrição. As melhores correspondências vêm primeiro: uma métrica cujo nome começa pelas suas palavras antes de uma que só as menciona na descrição. Enter adiciona a primeira correspondência, as setas movem a escolha e Ver todas as métricas abre a coleção inteira por nível, com a mesma pesquisa. energy_grid_daily encontra Injeção na rede, pelo que um ID de uma ligação antiga também funciona.

Cada linha diz o que a métrica mede e em que passos pode ser lida. Uma linha que não pode escolher indica o motivo:

Uma exportação contém no máximo 20 métricas. As métricas escolhidas são listadas abaixo da pesquisa, pela ordem das colunas; arraste uma linha para a alterar. Explicações, acima da lista, abre uma descrição de cada métrica escolhida: unidade, com que frequência é medida, os passos e os valores que oferece e como várias centrais são combinadas. Aí, Transferir glossário (CSV) dá-lhe a coleção inteira num ficheiro.

Se a coleção não tiver uma métrica para o que precisa, Criar métrica abre o editor de métricas da página Relatórios; Voltar à exportação de dados, no topo do editor, traz-o de volta com as centrais, as métricas e o período que tinha. Para uma leitura pontual da base de dados de séries temporais, adicione antes uma consulta MetricsQL.

3. Escolher componentes

Uma métrica de um nível de componente — inversor, caixa de junção, string, turbina eólica, sensor, contador, contentor de bateria, rack, módulo, célula ou conversor — exporta uma coluna por componente. Sem seleção, obtém todos os componentes da central, 50 por página. Para restringir a exportação, abra o botão de componentes na métrica e escolha os que precisa, até 100.

É assim que exporta cada sensor de irradiância individualmente, sem média: adicione Irradiância por sensor e deixe a seleção de componentes vazia.

Os componentes ocultos ficam de fora. Mostrar ocultos, no diálogo de componentes, lista-os, para que possa escolher um deliberadamente.

4. Definir o período

Em Período e passo, escolha uma predefinição ou defina o seu próprio início e fim. As predefinições são Hoje, Ontem, Últimos 7 dias, Últimos 30 dias, Esta semana, Semana anterior, Este mês, Mês anterior, Este trimestre, Trimestre anterior, Este ano e Ano anterior. Sem escolha, a exportação cobre o mês anterior.

Um período pode começar, no mínimo, em 2020 e abranger no máximo cinco anos. Um período que entra no futuro termina agora.

5. Escolher o passo

O passo é a duração de uma linha: 1 min, 5 min, 15 min, 1 h, dia, semana, mês, trimestre ou ano. Em automático, o Mirox escolhe um passo que todas as métricas escolhidas servem e que se ajusta ao período: 15 minutos até dois dias, uma hora até dois meses, um dia até três anos, um mês para além disso.

Nem todas as métricas podem ser lidas em todos os passos — consulte Passos e os seus limites. Uma métrica que não serve o passo escolhido é exportada na mesma, no seu próprio passo — consulte Métricas com passos diferentes. Só um passo em que uma métrica não poderia ter linha nenhuma aparece a cinzento e indica essa métrica.

6. Escolher os valores

Para uma energia ou outra grandeza contada, escolha em Valores se cada linha mostra a quantidade Por intervalo ou o Total acumulado desde o início do período. Todas as outras métricas são exportadas Tal como medido, e a lista diz como cada linha é formada — consulte Valores.

7. Escolher o fuso horário

Hora local da central é a predefinição; UTC é a alternativa. Consulte Hora local da central e UTC.

8. Verificar a pré-visualização e transferir

A Pré-visualização mostra a exportação como gráfico ou como tabela. Abaixo do período, uma linha indica o tamanho: linhas, colunas, o tamanho aproximado do ficheiro e a duração. As notas sob a pré-visualização dizem-lhe o que o Mirox fez por iniciativa própria, por exemplo que um período foi alargado a dias completos.

No gráfico:

• O olho no início de cada linha de métrica ou de consulta oculta a sua série no gráfico e na tabela, e volta a mostrá-la. Uma série oculta continua na transferência e na ligação; a definição faz parte do endereço da página, pelo que uma ligação partilhada mostra a mesma vista.
• Clicar num nome da legenda faz o mesmo; Shift+clique mostra só essa série. Legenda e olhos concordam sempre.
• Arraste sobre o gráfico para ampliar um intervalo; um duplo clique volta a reduzir. O zoom só altera a vista.
• A dica lista até dez séries, o maior valor primeiro, e diz quantas mais existem.
• Um período longo num passo fino tem mais pontos do que um navegador consegue desenhar. O gráfico mostra então uma resolução mais grossa e di-lo numa nota laranja — O gráfico mostra a resolução 1 h para continuar legível; a tabela e a exportação mantêm 1 min — ou, quando não há um passo mais grosso disponível, junta várias linhas num ponto. A tabela, a transferência e a ligação mantêm sempre o passo que escolheu.

Em Opções de exportação, escolha o separador CSV, o separador decimal, o formato do carimbo de data, o idioma dos nomes das colunas e os Cabeçalhos das colunas: Nomes (para pessoas) ou IDs (para scripts). O formato do carimbo de data altera também as datas na tabela, pelo que a pré-visualização mostra o que o ficheiro vai conter. Depois:

• Transferir CSV guarda o ficheiro.
• Copiar URL da API copia a mesma exportação em forma de ligação. Experimentar prepara um token de API e fornece comandos prontos a usar para o terminal e para Python.
• Guardar como modelo guarda a seleção como modelo.

Consultas MetricsQL

Além das métricas da coleção, o separador Métricas aceita consultas em bruto em MetricsQL, a linguagem de consulta da base de dados de séries temporais da plataforma — a linguagem que as métricas da sua organização e o Grafana usam. Uma consulta serve para aquilo para que a coleção não tem métrica: uma série que a base de dados guarda, uma combinação de séries, uma função sobre elas.

1. Clique em MetricsQL, abaixo das métricas, para abrir o campo de consulta.
2. Escreva a consulta, por exemplo sum by (inverter_id) (powerplant_inverter_power_ac). Enquanto escreve, o campo propõe nomes de séries, etiquetas e funções; Tab aceita a proposta. Enter executa a consulta e adiciona-a como linha; Shift+Enter começa uma nova linha dentro da consulta.
3. A linha mostra o texto da consulta sobre um fundo de código e a etiqueta MetricsQL onde uma métrica mostra a sua unidade. As colunas da linha são uma por cada série que a consulta devolve, tal como medido. O lápis transforma o texto num editor no próprio lugar: Enter guarda, Esc cancela. Nada mais muda na linha.

O que uma consulta faz e não faz:

• O Mirox acrescenta a central escolhida a cada seletor da consulta, pelo que a consulta nunca nomeia uma central, um parque ou uma organização. Uma consulta com uma etiqueta dessas é recusada, e a etiqueta é indicada.
• Uma consulta é lida no passo que escolheu — qualquer passo, de 1 min a um ano — como um painel a leria: amostras brutas nesse passo, sem modo de valor nem agregação. Por intervalo e Total acumulado não se lhe aplicam.
• Com várias centrais, cada central recebe as suas próprias colunas. As consultas nunca são combinadas entre centrais.
• Uma consulta pode devolver no máximo 500 séries numa central; agregue-a, por exemplo com sum by (…), se devolver mais. Uma exportação contém no máximo 5 consultas de até 4 000 caracteres cada, e as séries que devolvem contam para os limites de tamanho como qualquer outra coluna.
• No ficheiro, a coluna tem o cabeçalho MetricsQL seguido da consulta e, quando a consulta devolve várias séries, das etiquetas de cada série: MetricsQL sum by (inverter_id) (powerplant_inverter_power_ac) {inverter_id="INV1"}. Com IDs (para scripts) o cabeçalho é expr1, expr2, … com as mesmas etiquetas. Assim, um ficheiro com consultas distingue-se de uma exportação normal logo pela primeira linha.
• Uma consulta não é guardada num modelo. Remova as consultas para guardar as métricas como modelo, ou defina o valor de uma vez como métrica da sua organização: fica então validada, tem nome e unidade, e é também oferecida aos relatórios.

Passos e os seus limites

Os passos que uma métrica oferece dependem do que ela é e da frequência com que é medida:

Uma métrica nunca é oferecida com um passo mais fino do que aquele em que é medida: uma turbina eólica que comunica a cada 10 minutos não tem valores de 1 minuto.

O passo também limita o período, porque uma coluna contém no máximo 180 000 valores:

Os passos de um dia ou mais cobrem sempre dias, semanas, meses, trimestres ou anos completos. Um período que começa ou termina dentro de um deles é alargado ao intervalo completo, e uma nota indica-o. As semanas começam à segunda-feira.

Métricas com passos diferentes

Nem todas as métricas servem todos os passos, e algumas só servem passos grossos: o performance ratio começa no dia, um valor de mercado existe uma vez por mês. O separador Métricas junta-as na mesma num ficheiro:

• Uma métrica com um passo mais grosso do que o ficheiro mantém o seu próprio passo. O seu valor fica na primeira linha de cada um dos seus intervalos — o valor de um dia na linha da sua meia-noite, o de um mês na linha do seu primeiro dia — e as linhas intermédias ficam vazias. O gráfico desenha essa métrica como pontos. Uma nota laranja acima da pré-visualização indica estas métricas com os seus passos e oferece Exportar em separado: uma ligação por passo, cada métrica na sua própria resolução.
• Uma métrica que só serve passos mais finos é lida no mais grosso deles e combinada no passo do ficheiro pela regra da sua grandeza: uma energia soma-se, uma leitura é a média, um rácio é recalculado a partir das suas duas metades, um estado mantém o seu último código. Uma nota sob a pré-visualização indica-o.
• Dois casos continuam a ser recusados: um valor por mês, trimestre ou ano não tem linha num ficheiro por semana, e um valor mensal como o Marktwert nunca é somado nem tirada a média para um trimestre ou um ano, porque não seria esse valor. Esse passo fica a cinzento e indica a métrica.

Um modelo decide por si com Métricas de outro passo: Flexível comporta-se como o separador Métricas, Estrito recusa uma ligação que nomeie um passo que uma das suas colunas não serve. Um modelo guardado a partir do separador Métricas ou criado de novo é flexível; os modelos anteriores a esta definição são estritos. Uma ligação de exportação escrita à mão é estrita salvo indicação em contrário — consulte o parâmetro mismatch.

Valores: por intervalo, total acumulado, tal como medido

Por intervalo é oferecido apenas para energia. Uma potência, uma temperatura ou um rácio não têm «quantidade por intervalo», pelo que são sempre exportados tal como medidos.

O aviso abaixo de 15 minutos

Um contador conta a energia em degraus inteiros, muitas vezes de 1 kWh. Num minuto, uma central raramente produz um degrau inteiro, pelo que uma energia por intervalo a 1 ou 5 minutos salta entre zero e um degrau em vez de desenhar uma curva. O Mirox avisa quando combina os dois e oferece três saídas:

• Mudar para a métrica de potência correspondente, quando a coleção tem uma. A potência é a grandeza certa para uma curva fina.
• Usar 15 min, o passo mais fino em que uma energia por intervalo se lê bem.
• Manter, se o que quer ver são os degraus do contador.

Hora local da central e UTC

As linhas seguem a hora local da central, incluindo a hora de verão. Um dia é um dia local, pelo que tem 23 ou 25 horas quando a hora muda, e um mês é um mês local.

• Em passos mais curtos do que um dia, uma coluna Desvio UTC fica ao lado da hora. No dia em que os relógios atrasam, a hora entre as 02:00 e as 03:00 aparece duas vezes; o desvio distingue as duas.
• UTC como fuso horário coloca todas as linhas no calendário UTC. Use-o quando o ficheiro se destina a um sistema que espera UTC.
• As centrais em fusos horários diferentes partilham uma só coluna de tempo, pelo que uma exportação destas está sempre em UTC. A escolha do fuso horário fica então bloqueada e indica o motivo.

Várias centrais: combinadas ou por central

Com mais de uma central, escolhe entre uma coluna por métrica para todas as centrais em conjunto e uma coluna por central.

Combinadas, cada métrica segue a sua própria regra:

As métricas de componentes são sempre mostradas por central. Uma nota sob a pré-visualização indica cada métrica que foi mostrada por central em vez de combinada.

Modelos

Um modelo é uma lista guardada de métricas com as suas próprias predefinições: passo, período, valores, fuso horário, combinadas ou por central, e cabeçalhos das colunas. Cada coluna pode ter o seu próprio texto de cabeçalho, pelo que o ficheiro mantém os cabeçalhos mesmo que uma métrica mude de nome mais tarde.

Modelos do sistema

O Mirox fornece oito modelos, marcados com Sistema. Não podem ser alterados nem eliminados.

Os primeiros cinco sucedem aos modelos da exportação anterior. Os seus IDs e colunas estão listados no guia de migração.

Os seus próprios modelos

Guardar como modelo, no separador Métricas, ou Criar modelo, no separador Modelos, guarda a sua seleção para toda a organização. Um modelo contém até 40 métricas e nenhuma consulta MetricsQL. Abrir em Métricas carrega um modelo no separador Métricas. Métricas de outro passo decide o que uma ligação do modelo faz com uma coluna que não serve o passo pedido — consulte Métricas com passos diferentes.

Os modelos são criados, alterados, convertidos e eliminados pela função de organização Administrador. Todos os membros da organização os podem usar.

Uma métrica da sua organização que um modelo usa não pode ser eliminada nem receber um novo ID. Se uma métrica de um modelo deixar de estar disponível — por exemplo, se voltou a Não validada —, a sua coluna permanece no ficheiro, vazia, para que as posições das outras colunas não se alterem.

Modelos legados e conversão

Um modelo criado antes da exportação de métricas está marcado com Legado. Baseia-se no conjunto de métricas anterior, e a sua ligação continua a funcionar sem alterações. Os novos modelos baseiam-se sempre na coleção de métricas.

Converter em novo modelo cria um novo modelo a partir de um modelo legado. O modelo legado nunca é alterado, pelo que os ficheiros e as ligações que o usam ficam como estão.

1. O Mirox mostra que colunas têm equivalente, se os números são os mesmos (exata) ou a mesma grandeza lida de uma forma melhor (aproximada), e que colunas não têm equivalente.
2. Dá um nome ao novo modelo e confirma.
3. São mostradas as duas ligações. O Excel continua a usar a ligação antiga até a substituir.

Um modelo convertido exporta dias, tal como a sua origem. Uma coluna cuja métrica não tem valor diário — frequência ou fator de potência, por exemplo — não é transferida; o diálogo indica a métrica, para que a possa exportar no separador Métricas.

Construtor de API

Escolha um modelo e as centrais, e ajuste o período, o passo e o formato do ficheiro se as predefinições do modelo não servirem. A página mostra a ligação e uma pré-visualização dos dados. Experimentar prepara um token de API e comandos prontos a usar para essa ligação. Para um modelo legado, o construtor mostra a ligação anterior e oferece a conversão.

Uma ligação com uma predefinição como Mês anterior fornece sempre o período completo mais recente, que é o que um livro que se atualiza sozinho precisa. Consulte Excel com Power Query.

Quando uma exportação é demasiado grande

O Mirox verifica o tamanho de uma exportação antes de ler quaisquer dados. Se a exportação for demasiado grande, nada é exportado, e a mensagem propõe o que caberia: um passo mais grosso, ou um período mais curto com o número de dias indicado.

Para exportar mais, divida a exportação:

• por tempo — um ficheiro por mês ou por trimestre em vez de um por ano;
• por central — um ficheiro por central ou por carteira;
• por métrica — as métricas de componentes num ficheiro próprio, separadas das métricas da central;
• por página — numa central com muitos componentes, exporte os componentes página a página.

As métricas que o Mirox tem de apurar a partir de várias fontes, como Produção (resolvida), custam mais do que uma simples leitura de contador. Um modelo que contém uma métrica destas abrange menos centrais e meses por ficheiro. A linha de tamanho abaixo do período informa-o antes de transferir.

Quem pode exportar o quê

• Exporta as centrais cujas medições pode ler: as funções de trabalho Operador, Gestor Técnico, Gestor de Ativos e Visualizador. Uma central que não pode ler fica de fora, e uma nota indica-a.
• As métricas monetárias requerem adicionalmente a permissão de contabilidade, que as funções de trabalho Operador e Gestor de Ativos têm. Sem ela, a coluna fica vazia para essa central.
• As métricas da sua organização são exportadas em todas as centrais que pode ler, incluindo centrais partilhadas consigo através de uma cooperação. São oferecidas a todas as funções de organização, exceto Externo.
• Fora do navegador, um token de API do grupo Metric Export lê todas as exportações. Não pode alterar nada.

Ligações e marcadores antigos

As ligações para o anterior separador Dados brutos e para o anterior separador Métricas continuam a funcionar: abrem o separador Métricas com as mesmas centrais, métricas, período e passo. Quando uma métrica não tem equivalente, uma faixa indica-o e oferece Copiar o URL original da API, que continua a fornecê-la. Uma ligação para um dos cinco modelos do sistema anteriores abre o seu sucessor.

As fórmulas já não são editadas na aplicação. Consulte Fórmulas MiroxQL.

Funcionalidades relacionadas

• API de exportação de métricas — todos os parâmetros, erros e limites das ligações de exportação
• Migrar para a exportação de métricas — os IDs antigos e as suas novas métricas, e o que muda
• API de exportação legada — as ligações de exportação anteriores, que continuam a funcionar
• Exportação de métricas para Excel — receitas e Power Query
• FAQ da exportação de dados — respostas curtas a perguntas frequentes
• Métricas — as métricas da sua própria organização
• Tokens de API — o token Metric Export