Metric Export

La pagina Esportazione dati esporta qualsiasi metrica dei tuoi impianti come serie temporale: dall'immissione in rete di un intero portfolio fino a un singolo sensore di irraggiamento, una turbina o una cella di batteria. Scegli gli impianti, le metriche, il periodo e il passo, controlli l'anteprima e scarichi un file CSV. Ogni esportazione è anche un link che puoi passare a Excel o a uno script.

Questa guida descrive la pagina. I parametri dietro ogni link di esportazione sono descritti nella Metric Export API.

Una sola raccolta di metriche

L'esportazione e i report leggono la stessa raccolta di metriche. Una metrica ha un solo nome, una sola unità e una sola definizione, ovunque la incontri: nel selettore dati del report, in un report finito e in un file esportato.

La raccolta contiene:

• le metriche fornite da Mirox, ordinate per livello — impianto, inverter, quadro di campo, stringa, batteria, turbina eolica, sensore, contatore, meteo, mercato e altri. I livelli sono elencati in Metriche disponibili;
• le metriche che la tua organizzazione ha definito in Metriche. Nel selettore sono raggruppate come Le mie metriche.

Una metrica contrassegnata Non convalidata in Le mie metriche non può essere esportata finché la sua espressione non supera la convalida.

Le tre schede

Esportare le metriche

1. Scegli gli impianti

In Impianti apri l'elenco degli impianti e spunta uno o più impianti; l'elenco dei portfolio accanto aggiunge interi portfolio. Gli elenchi sono gli stessi della navigazione a sinistra: ogni riga porta il tipo dell'impianto — solare, eolico o batteria — e la tua scelta compare come chip nel campo. Impianti e portfolio si possono mescolare; un impianto che sta anche in un portfolio scelto viene esportato una sola volta. In un file puoi esportare al massimo 50 impianti. Con più di un impianto scegli anche se gli impianti vengono riuniti in una colonna per metrica o mostrati affiancati — vedi Più impianti. Impianti in fusi orari diversi mettono il file in UTC — vedi Ora locale dell'impianto e UTC.

2. Aggiungi le metriche

In Metriche digita nel campo di ricerca ciò che cerchi — un nome, una parola della descrizione, un componente o un'unità, ad esempio inverter dc. Ogni parola digitata deve comparire da qualche parte in una metrica: nel nome, nell'ID, negli ID usati dall'esportazione precedente, nell'unità, nel livello o nella descrizione. I risultati migliori vengono prima: una metrica il cui nome inizia con le tue parole prima di una che le cita solo nella descrizione. Invio aggiunge il primo risultato, le frecce spostano la scelta e Sfoglia tutte le metriche apre l'intera raccolta per livello, con la stessa ricerca. energy_grid_daily trova Immissione in rete, quindi funziona anche un ID preso da un vecchio link.

Ogni riga dice che cosa misura la metrica e con quali passi può essere letta. Una riga che non puoi scegliere ne indica il motivo:

Un'esportazione contiene al massimo 20 metriche. Le metriche scelte sono elencate sotto la ricerca, nell'ordine delle colonne; trascina una riga per cambiarlo. Spiegazioni, sopra l'elenco, apre una descrizione di ogni metrica scelta: unità, frequenza di misura, passi e valori offerti e come vengono riuniti più impianti. Lì, Scarica il glossario (CSV) ti dà l'intera raccolta come file.

Se la raccolta non ha una metrica per ciò che ti serve, Crea metrica apre l'editor delle metriche della pagina Report; Torna all'esportazione dati, in cima all'editor, ti riporta qui con gli impianti, le metriche e il periodo che avevi. Per una lettura una tantum del database delle serie temporali, aggiungi invece una query MetricsQL.

3. Scegli i componenti

Una metrica di un livello di componente — inverter, quadro di campo, stringa, turbina eolica, sensore, contatore, container di batterie, rack, modulo, cella o convertitore — esporta una colonna per componente. Senza selezione ottieni tutti i componenti dell'impianto, 50 per pagina. Per restringere l'esportazione, apri il pulsante dei componenti sulla metrica e scegli quelli che ti servono, fino a 100.

È così che esporti ogni sensore di irraggiamento singolarmente, senza media: aggiungi Irraggiamento per sensore e lascia vuota la selezione dei componenti.

I componenti nascosti restano fuori. Mostra nascosti, nella finestra dei componenti, li elenca, così puoi sceglierne uno di proposito.

4. Imposta il periodo

In Periodo e passo scegli un periodo predefinito oppure imposta tu inizio e fine. I periodi predefiniti sono Oggi, Ieri, Ultimi 7 giorni, Ultimi 30 giorni, Questa settimana, Settimana precedente, Questo mese, Mese precedente, Questo trimestre, Trimestre precedente, Quest’anno e Anno precedente. Senza una scelta, l'esportazione copre il mese precedente.

Un periodo può iniziare al più presto nel 2020 e coprire al massimo cinque anni. Un periodo che arriva nel futuro finisce adesso.

5. Scegli il passo

Il passo è la durata di una riga: 1 min, 5 min, 15 min, 1 h, giorno, settimana, mese, trimestre o anno. Lasciato su automatico, Mirox sceglie un passo che ogni metrica scelta offre e che si adatta al periodo: 15 minuti fino a due giorni, un'ora fino a due mesi, un giorno fino a tre anni, un mese oltre.

Non ogni metrica può essere letta con ogni passo — vedi I passi e i loro limiti. Una metrica che non offre il passo scelto viene esportata lo stesso, al suo passo — vedi Metriche con passi diversi. Solo un passo in cui una metrica non potrebbe avere nessuna riga è disattivato e nomina quella metrica.

6. Scegli i valori

Per un'energia o un'altra grandezza conteggiata, scegli in Valori se ogni riga mostra la quantità Per intervallo oppure il Totale progressivo dall'inizio del periodo. Tutte le altre metriche vengono esportate Come misurato, e l'elenco dice come si forma ogni riga — vedi Valori.

7. Scegli il fuso orario

Ora locale dell’impianto è l'impostazione predefinita; UTC è l'alternativa. Vedi Ora locale dell'impianto e UTC.

8. Controlla l'anteprima e scarica

L'Anteprima mostra l'esportazione come grafico o come tabella. Sotto il periodo, una riga ne indica la dimensione: righe, colonne, dimensione approssimativa del file e durata. Le note sotto l'anteprima ti dicono che cosa Mirox ha fatto di propria iniziativa, ad esempio che un periodo è stato esteso a giorni interi.

Nel grafico:

• L'occhio all'inizio di ogni riga di metrica o di query nasconde la sua serie nel grafico e nella tabella, e la mostra di nuovo. Una serie nascosta resta nel download e nel link; l'impostazione fa parte dell'indirizzo della pagina, quindi un link condiviso mostra la stessa vista.
• Un clic su un nome nella legenda fa lo stesso; Maiusc+clic mostra solo quella serie. Legenda e occhi concordano sempre.
• Trascina sul grafico per ingrandire un intervallo; un doppio clic riduce di nuovo. Lo zoom cambia solo la vista.
• Il tooltip elenca fino a dieci serie, il valore più grande per primo, e dice quante altre ce ne sono.
• Un periodo lungo con un passo fine ha più punti di quanti un browser possa disegnare. Il grafico mostra allora una risoluzione più grossolana e lo dice in una nota arancione — Il grafico mostra la risoluzione 1 h per restare leggibile; tabella ed esportazione mantengono 1 min — oppure, dove non è offerto un passo più grossolano, riunisce più righe in un punto. Tabella, download e link mantengono sempre il passo che hai scelto.

In Opzioni di esportazione scegli il separatore CSV, il separatore decimale, il formato del timestamp, la lingua dei nomi delle colonne e le Intestazioni di colonna: Nomi (per le persone) oppure ID (per gli script). Il formato del timestamp cambia anche le date nella tabella, quindi l'anteprima mostra ciò che il file conterrà. Poi:

• Scarica CSV salva il file.
• Copia l'URL dell'API copia la stessa esportazione sotto forma di link. Prova prepara un token API e fornisce comandi pronti per il terminale e per Python.
• Salva come modello conserva la selezione come modello.

Query MetricsQL

Accanto alle metriche della raccolta, la scheda Metriche accetta query grezze in MetricsQL, il linguaggio di interrogazione del database delle serie temporali della piattaforma — il linguaggio usato dalle metriche della tua organizzazione e da Grafana. Una query serve per ciò per cui la raccolta non ha una metrica: una serie che il database contiene, una combinazione di serie, una funzione su di esse.

1. Fai clic su MetricsQL sotto le metriche per aprire il campo della query.
2. Digita la query, ad esempio sum by (inverter_id) (powerplant_inverter_power_ac). Mentre digiti, il campo propone nomi di serie, etichette e funzioni; Tab accetta la proposta. Invio esegue la query e la aggiunge come riga; Maiusc+Invio inizia una nuova riga dentro la query.
3. La riga mostra il testo della query su uno sfondo da codice e il chip MetricsQL dove una metrica mostra la sua unità. Le colonne della riga sono una per ogni serie che la query restituisce, come misurato. La matita trasforma il testo in un editor sul posto: Invio salva, Esc annulla. Nient'altro cambia nella riga.

Che cosa fa e non fa una query:

• Mirox aggiunge l'impianto scelto a ogni selettore della query, quindi la query non nomina mai un impianto, un parco o un'organizzazione. Una query con un'etichetta del genere viene rifiutata, e l'etichetta viene nominata.
• Una query viene letta al passo che hai scelto — qualsiasi passo, da 1 min a un anno — come la leggerebbe una dashboard: campioni grezzi a quel passo, senza modalità di valore né aggregazione. Per intervallo e Totale progressivo non le si applicano.
• Con più impianti, ogni impianto riceve le proprie colonne. Le query non vengono mai riunite tra impianti.
• Una query può restituire al massimo 500 serie su un impianto; aggregala, ad esempio con sum by (…), se ne restituisce di più. Un'esportazione contiene al massimo 5 query di al più 4 000 caratteri ciascuna, e le serie che restituiscono contano nei limiti di dimensione come ogni altra colonna.
• Nel file la colonna ha l'intestazione MetricsQL seguita dalla query e, quando la query restituisce più serie, dalle etichette di ogni serie: MetricsQL sum by (inverter_id) (powerplant_inverter_power_ac) {inverter_id="INV1"}. Con ID (per gli script) l'intestazione è expr1, expr2, … con le stesse etichette. Un file con query si distingue quindi da un'esportazione normale già dalla prima riga.
• Una query non viene salvata in un modello. Rimuovi le query per salvare le metriche come modello, oppure definisci il valore una volta per tutte come metrica della tua organizzazione: è allora convalidata, ha nome e unità, ed è offerta anche ai report.

I passi e i loro limiti

I passi offerti da una metrica dipendono da che cosa è e da quanto spesso viene misurata:

Una metrica non viene mai offerta più fine di come è misurata: una turbina eolica che trasmette ogni 10 minuti non ha valori a 1 minuto.

Il passo limita anche il periodo, perché una colonna contiene al massimo 180 000 valori:

I passi di un giorno o più coprono sempre giorni, settimane, mesi, trimestri o anni interi. Un periodo che inizia o finisce all'interno di uno di essi viene esteso all'intero intervallo, e una nota lo segnala. Le settimane iniziano di lunedì.

Metriche con passi diversi

Non ogni metrica offre ogni passo, e alcune offrono solo passi grossolani: il performance ratio parte dal giorno, un valore di mercato esiste una volta al mese. La scheda Metriche le riunisce comunque in un file:

• Una metrica con un passo più grossolano del file mantiene il suo passo. Il suo valore sta nella prima riga di ciascuno dei suoi intervalli — il valore di un giorno nella riga della sua mezzanotte, quello di un mese nella riga del suo primo giorno — e le righe intermedie restano vuote. Il grafico disegna una metrica del genere come punti. Una nota arancione sopra l'anteprima nomina queste metriche con i loro passi e offre Esporta separatamente: un link per passo, ogni metrica alla propria risoluzione.
• Una metrica che offre solo passi più fini viene letta al più grossolano di essi e riunita al passo del file secondo la regola della sua grandezza: un'energia si somma, una lettura si media, un rapporto si ricalcola dalle sue due metà, uno stato mantiene l'ultimo codice. Una nota sotto l'anteprima lo segnala.
• Due casi restano rifiutati: un valore per mese, trimestre o anno non ha riga in un file per settimana, e un valore mensile come il Marktwert non viene mai sommato o mediato in un trimestre o in un anno, perché non sarebbe quel valore. Un passo del genere resta disattivato e nomina la metrica.

Un modello decide da sé con Metriche con un altro passo: Tollerante si comporta come la scheda Metriche, Rigoroso rifiuta un link che nomina un passo che una delle sue colonne non offre. Un modello salvato dalla scheda Metriche o creato da zero è tollerante; i modelli precedenti a questa impostazione sono rigorosi. Un link di esportazione scritto a mano è rigoroso salvo indicazione contraria — vedi il parametro mismatch.

Valori: per intervallo, totale progressivo, come misurato

Per intervallo è offerto solo per l'energia. Una potenza, una temperatura o un rapporto non hanno una «quantità per intervallo», quindi vengono sempre esportati come misurati.

L'avviso sotto i 15 minuti

Un contatore conta l'energia a scatti interi, spesso di 1 kWh. In un minuto un impianto produce di rado uno scatto intero, quindi un'energia per intervallo a 1 o 5 minuti salta tra zero e uno scatto invece di disegnare una curva. Mirox avvisa quando combini le due cose e offre tre vie d'uscita:

• Passa a la metrica di potenza corrispondente, dove la raccolta ne ha una. La potenza è la grandezza giusta per una curva fine.
• Usa 15 min, il passo più fine con cui un'energia per intervallo si legge bene.
• Mantieni, se sono proprio gli scatti del contatore che vuoi vedere.

Ora locale dell'impianto e UTC

Le righe seguono l'ora locale dell'impianto, ora legale compresa. Un giorno è un giorno locale, quindi ha 23 o 25 ore quando cambia l'ora, e un mese è un mese locale.

• Con passi più brevi di un giorno, accanto all'ora c'è una colonna Scostamento UTC. Nel giorno in cui l'orologio torna indietro, l'ora tra le 02:00 e le 03:00 compare due volte; lo scostamento le distingue.
• UTC come fuso orario mette tutte le righe sul calendario UTC. Usalo quando il file entra in un sistema che si aspetta UTC.
• Impianti in fusi orari diversi condividono una sola colonna temporale, quindi un'esportazione di questo tipo è sempre in UTC. La scelta del fuso orario è allora bloccata e ne indica il motivo.

Più impianti: riuniti o per impianto

Con più di un impianto scegli tra una colonna per metrica per tutti gli impianti insieme e una colonna per impianto.

Riunite, le metriche seguono ciascuna la propria regola:

Le metriche dei componenti sono sempre mostrate per impianto. Una nota sotto l'anteprima nomina ogni metrica mostrata per impianto anziché riunita.

Modelli

Un modello (template) è un elenco salvato di metriche con le proprie impostazioni predefinite: passo, periodo, valori, fuso orario, riuniti o per impianto, e intestazioni di colonna. Ogni colonna può avere un proprio testo di intestazione, così il file mantiene le sue intestazioni anche quando una metrica viene rinominata in seguito.

Modelli di sistema

Mirox fornisce otto modelli, contrassegnati Sistema. Non possono essere modificati né eliminati.

I primi cinque succedono ai modelli dell'esportazione precedente. I loro ID e le loro colonne sono elencati nella guida alla migrazione.

I tuoi modelli

Salva come modello nella scheda Metriche, oppure Crea modello nella scheda Template, memorizza la tua selezione per l'intera organizzazione. Un modello contiene fino a 40 metriche e nessuna query MetricsQL. Apri in Metriche carica un modello nella scheda Metriche. Metriche con un altro passo decide che cosa fa un link del modello con una colonna che non offre il passo richiesto — vedi Metriche con passi diversi.

I modelli vengono creati, modificati, convertiti ed eliminati dal ruolo organizzativo Admin. Tutti nell'organizzazione possono usarli.

Una metrica della tua organizzazione usata da un modello non può essere eliminata né ricevere un nuovo ID. Se una metrica di un modello non è più disponibile — ad esempio è tornata a Non convalidata — la sua colonna resta nel file, vuota, così le posizioni delle altre colonne non si spostano.

Modelli legacy e conversione

Un modello creato prima del Metric Export è contrassegnato Legacy. È basato sul set di metriche precedente e il suo link continua a funzionare senza modifiche. I nuovi modelli sono sempre basati sulla raccolta di metriche.

Converti in nuovo modello crea un nuovo modello a partire da uno legacy. Il modello legacy non viene mai modificato, quindi i file e i link che lo usano restano come sono.

1. Mirox mostra quali colonne hanno un equivalente, se i numeri sono gli stessi (esatta) o la stessa grandezza letta in modo migliore (approssimata), e quali colonne non hanno un equivalente.
2. Dai un nome al nuovo modello e confermi.
3. Vengono mostrati entrambi i link. Excel continua a usare il vecchio link finché non lo sostituisci.

Un modello convertito esporta giorni, come la sua origine. Una colonna la cui metrica non ha un valore giornaliero — frequenza o fattore di potenza, ad esempio — non viene riportata; la finestra nomina la metrica, così puoi esportarla nella scheda Metriche.

Costruttore API

Scegli un modello e gli impianti e adatta periodo, passo e formato del file se le impostazioni predefinite del modello non vanno bene. La pagina mostra il link e un'anteprima dei dati. Prova prepara un token API e comandi pronti per quel link. Per un modello legacy, il costruttore mostra il link precedente e offre la conversione.

Un link con un periodo predefinito come Mese precedente fornisce sempre il periodo completo più recente, che è ciò che serve a una cartella di lavoro che si aggiorna da sola. Vedi Excel con Power Query.

Quando un'esportazione è troppo grande

Mirox controlla la dimensione di un'esportazione prima di leggere qualsiasi dato. Se l'esportazione è troppo grande, non viene esportato nulla e il messaggio propone ciò che ci starebbe: un passo più grossolano, oppure un periodo più breve con il numero di giorni indicato.

Per esportare di più, dividi l'esportazione:

• per tempo — un file per mese o per trimestre invece di uno per anno;
• per impianto — un file per impianto o per portfolio;
• per metrica — le metriche dei componenti in un file a parte, separate dalle metriche dell'impianto;
• per pagina — per un impianto con molti componenti, esporta i componenti pagina per pagina.

Le metriche che Mirox deve ricavare da più fonti, come Produzione (risolta), costano più di una semplice lettura del contatore. Un modello che contiene una metrica di questo tipo raggiunge meno impianti e meno mesi per file. La riga della dimensione sotto il periodo te lo dice prima del download.

Chi può esportare che cosa

• Esporti gli impianti di cui puoi leggere le misure: i ruoli di mansione Operatore, Technical Manager, Asset Manager e Visualizzatore. Un impianto che non puoi leggere resta fuori, e una nota lo nomina.
• Le metriche monetarie richiedono inoltre il permesso di contabilità, che hanno i ruoli di mansione Operatore e Asset Manager. Senza di esso, la colonna resta vuota per quell'impianto.
• Le metriche della tua organizzazione vengono esportate su ogni impianto che puoi leggere, compresi gli impianti condivisi con te tramite una cooperazione. Sono offerte a ogni ruolo organizzativo tranne Esterno.
• Fuori dal browser, un token API del gruppo Metric Export legge ogni esportazione. Non può modificare nulla.

Vecchi link e segnalibri

I link alla precedente scheda Dati raw e alla precedente scheda Metriche continuano a funzionare: aprono la scheda Metriche con gli stessi impianti, metriche, periodo e passo. Dove una metrica non ha un equivalente, un banner lo segnala e offre Copia l’URL API originale, che la fornisce ancora. Un link a uno dei cinque modelli di sistema precedenti apre il suo successore.

Le formule non si modificano più nell'app. Vedi Formule MiroxQL.

Funzionalità correlate

• Metric Export API — ogni parametro, errore e limite dei link di esportazione
• Migrare al Metric Export — i vecchi ID e le loro nuove metriche, e che cosa cambia
• API di esportazione legacy — i link di esportazione precedenti, che continuano a funzionare
• Metric Export per Excel — ricette e Power Query
• FAQ sull'esportazione dati — risposte brevi alle domande frequenti
• Metriche — le metriche proprie della tua organizzazione
• Token API — il token Metric Export