Métricas

Métricas permite que a sua organização defina os seus próprios indicadores. Descreve, numa expressão curta, o que deve ser medido num único intervalo de 15 minutos. Do resto trata a plataforma: aplica a sua expressão a cada central, ao longo do período que um relatório cobre, e condensa os valores de 15 minutos no número que quer ver.

Uma métrica é definida uma só vez para toda a organização e fica depois disponível em todas as centrais — nunca escreve uma métrica «para uma central».

Onde encontrar

Abra a página Relatórios de qualquer central e mude para o terceiro separador, Métricas. A lista que vê pertence à sua organização; a central é apenas o sítio onde a consulta e onde faz os testes.

  • Os administradores da organização criam, editam e eliminam métricas.
  • Todos os membros veem as métricas e podem usá-las em relatórios.

Definir uma métrica

Uma métrica é composta por alguns campos descritivos e por uma a três expressões.

Nova métrica cria a métrica de imediato e, a partir daí, cada alteração é guardada enquanto escreve — um indicador de estado mostra A guardar e depois Guardado, sem qualquer passo à parte para confirmar. Enquanto a sua expressão não for válida, a métrica continua a ser um Rascunho: a tabela assinala-a com a etiqueta Rascunho e um rascunho nunca é oferecido como fonte de dados num relatório. Assim que a expressão é válida, a etiqueta desaparece e a métrica pode ser usada em todo o lado.

  • Nome, descrição, unidade — como a métrica aparece no seletor de dados do relatório e no relatório final.
  • Expressão — o que é medido num intervalo de 15 minutos. É escrita em MetricsQL, a linguagem de consulta do armazenamento de séries temporais da plataforma. Escreve apenas a parte relativa ao intervalo: a central, a janela temporal e a condensação são acrescentadas pela plataforma. Nunca indique uma central ou uma organização na expressão — é rejeitado, porque a mesma métrica tem de funcionar em todas as centrais.
  • Condensação — como os valores de 15 minutos se tornam um único número:
    • média — a média dos valores dos intervalos
    • soma — o total dos valores dos intervalos
    • proporção — a parte dos intervalos esperados em que a expressão valia 1
    • último valor — o valor no final do período
  • Esperado (opcional, para a condensação «proporção») — uma segunda expressão que determina que intervalos contam, por exemplo «há luz do dia». Um intervalo sem expectativa não conta; um intervalo esperado sem medição conta como não disponível; um período sem qualquer intervalo esperado é apresentado como um travessão.
  • Peso (opcional) — um valor fixo por componente, como a sua potência de pico, usado para combinar os valores dos componentes num único valor de central. Sem peso, todos os componentes contam por igual.
  • Apresentar como — a forma como a métrica responde. Valor de central devolve um número por central; se a expressão trabalhar por componente, esse número é o valor de central ponderado descrito acima. Por componente devolve uma coluna por inversor, caixa de junção, string ou datalogger, além do valor de central. Duplique uma métrica para ter a mesma grandeza nas duas formas.
  • Resolução mais fina — o passo mais fino com que um relatório pode apresentar a métrica: 15 minutos, horária ou diária. Os passos mais amplos estão sempre disponíveis; escolha Dia para uma grandeza que só faz sentido por dia.

Escolhe também a resolução com que a métrica é apresentada: 15 minutos, horária, diária, mensal ou um único valor para todo o período.

À medida que escreve, o editor valida em tempo real: sintaxe, séries desconhecidas (com sugestões do que provavelmente pretendia), a regra de não delimitação, se as expressões encaixam na condensação escolhida, e o tamanho. Uma execução de teste avalia depois a métrica na central atual, e uma pré-visualização mostra uma tabela e um gráfico com cada inversor ou componente e o valor de central resultante para o mês, trimestre ou ano que escolher — uma métrica apresentada como valor de central mostra apenas esse valor. As mensagens de validação e do teste indicam pelo nome a central em que foram verificadas.

Os blocos de construção

O painel lateral do editor lista tudo aquilo com que pode construir, pelo que quase não precisa de decorar nomes:

  • Séries — os mesmos dados da seleção de dados dos relatórios: injeção e produção da central, produção esperada e séries de referência, remuneração e limitação, inversores, caixas de junção, strings, bateria, meteorologia e infraestrutura, cada uma com as etiquetas e os passos que transporta. Pode pesquisar por nome e filtrar por nível; uma marca indica quais as séries que a central atual ainda não entregou — a métrica funciona na mesma em toda a organização. O que um relatório calcula em vez de ler (performance ratio, contagens de eventos, valores de liquidação) aparece no fim como não exprimível, para que o saiba antes de o escrever.
  • Dados configurados — valores da configuração da central, não medições: potência de pico CC de inversor, caixa de junção e string, potência de pico da central, capacidade de inversores da central e número de componentes. São inseridos na consulta de cada central quando esta é executada, pelo que uma expressão usa o nome como uma série constante — por exemplo powerplant_inverter_peak_power para ponderar ou como limiar por inversor. Numa central em que nenhum componente tem o valor configurado, a pré-visualização fica vazia; a própria métrica funciona em todas as centrais que os têm. Dois deles são válidos por período em vez de constantes: o valor aplicável efetivo da central — o anzulegender Wert ponderado pela capacidade das bandas em vigor nesse momento — e o Marktwert contra o qual a central é liquidada, mensal ou anual consoante a sua configuração de mercado, ambos em EUR/MWh. Mudam ao longo do tempo e a plataforma insere o valor em vigor em cada slot de 15 minutos, pelo que não precisam de uma janela própria. Um prémio de mercado construído a partir dos dois — clamp_min(powerplant_park_eeg_value - market_marktwert, 0) — é uma aproximação combinada para ler a evolução: a liquidação rateia cada banda separadamente, pelo que nunca é o valor liquidado.

Exemplos incluídos

A tabela Métricas já contém cinco métricas que a Mirox entrega a todas as organizações: Conectividade, Disponibilidade do datalogger, Disponibilidade dos inversores com luz do dia, Horas de sol e Disponibilidade dos dados de injeção. Têm um cadeado e a etiqueta Exemplo: não pertencem a nenhuma organização, pelo que não podem ser editadas nem eliminadas.

O que pode fazer com elas:

  • Abrir um exemplo e ler as suas expressões. São casos resolvidos de tudo o que foi descrito acima: o filtro de luz do dia, as duas formas da condensação «proporção», a identidade por componente e uma escala de unidade.
  • Executar a pré-visualização na central em que se encontra, para ver cada série e o valor de central que delas resulta.
  • Duplicar um exemplo. A cópia pertence à sua organização, é totalmente editável e é o ponto de partida habitual para uma métrica sua.

Os exemplos são de propósito a versão simples e transparente de cada pergunta, e cada descrição indica o que não tem em conta. Os valores de disponibilidade do próprio relatório — que usam a lista de dataloggers configurada da central e os seus métodos de liquidação — permanecem onde estavam, em Disponibilidade no seletor de dados do relatório. Por isso os exemplos não são oferecidos no seletor; um duplicado é.

Limites

  • Uma expressão pode ter até 4 000 caracteres; depois de a plataforma acrescentar a central, o armazenamento rejeita qualquer consulta com mais de 16 KB.
  • Uma métrica pode devolver no máximo 500 séries numa mesma central.
  • A execução de teste sobre um dia tem de terminar em 5 segundos.
  • Nada pode ser medido com granularidade inferior a 15 minutos.

Se uma métrica atingir um destes limites, o editor avisa enquanto escreve, e a métrica continua como rascunho até que o resolva.

Um exemplo resolvido

Disponibilidade de inversores (2 % do pico CC) — a proporção de intervalos com luz do dia em que um inversor produziu pelo menos 2 % da sua potência de pico CC, ponderada pela potência de pico e apresentada em percentagem com a condensação proporção.

Expressão:

max by (inverter_id) (max_over_time(powerplant_inverter_power_ac[900s])) > bool on(inverter_id) 0.02 * powerplant_inverter_peak_power

Esperado (que intervalos contam — há luz suficiente):

(avg(avg_over_time(powerplant_pyranometer_radiation_power{segment_id!~".+"}[900s])) or avg(avg_over_time(powerplant_weather_radiation_power{segment_id!~".+"}[900s]))) > bool 100

Peso (para que os inversores grandes pesem mais no valor da central):

powerplant_inverter_peak_power

Criar uma métrica com o assistente

Não precisa de escrever MetricsQL. O assistente está dentro do editor de métricas: abra Nova métrica — ou qualquer métrica que possa editar — e encontra-o como painel de chat no canto superior direito. Fica em silêncio até lhe escrever; antes disso nada é enviado.

Descreva por palavras suas o indicador que pretende. O assistente já conhece a central em que está, o que preencheu até agora (nome, expressão, condensação…), o resultado da última validação e as séries que essa central escreve de facto, pelo que raramente precisa de perguntar o básico. Propõe a expressão, um nome e uma descrição, valida-os e mostra uma pré-visualização na central, e avisa quando a plataforma não dispõe dos dados pedidos ou quando a consulta seria demasiado pesada.

A proposta passa para os campos assim que chega: o assistente edita consigo e cada alteração vai sendo guardada. Se preferir manter o que tinha, Reverter na proposta do chat repõe os campos no estado anterior; a proposta fica no chat e pode ser aplicada de novo. O assistente termina sozinho: a proposta é guardada na métrica no momento em que é feita, por isso pode enviar o pedido, fechar a página e encontrar a métrica pronta na lista quando voltar. A partir daí é uma edição normal: altera um campo, executa de novo a pré-visualização ou pede outra coisa.

A conversa pertence à métrica, não ao separador do navegador. Feche o editor e abra de novo a métrica, ou recarregue a página: a mesma conversa continua lá, ao lado dos campos que escreveu.

O chat do editor aceita apenas texto. Fotografias e documentos — a página com a fórmula de um contrato, por exemplo — continuam a ser uma funcionalidade da página de chat completa; Abrir no chat leva a conversa para lá.

Usar uma métrica num relatório

No editor de relatórios, abra o seletor de dados de um bloco e escolha o nível Métricas da organização. As suas métricas aparecem aí ao lado dos elementos da própria plataforma e comportam-se exatamente como eles — as mesmas resoluções, as mesmas tabelas e gráficos. Como a métrica é de toda a organização, o mesmo bloco funciona sem alterações num relatório de qualquer central.

O que não pode ser definido

Alguns valores são calculados pela própria plataforma e devem ser retirados dos elementos existentes em vez de reconstruídos:

  • Performance ratio e produção esperada — use os elementos calculados pela plataforma, também disponíveis como blocos de construção.
  • Liquidação das limitações de potência — resulta da sua configuração de mercado e tarifas.
  • Potência nominal CA por inversor — não é armazenada por inversor, pelo que não pode ser referenciada.

Páginas Relacionadas