MiroxMirox
  • Piattaforma

    • Filosofia
    • Panoramica della piattaforma
    • Risorse della piattaforma
    • Disponibilità e finestre di manutenzione
    • Rilasci e versioni
  • Mirox-Cloud

    • Panoramica del cloud
    • Microservizi connessi
  • Mirox-Agent

    • Panoramica dell'agente
    • Opzioni di distribuzione
    • Data Scraper
    • Gemello digitale
  • Dettagli tecnici

    • Raccolta delle metriche
  • Informazioni

    • Impianti supportati
  • Tipi di impianto

    • Impianti solari
    • Inseguitori solari e controllori di parco
    • Cabine di trasformazione
    • Parchi eolici
    • Accumulo a batteria
    • Sistema di allarme
  • Monitoraggio e visualizzazione

    • Monitoraggio in tempo reale
    • Gemello digitale
    • Stati dei componenti
    • Codici di stato dell'inverter
    • Eventi dell'inverter
    • Rilevamento delle perdite
    • Limiti di potenza e riduzione
    • Rilevamento dell'efficienza
    • Dashboard KPI
  • Gestione dei dati

    • Eventi
    • Livelli di allarme
    • Ticket
    • Previsioni
    • Report
    • Metriche
  • Alert Manager

    • Panoramica
    • Regole di allarme
    • Allarmi e notifiche
    • Esempi
  • Integrazione e condivisione

    • Cooperazioni
    • Token API
    • VPN
    • Conflitti di indirizzi VPN
    • Proxy
  • IA

    • Assistente IA e wizard
    • Accesso agentico (MCP)
  • Fatturazione

    • Mercato e tariffe
    • Come vengono calcolati i ricavi
    • Contabilità e fatturazione
    • Contratti
    • Certificati di servizio e fatture
  • Collaborazione

    • Inviti
  • Sicurezza

    • Autenticazione
    • Blocco account
    • Criterio di sicurezza dell'organizzazione
    • Sistema di permessi
    • Segmentazione di rete
    • Restrizioni di cooperazione
    • Audit log degli accessi
    • Attività e audit trail
    • Isolamento dei dati
  • Per iniziare

    • Onboarding
    • Configurazione iniziale
  • Personale

    • Usare la VPN
    • Usare il proxy
    • Autenticazione a due fattori
    • Sessioni
    • Token API
    • Notifiche
    • Collegare Microsoft Teams
  • Per impianto

    • Contatti
    • Dispositivi di rete
    • Datalogger
    • Lettore Modbus generico
    • Componenti
    • VPN diretta (per agente)
    • Volume dati
    • Importa lo storico
  • Organizzazione

    • Permessi dei membri
    • Criterio di sicurezza
    • Cooperazioni
    • Archiviazione file
    • Servizi VPN
    • Lavorare con i report
  • Esportazione di dati

    • Metric Export
    • Metric Export API
    • Migrare al Metric Export
    • API di esportazione legacy
    • Generazione esterna di report
    • Grafana
    • Dashboard Grafana
    • Panoramica dell'API
    • Formule MiroxQL (API)
  • Assistenza

    • Richiedi un'integrazione
  • Reportistica

    • Generatore di report esterno
    • Metric Export per Excel
  • Accesso remoto
  • Sicurezza dell'account
  • AI in Mirox
  • Importazione dello storico
  • Report
  • Esportazione dati
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Piattaforma

    • Filosofia
    • Panoramica della piattaforma
    • Risorse della piattaforma
    • Disponibilità e finestre di manutenzione
    • Rilasci e versioni
  • Mirox-Cloud

    • Panoramica del cloud
    • Microservizi connessi
  • Mirox-Agent

    • Panoramica dell'agente
    • Opzioni di distribuzione
    • Data Scraper
    • Gemello digitale
  • Dettagli tecnici

    • Raccolta delle metriche
  • Informazioni

    • Impianti supportati
  • Tipi di impianto

    • Impianti solari
    • Inseguitori solari e controllori di parco
    • Cabine di trasformazione
    • Parchi eolici
    • Accumulo a batteria
    • Sistema di allarme
  • Monitoraggio e visualizzazione

    • Monitoraggio in tempo reale
    • Gemello digitale
    • Stati dei componenti
    • Codici di stato dell'inverter
    • Eventi dell'inverter
    • Rilevamento delle perdite
    • Limiti di potenza e riduzione
    • Rilevamento dell'efficienza
    • Dashboard KPI
  • Gestione dei dati

    • Eventi
    • Livelli di allarme
    • Ticket
    • Previsioni
    • Report
    • Metriche
  • Alert Manager

    • Panoramica
    • Regole di allarme
    • Allarmi e notifiche
    • Esempi
  • Integrazione e condivisione

    • Cooperazioni
    • Token API
    • VPN
    • Conflitti di indirizzi VPN
    • Proxy
  • IA

    • Assistente IA e wizard
    • Accesso agentico (MCP)
  • Fatturazione

    • Mercato e tariffe
    • Come vengono calcolati i ricavi
    • Contabilità e fatturazione
    • Contratti
    • Certificati di servizio e fatture
  • Collaborazione

    • Inviti
  • Sicurezza

    • Autenticazione
    • Blocco account
    • Criterio di sicurezza dell'organizzazione
    • Sistema di permessi
    • Segmentazione di rete
    • Restrizioni di cooperazione
    • Audit log degli accessi
    • Attività e audit trail
    • Isolamento dei dati
  • Per iniziare

    • Onboarding
    • Configurazione iniziale
  • Personale

    • Usare la VPN
    • Usare il proxy
    • Autenticazione a due fattori
    • Sessioni
    • Token API
    • Notifiche
    • Collegare Microsoft Teams
  • Per impianto

    • Contatti
    • Dispositivi di rete
    • Datalogger
    • Lettore Modbus generico
    • Componenti
    • VPN diretta (per agente)
    • Volume dati
    • Importa lo storico
  • Organizzazione

    • Permessi dei membri
    • Criterio di sicurezza
    • Cooperazioni
    • Archiviazione file
    • Servizi VPN
    • Lavorare con i report
  • Esportazione di dati

    • Metric Export
    • Metric Export API
    • Migrare al Metric Export
    • API di esportazione legacy
    • Generazione esterna di report
    • Grafana
    • Dashboard Grafana
    • Panoramica dell'API
    • Formule MiroxQL (API)
  • Assistenza

    • Richiedi un'integrazione
  • Reportistica

    • Generatore di report esterno
    • Metric Export per Excel
  • Accesso remoto
  • Sicurezza dell'account
  • AI in Mirox
  • Importazione dello storico
  • Report
  • Esportazione dati
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Monitoraggio e visualizzazione

    • Monitoraggio in tempo reale
    • Gemello digitale
    • Stati dei componenti
    • Codici di stato dell'inverter
    • Eventi dell'inverter
    • Rilevamento delle perdite
    • Limiti di potenza e riduzione
    • Rilevamento Efficienza (PRRC)
    • Local Network Inspector
    • Monitoraggio degli accessi
    • Dashboard KPI
    • Visualizzazione a grafici
  • Gestione dei dati

    • Eventi
    • Livelli di allarme ed eventi notificabili
    • Ticket
    • Previsioni
    • Report
    • Metriche
  • Alert Manager

    • Gestore allarmi
    • Regole di allarme
    • Allarmi e notifiche
    • Esempi
  • Integrazione e condivisione

    • Cooperazioni
    • Token API
    • VPN
    • VPN: conflitti di indirizzi
    • Proxy (Accesso web ai dispositivi dell'impianto)
  • IA

    • Assistente AI e Wizard
    • Accesso agentico (MCP)
  • Fatturazione

    • Mercato e tariffe
    • Come vengono calcolati i ricavi
    • Contabilità e fatturazione
    • Contratti
    • Certificati di servizio e fatture
  • Collaborazione

    • Inviti
  • Sicurezza

    • Autenticazione
    • Account temporaneamente bloccato
    • Criterio di sicurezza dell'organizzazione
    • Sistema di permessi
    • Segmentazione di rete
    • Restrizioni dei permessi di cooperazione
    • Audit Logging degli Accessi
    • Attività e Audit Trail
    • Isolamento dei dati

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

Le metriche appartengono all'organizzazione e si trovano quindi nel suo glossario, nella pagina Esportazione dati: apri Esportazione dati nella navigazione principale e passa alla scheda Glossario. Apri in Mirox — Esportazione dati ▸ Glossario. Un link a una singola metrica ne apre direttamente l'editor: https://service.mirox.io/#/export?tab=glossary&metric=<uid>.

La pagina Report non ha più una propria scheda delle metriche; i capitoli continuano a usare le tue metriche tramite il selettore dei dati. I vecchi link alle metriche della pagina Report continuano a funzionare e portano al glossario.

  • I ruoli organizzativi Admin, Moderatore, Asset Manager (tecnico) e Asset Manager (commerciale) creano, duplicano, modificano ed eliminano le metriche.
  • Tutti i membri vedono le metriche e possono usarle nei report.
  • Una metrica contrassegnata come Privato la modificano ed eliminano solo chi l'ha creata, un Admin o un Moderatore. Tutti continuano a vederla e a usarla nei report e nelle regole di allarme, e chi può creare metriche può duplicarla. Vedi Privato.

La tabella mostra per ogni metrica i suoi tipi di impianto e dove viene usata; un clic su una riga apre l'editor. Le istruzioni passo passo sono in Lavorare con i report.

Definire una metrica

Una metrica è composta da alcuni campi descrittivi e da una a quattro 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 è contrassegnata come Non convalidata e non viene mai offerta come fonte dati in un report. Non appena l'espressione è valida, l'etichetta scompare e la metrica è utilizzabile ovunque — vedi Validazione.

  • Nome, descrizione, unità: come la metrica appare nel selettore dati del report e nel report finito.
  • Id: il nome con cui modelli e capitoli fanno riferimento alla metrica; vedi Id di una metrica.
  • 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 aggregazione 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.
  • Aggregazione: come i valori a 15 minuti diventano un unico numero:
    • Media: la media dei valori degli intervalli
    • Media ponderata: la media in cui ogni intervallo conta con il valore di un'altra espressione, Peso per intervallo: Σ(valore × peso) ÷ Σ(peso). Il peso risponde per l'intero impianto o per lo stesso componente dell'espressione.
    • Somma: il totale dei valori degli intervalli
    • Rapporto: la parte degli intervalli attesi in cui l'espressione valeva 1
    • Ultimo valore: il valore alla fine del periodo
  • Atteso (denominatore) (facoltativo, per l'aggregazione «Rapporto»): 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.
  • Riporta come: la forma in cui la metrica risponde. Valore dell'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.

Un report stampa la metrica alla risoluzione richiesta dal suo blocco — 15 minuti, oraria, giornaliera, mensile oppure un unico valore per l'intero periodo — e un'esportazione al passo che scegli, ma mai più fine della Risoluzione più fine.

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 l'aggregazione scelta e la dimensione. Una prova di esecuzione valuta poi la metrica sull'impianto scelto in Valuta su 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.

Validazione

Mentre scrivi, l'editor verifica la metrica sull'impianto scelto in Valuta su, in alto nell'editor: sintassi, serie sconosciute (con suggerimenti), la regola di non delimitazione, la compatibilità delle espressioni con l'aggregazione e la dimensione. Il verdetto elenca ciò che ancora non va e mostra il valore di ieri su quell'impianto, così come lo stamperebbe un report.

Finché resta un problema, la metrica è contrassegnata come Non convalidata. Viene salvata comunque, ma nessun report, capitolo o esportazione può leggerla, e il selettore dati non la offre. Correggi ciò che l'editor elenca e l'etichetta scompare da sola. Non convalidata non è la stessa cosa di una Bozza di report: una bozza di report è un report finito in attesa di verifica e pubblicazione.

Gli avvisi — una serie che questo impianto non ha fornito, un valore che sembra poco plausibile — non bloccano la metrica; ti dicono che cosa controllare.

Una metrica già usata da modelli che, modificandola, rendi non valida scompare dai loro report finché non torna valida: tieni d'occhio il conteggio Usato in prima di modifiche importanti.

Valuta su decide soltanto dove girano la verifica, il campione di ieri, l'anteprima, gli elementi disponibili e l'assistente. La metrica in sé non appartiene a nessun impianto: ogni report la valuta sull'impianto per cui viene creato.

Id di una metrica

Ogni metrica ha un id: lettere minuscole, cifre e trattini bassi, almeno tre caratteri, senza iniziare con una cifra, e univoco all'interno della tua organizzazione. Modelli e capitoli fanno riferimento a una metrica tramite questo id.

Puoi cambiare l'id finché nulla usa la metrica, che sia convalidata o no. Non appena un modello o un capitolo la legge, l'id è fisso: il campo è bloccato e la riga sottostante mostra dove la metrica è usata. Se ti serve davvero un nuovo id, togli prima la metrica da quei modelli e capitoli. Se l'id che digiti è già occupato, l'editor lo segnala e propone di rimettere l'id salvato.

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.
  • Valori 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 park.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(park.eeg_value - park.marktwert, 0) — è un'approssimazione mediata per leggere l'andamento: la liquidazione ripartisce ogni fascia separatamente, quindi non è mai la cifra liquidata.

Valori configurati

I valori configurati sono grandezze della configurazione dell'impianto — potenze di picco, limite inverter, numero di componenti e due valori monetari — che puoi usare all'interno di una metrica. I loro nomi iniziano con park., così il nome stesso mostra che il valore viene dalla configurazione dell'impianto e non da dati misurati.

NomeSignificatoUnitàNome precedente
park.inverter.peak_powerPotenza di picco CC per inverterWpowerplant_inverter_peak_power
park.gak.peak_powerPotenza di picco CC per quadro di campoWpowerplant_gak_peak_power
park.string.peak_powerPotenza di picco CC per stringaWpowerplant_string_peak_power
park.peak_powerPotenza di picco dell'impiantoWpowerplant_park_peak_power
park.inverter_limitLimite inverter dell'impiantoWpowerplant_park_limit_inverter
park.inverter_countNumero di inverterconteggiopowerplant_park_inverter_count
park.string_countNumero di stringheconteggiopowerplant_park_string_count
park.eeg_valueValore applicabile EEG effettivo (anzulegender Wert), valido per periodoEUR/MWhpowerplant_park_eeg_value
park.marktwertMarktwert rispetto al quale l'impianto viene liquidato, valido per periodoEUR/MWhmarket_marktwert
  • Letti dalla configurazione, non memorizzati. I valori configurati non sono conservati come serie temporali. Ogni volta che una metrica viene calcolata, Mirox li legge dalla configurazione dell'impianto e li inserisce nella query di quell'impianto. Il valore è quindi sempre quello configurato in quel momento: se correggi una potenza di picco, ogni periodo calcolato in seguito — anche quelli passati — usa il valore corretto.
  • Calcolati da Mirox. Una metrica che usa un valore configurato è disponibile nei report, nell'esportazione dati (scheda Metriche, CSV e JSON) e tramite l'API di esportazione. Non è disponibile tramite l'accesso diretto al database delle serie temporali — ad esempio nelle proprie dashboard Grafana o in qualsiasi altro strumento che interroga direttamente il database: lì i nomi park. non esistono. Lo stesso vale per il valore di impianto di una metrica per componente ponderata con un valore configurato — per esempio inverter ponderati per la loro potenza di picco —, perché Mirox calcola questa aggregazione dopo aver letto i valori dei componenti. Nell'esportazione dati queste metriche hanno un piccolo badge config; passandoci sopra con il mouse compare una breve spiegazione.
  • Ponderazione per potenza di picco. Con una potenza di picco come Peso (per esempio park.inverter.peak_power), ogni componente conta in proporzione alla sua potenza di picco configurata. Un componente senza potenza di picco inserita conta pochissimo; se nessun componente ne ha una, tutti contano allo stesso modo. I componenti nascosti non hanno un valore configurato e non contano.
  • I nomi precedenti continuano a funzionare. Le metriche salvate con i nomi precedenti funzionano senza modifiche. Le nuove metriche, i blocchi dell'editor e l'assistente usano i nomi park..
  • Serie scelta da un'impostazione dell'impianto. Alcune metriche leggono una serie presente nel database delle serie temporali, ma quale dipende dalle impostazioni dell'impianto: le metriche di riduzione liquidata contrassegnate (metodo del parco) leggono la serie del metodo di liquidazione configurato per ciascun impianto (Spitz, Spitz light o Pauschal; per un parco eolico, i metodi eolici). La loro query nell'esportazione dati mostra powerplant_<method>_… con il metodo lasciato aperto e, dopo un'anteprima, il tooltip indica il metodo di ogni impianto. Con più impianti, ciascuno conta con il proprio metodo. Con l'accesso diretto al database delle serie temporali il metodo di ogni impianto lo scegli tu; per leggere un metodo preciso indipendentemente dalle impostazioni, scegli la metrica propria di quel metodo. Nell'esportazione dati anche queste metriche hanno il badge config.

Esempi inclusi

La tabella Metriche contiene già cinque metriche che Mirox fornisce a ogni organizzazione: Connettività, Disponibilità del logger, Disponibilità dell'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 dell'aggregazione «Rapporto», l'identità per componente e una scala dell'unità.
  • Fare clic su Calcola 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ì.

Scrivere espressioni (MetricsQL)

Un'espressione si scrive in MetricsQL, il linguaggio di interrogazione dell'archivio di serie temporali della piattaforma — lo stesso con cui vengono lette le metriche grezze dietro Grafana. Viene valutata su slot di 15 minuti per un impianto alla volta: la piattaforma limita ogni serie all'impianto stesso, quindi un'espressione non nomina mai un impianto, un portafoglio o un'organizzazione. Parti dai blocchi che l'editor propone (le serie con le loro label, i valori configurati dell'impianto, i pattern), lascia che la validazione dal vivo ti dica cosa manca e visualizza l'anteprima su un impianto prima di salvare. MetricsQL è il più potente dei due modi per definire un indicatore: corsie per componente, filtro sulla luce diurna, rapporti e aggregazioni si esprimono qui — le metriche sono il successore delle formule MiroxQL, le colonne calcolate dell'esportazione legacy, che non si modificano più nell'app. Il riferimento del linguaggio è la documentazione MetricsQL pubblica del fornitore dell'archivio; le funzioni e i limiti accettati dall'editor sono elencati nei suoi blocchi. Mentre digiti, l'editor propone nomi di serie, etichette e funzioni; Tab accetta la proposta.

Costruire su altre metriche

Un'espressione può usare un'altra metrica invece di ripeterla:

  • metric("<metric id>") — un'altra metrica della tua organizzazione, tramite il suo id;
  • series("<series id>") — una serie della piattaforma come suo valore a 15 minuti per l'impianto, oppure series("<series id>", "inverter") per un valore per inverter (analogamente gak, string, …).

Un riferimento rappresenta il valore a 15 minuti dell'altra metrica, prima dell'aggregazione: metric("yield") / metric("expected_yield") divide i due valori di ogni intervallo, e poi si applica l'aggregazione di questa metrica. Una metrica referenziata può a sua volta usare riferimenti, fino a otto livelli di profondità; una metrica che finisce per riferirsi a se stessa viene rifiutata. Quando una metrica referenziata cambia, ogni metrica costruita su di essa la segue.

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 Non convalidata 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 l'aggregazione Rapporto.

Espressione:

max by (inverter_id) (max_over_time(powerplant_inverter_power_ac[900s])) > bool on(inverter_id) 0.02 * park.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):

park.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 scelto in Valuta su, ciò che hai compilato finora (nome, espressione, aggregazione…), 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 di report o nell'editor dei capitoli, scegli i dati di un blocco: le tue metriche compaiono nel selettore dati accanto agli elementi della piattaforma, contrassegnate come metrica propria, 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 abbia i tipi di impianto della metrica. Una metrica contrassegnata come Non convalidata non viene offerta.

Usare una metrica in una regola di allarme

Una metrica convalidata può essere monitorata da una regola di allarme del Gestore allarmi: la regola giudica il suo valore ogni cinque minuti su ogni impianto e genera un allarme quando supera la tua soglia. Le tue metriche compaiono nell'editor delle regole sotto Le tue metriche.

Esportare una metrica

Una metrica convalidata fa parte della raccolta di metriche. Può essere esportata come serie temporale come ogni metrica fornita da Mirox, per qualsiasi impianto che puoi leggere e su qualsiasi periodo.

Apri in Mirox

Esportazione dati ▸ Metriche — fai clic su Aggiungi metriche. Le metriche della tua organizzazione sono raggruppate come Le mie metriche.

Ciò che imposti sulla metrica decide come viene esportata:

Impostazione della metricaNell'esportazione
Risoluzione più fineIl passo più fine. Una metrica con 15 minuti offre 15 min, 1 h, giorno, settimana, mese, trimestre e anno; una con Giorno parte dal giorno. Una metrica non viene mai esportata più fine di 15 minuti.
Riporta come ▸ Valore dell'impiantoUna colonna per impianto.
Riporta come ▸ Per componenteUna colonna per componente — inverter, quadro di campo, stringa, turbina, container di batterie e così via — come le metriche dei componenti fornite da Mirox.
Aggregazione ▸ Somma con un'unità di energia (Wh, kWh, MWh)Un'energia: esportata Per intervallo oppure come Totale progressivo.
Aggregazione ▸ Somma con un'altra unitàUna grandezza conteggiata: esportata Come misurato oppure come Totale progressivo.
Aggregazione ▸ Media, Rapporto, Media ponderata, Ultimo valoreEsportata Come misurato.

Con più impianti riuniti in una colonna, una Somma viene sommata sugli impianti, una Media viene mediata (una potenza in W, var o VA viene sommata), e un Rapporto o una Media ponderata vengono ricalcolati dai totali degli impianti. Un Ultimo valore non si può riunire ed è mostrato per impianto.

Tre cose da sapere:

  • Non convalidata significa non esportabile. Il selettore mostra la metrica con l'osservazione Bozza — convalidala prima in Le mie metriche, e un link di esportazione che la nomina viene rifiutato.
  • Gli importi richiedono il permesso di contabilità. Una metrica che legge il valore applicabile EEG o il Marktwert è una metrica monetaria. La sua colonna resta vuota per gli impianti su cui ti manca il permesso di contabilità.
  • L'ID in un link è organization. seguito dall'id della metrica, ad esempio organization.inverter_availability_2pct.

Funziona anche il percorso inverso: Crea metrica, nella scheda Metriche della pagina Esportazione dati, apre questo editor senza lasciare Esportazione dati, e Torna all'esportazione dati, in cima all'editor, ti riporta all'esportazione con gli impianti, le metriche e il periodo che avevi. Aperto dal glossario, il pulsante si chiama Torna al glossario. Per un valore che ti serve una sola volta, senza nome né unità, la pagina di esportazione accetta anche una query MetricsQL grezza; una metrica è la scelta giusta non appena un valore viene riusato o entra in un report.

Le istruzioni passo passo sono in Metric Export; i parametri dei link sono nella Metric Export API.

Dove si usa una metrica

La colonna Usato in della tabella delle metriche conta i modelli e i capitoli che leggono una metrica, ad esempio «2 modelli · 1 capitolo». Un clic sul numero li mostra per nome, ciascuno con un link Apri: un modello si apre nell'editor di report, un capitolo nell'editor dei capitoli. Un modello conta sia che legga la metrica in un proprio capitolo sia tramite un capitolo di libreria. Anche i modelli di esportazione che contengono la metrica come colonna contano come utilizzo.

Finché una metrica è in uso:

  • non si può eliminare — la finestra di eliminazione elenca i modelli e i capitoli invece di offrire Elimina; togli prima la metrica da ciascuno di essi e dai modelli di esportazione che la contengono;
  • il suo id non può cambiare — vedi Id di una metrica;
  • una modifica della sua espressione compare in ogni report generato in seguito da quei modelli. I report generati prima mantengono i loro numeri.

Una metrica su cui un'altra metrica si basa o che una regola di allarme monitora non si può eliminare nemmeno; il messaggio le nomina.

Una metrica che nessuno usa si può eliminare dalla tabella o dall'editor; i report generati prima mantengono i loro numeri. Gli esempi inclusi non si possono eliminare.

Tipi di impianto

Una metrica vale per i tipi di impianto delle serie che legge. Mirox lo ricava — non lo imposti mai tu:

  • serie delle turbine e altre serie eoliche → Eolico
  • serie delle batterie → Batteria
  • serie di inverter, stringhe, quadri di campo e altre serie fotovoltaiche → Solare
  • serie che ogni impianto ha, come il contatore di immissione, il meteo o i prezzi di mercato → Tutti i tipi di impianto

Una metrica che legge serie di più tipi vale per ciascuno di essi. L'editor mostra il risultato accanto al verdetto (Vale per), e la tabella delle metriche ha una colonna Tipi di impianto. Un capitolo che usa la metrica ne eredita i tipi di impianto, quindi compare solo nei report degli impianti che ne hanno almeno uno — vedi Tipi di impianto. Se l'impianto scelto in Valuta su non ha nessuno dei tipi della metrica, l'editor lo segnala: lì la metrica non restituisce nulla, quindi scegli un altro impianto per verificarla.

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

  • Report — dove si usano le metriche
  • Gestore allarmi — regole di allarme sulle tue metriche
  • Lavorare con i report — guida passo passo, compresa la creazione di una metrica
  • FAQ sui report — perché una metrica non si può eliminare o rinominare, e altro
  • Metric Export — esporta le metriche come serie temporali
  • Metric Export API — i parametri dei link di esportazione
  • Formule MiroxQL — le colonne calcolate dell'esportazione legacy
  • Assistente IA e wizard — l'assistente che lavora anche dentro l'editor delle metriche
  • Permessi dei membri — chi può creare metriche dell'organizzazione
Prev
Report
© 2026 Mirox Verwaltungs GmbH. Tutti i diritti riservati. | Informativa sulla privacy