Metriche

Metriche consente alla tua organizzazione di definire i propri indicatori. Descrivi, in una breve espressione, che cosa deve essere misurato in un singolo intervallo di 15 minuti. Al resto pensa la piattaforma: applica la tua espressione a ogni impianto, sul periodo coperto da un report, e condensa i valori a 15 minuti nel numero che vuoi vedere.

Una metrica si definisce una sola volta per l'intera organizzazione ed è poi disponibile su ogni impianto: non scrivi mai una metrica «per un impianto».

Dove si trova

Apri la pagina Report di un impianto qualsiasi e passa alla terza scheda, Metriche. L'elenco che vedi appartiene alla tua organizzazione; l'impianto è semplicemente il luogo in cui lo consulti e in cui esegui le prove.

  • Gli amministratori dell'organizzazione creano, modificano ed eliminano le metriche.
  • Tutti i membri vedono le metriche e possono usarle nei report.

Definire una metrica

Una metrica è composta da alcuni campi descrittivi e da una a tre espressioni.

Nuova metrica crea subito la metrica e da quel momento ogni modifica viene salvata mentre scrivi: un indicatore di stato mostra Salvataggio e poi Salvato, senza un passaggio a parte per confermare. Finché la sua espressione non è valida, la metrica resta una Bozza: la tabella la contrassegna con l'etichetta Bozza e una bozza non viene mai offerta come fonte dati in un report. Non appena l'espressione è valida, l'etichetta scompare e la metrica è utilizzabile ovunque.

  • Nome, descrizione, unità: come la metrica appare nel selettore dati del report e nel report finito.
  • Espressione: che cosa viene misurato in un intervallo di 15 minuti. Si scrive in MetricsQL, il linguaggio di query dell'archivio time-series della piattaforma. Scrivi soltanto la parte relativa all'intervallo: impianto, finestra temporale e condensazione li aggiunge la piattaforma. Non nominare mai un impianto o un'organizzazione nell'espressione: viene rifiutata, perché la stessa metrica deve funzionare su ogni impianto.
  • Condensazione: come i valori a 15 minuti diventano un unico numero:
    • media: la media dei valori degli intervalli
    • somma: il totale dei valori degli intervalli
    • quota: la parte degli intervalli attesi in cui l'espressione valeva 1
    • ultimo valore: il valore alla fine del periodo
  • Atteso (facoltativo, per la condensazione «quota»): una seconda espressione che stabilisce quali intervalli contano, per esempio «c'è luce diurna». Un intervallo senza attesa non conta; un intervallo atteso privo di misura conta come non disponibile; un periodo senza alcun intervallo atteso viene mostrato con un trattino.
  • Peso (facoltativo): un valore fisso per componente, per esempio la sua potenza di picco, usato per combinare i valori dei componenti in un unico valore di impianto. Senza peso tutti i componenti contano allo stesso modo.
  • Riportare come: la forma in cui la metrica risponde. Valore di impianto restituisce un solo numero per impianto; se l'espressione lavora per componente, quel numero è il valore di impianto ponderato descritto sopra. Per componente restituisce una colonna per ogni inverter, quadro di campo, stringa o logger, oltre al valore di impianto. Duplica una metrica se ti serve la stessa grandezza in entrambe le forme.
  • Risoluzione più fine — il passo più fine con cui un report può riportare la metrica: 15 minuti, oraria o giornaliera. I passi più ampi sono sempre disponibili; scegli Giorno per una grandezza che ha senso soltanto per giorno.

Scegli inoltre la risoluzione con cui la metrica viene restituita: 15 minuti, oraria, giornaliera, mensile oppure un unico valore per l'intero periodo.

Mentre scrivi, l'editor valida in tempo reale: sintassi, serie sconosciute (con suggerimenti su ciò che probabilmente intendevi), la regola di non delimitazione, la compatibilità delle espressioni con la condensazione scelta e la dimensione. Una prova di esecuzione valuta poi la metrica sull'impianto corrente e un'anteprima mostra una tabella e un grafico con ogni inverter o componente e il valore di impianto risultante per il mese, il trimestre o l'anno che scegli; una metrica riportata come valore di impianto mostra soltanto quel valore. I messaggi di validazione e della prova nominano l'impianto su cui è stata fatta la verifica.

I mattoni a disposizione

Il pannello laterale dell'editor elenca tutto ciò con cui puoi costruire, così non devi ricordare i nomi:

  • Serie: gli stessi dati della selezione dati dei report: immissione e produzione dell'impianto, produzione attesa e serie di riferimento, remunerazione e limitazione, inverter, quadri di campo, stringhe, batteria, meteo e infrastruttura, ciascuna con le etichette e i passi che porta. Puoi cercare per nome e filtrare per livello; un segno indica quali serie l'impianto corrente non ha ancora fornito — la metrica funziona comunque per tutta l'organizzazione. Ciò che un report calcola invece di leggere (performance ratio, conteggi di eventi, importi di liquidazione) è elencato in fondo come non esprimibile, così lo sai prima di scriverlo.
  • Dati configurati: valori della configurazione dell'impianto, non misure: potenza di picco CC di inverter, quadro di campo e stringa, potenza di picco dell'impianto, capacità inverter dell'impianto e numero di componenti. Vengono inseriti nella query di ogni impianto al momento dell'esecuzione, quindi un'espressione usa il nome come una serie costante — per esempio powerplant_inverter_peak_power per ponderare o come soglia per inverter. Su un impianto in cui nessun componente ha il valore configurato l'anteprima resta vuota; la metrica stessa funziona su ogni impianto che li possiede. Due di essi sono validi per periodo anziché costanti: il valore applicabile effettivo dell'impianto — l'anzulegender Wert ponderato sulla capacità delle fasce in vigore in quel momento — e il Marktwert rispetto al quale l'impianto viene liquidato, mensile o annuale a seconda della sua configurazione di mercato, entrambi in EUR/MWh. Cambiano nel tempo e la piattaforma inserisce il valore in vigore in ogni slot da 15 minuti, quindi non serve una finestra propria. Un premio di mercato costruito dai due — clamp_min(powerplant_park_eeg_value - market_marktwert, 0) — è un'approssimazione mediata per leggere l'andamento: la liquidazione ripartisce ogni fascia separatamente, quindi non è mai la cifra liquidata.

Esempi inclusi

La tabella Metriche contiene già cinque metriche che Mirox fornisce a ogni organizzazione: Connettività, Disponibilità del datalogger, Disponibilità degli inverter con luce diurna, Ore di sole e Disponibilità dei dati di immissione. Portano un lucchetto e l'etichetta Esempio: non appartengono ad alcuna organizzazione, quindi non si possono modificare né eliminare.

Che cosa puoi farci:

  • Aprire un esempio e leggerne le espressioni. Sono casi svolti di tutto quanto descritto sopra: il filtro luce diurna, entrambe le forme della condensazione «quota», l'identità per componente e una scala dell'unità.
  • Eseguire l'anteprima sull'impianto su cui ti trovi, per vedere le singole serie e il valore di impianto che ne risulta.
  • Duplicare un esempio. La copia appartiene alla tua organizzazione, è completamente modificabile ed è il punto di partenza abituale per una metrica tua.

Gli esempi sono di proposito la versione semplice e trasparente di ciascuna domanda, e ogni descrizione dice che cosa non considera. I valori di disponibilità propri del report — che usano l'elenco di datalogger configurato dell'impianto e i suoi metodi di conguaglio — restano dove erano, sotto Disponibilità nel selettore dati del report. Per questo gli esempi non compaiono nel selettore; un loro duplicato sì.

Limiti

  • Un'espressione può arrivare a 4 000 caratteri; dopo che la piattaforma ha aggiunto l'impianto, l'archivio rifiuta qualsiasi query oltre i 16 KB.
  • Una metrica può restituire al massimo 500 serie su un singolo impianto.
  • La prova di esecuzione su un giorno deve concludersi entro 5 secondi.
  • Non è possibile misurare nulla con granularità inferiore a 15 minuti.

Se una metrica raggiunge uno di questi limiti, l'editor lo segnala mentre scrivi e la metrica resta una bozza finché non lo risolvi.

Un esempio svolto

Disponibilità inverter (2 % del picco CC): la quota degli intervalli di luce diurna in cui un inverter ha prodotto almeno il 2 % della sua potenza di picco CC, ponderata sulla potenza di picco ed espressa in percentuale con la condensazione quota.

Espressione:

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

Atteso (quali intervalli contano: c'è luce sufficiente):

(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 (perché gli inverter grandi pesino di più nel valore di impianto):

powerplant_inverter_peak_power

Creare una metrica con l'assistente

Non devi scrivere tu MetricsQL. L'assistente si trova dentro l'editor delle metriche: apri Nuova metrica — o una metrica qualsiasi che puoi modificare — e lo trovi come pannello di chat in alto a destra. Resta in silenzio finché non gli scrivi: prima non viene inviato nulla.

Descrivi con parole tue l'indicatore che vuoi. L'assistente conosce già l'impianto su cui ti trovi, ciò che hai compilato finora (nome, espressione, condensazione…), l'esito dell'ultima validazione e le serie che quell'impianto scrive davvero, perciò raramente deve chiederti le cose di base. Propone espressione, nome e descrizione, li valida e ne mostra un'anteprima sull'impianto, e ti avvisa quando la piattaforma non dispone dei dati richiesti o quando la query sarebbe troppo pesante.

La proposta finisce nei campi nel momento in cui arriva: l'assistente modifica insieme a te e ogni modifica viene salvata via via. Se preferisci tenere quello che avevi, Annulla sulla proposta nella chat riporta i campi allo stato precedente; la proposta resta nella chat e può essere applicata di nuovo. L'assistente porta a termine il lavoro da solo: la proposta viene salvata sulla metrica nel momento in cui nasce, quindi puoi inviare la richiesta, chiudere la pagina e ritrovare la metrica finita nell'elenco quando torni. Da lì in poi è una normale modifica: cambi un campo, rilanci l'anteprima o chiedi qualcosa di diverso.

La conversazione appartiene alla metrica, non alla scheda del browser. Chiudi l'editor e riapri la metrica, oppure ricarica la pagina: la stessa chat è ancora lì, accanto ai campi che ha scritto.

La chat dell'editor accetta solo testo. Foto e documenti — la pagina con la formula di un contratto, per esempio — restano una funzione della pagina di chat completa; con Apri nella chat porti lì la conversazione.

Usare una metrica in un report

Nell'editor dei report apri il selettore dati di un blocco e scegli il livello Metriche dell'organizzazione. Le tue metriche compaiono lì accanto agli elementi della piattaforma e si comportano esattamente come questi: stesse risoluzioni, stesse tabelle e stessi grafici. Poiché una metrica vale per tutta l'organizzazione, lo stesso blocco funziona senza modifiche in un report di qualsiasi impianto.

Che cosa non si può definire

Alcune grandezze le calcola la piattaforma stessa e vanno riprese dagli elementi esistenti anziché ricostruite:

  • Performance ratio e produzione attesa: usa gli elementi calcolati dalla piattaforma, disponibili anche come mattoni.
  • Conguaglio delle limitazioni di potenza: deriva dalla tua configurazione di mercato e tariffe.
  • Potenza nominale CA per inverter: non viene memorizzata per singolo inverter, quindi non è referenziabile.

Pagine correlate