Raccolta di metriche

Mirox raccoglie i dati di prestazione dei tuoi impianti di energia rinnovabile in un unico vocabolario standardizzato di metriche — il fondamento di ogni funzionalità di monitoraggio, analisi, reportistica e previsione della piattaforma. Questa pagina è il catalogo di riferimento di ciò che viene misurato e di come le misurazioni sono organizzate.

La tassonomia completa comprende 458 nomi standardizzati di metriche distribuiti su dodici famiglie: produzione dell'impianto (powerplant), accumulo a batteria, il sistema di allarme del sito, input meteorologici, modelli derivati dal meteo e diverse famiglie operative che descrivono la raccolta stessa — monitoraggio di rete, gli agenti, la flotta di operatori, la raggiungibilità di rete di base e le sorgenti dello scraper. Le tabelle seguenti documentano le famiglie che rappresenterai più spesso nei grafici; le famiglie operative sono riassunte nelle sezioni Metriche di rete e Metriche dell'agente.

Architettura del Data Scraper

Al centro della raccolta di metriche si trova il Data Scraper, il componente edge che raccoglie dati time-series dai tuoi impianti. Invece di un singolo motore di protocollo generico, utilizza un adattatore dedicato per ciascuna famiglia di dispositivi (data logger, inverter, contatori, sistemi di batterie), ciascuno costruito per l'interfaccia di quel produttore. Il Data Scraper può operare in due modalità di distribuzione:

Raccolta basata su cloud

Quando distribuito nel cloud:

• Si connette ai parchi solari tramite connessioni internet sicure
• Aggrega centralmente i dati provenienti da più siti
• Gestisce la gestione delle connessioni e la logica di retry
• Ottimizza l'utilizzo della banda tramite polling intelligente

Raccolta basata su edge

Quando distribuito all'edge (in loco):

• Si interfaccia direttamente con le apparecchiature locali per una latenza minima
• Opera con buffering locale per gestire le interruzioni di internet
• Esegue la validazione e il filtraggio preliminare dei dati
• Si sincronizza con il cloud quando la connettività è disponibile

L'architettura a doppia modalità garantisce una raccolta dati affidabile indipendentemente dalle condizioni di connettività del sito o dalla scala del sistema.

Metriche raccolte

Il sistema di raccolta delle metriche raccoglie un insieme completo di misurazioni che forniscono piena visibilità sulle prestazioni degli impianti di energia rinnovabile. Le metriche sono raggruppate lungo tre assi ortogonali:

• Metriche del sito descrivono il sito fisico stesso — il suo impianto, il suo accumulo a batteria, il suo sistema di allarme e il meteo circostante.
• Metriche di rete descrivono la connettività tra il sito e il cloud.
• Metriche dell'agente descrivono gli agenti di raccolta dati stessi — le sorgenti dello scraper e i servizi infrastrutturali di supporto in esecuzione sul dispositivo IoT.

Metriche del sito

Le metriche del sito sono le misurazioni time-series grezze raccolte direttamente dalle apparecchiature installate presso un sito di energia rinnovabile. Sono suddivise per dominio nell'impianto (inverter FV, connessione alla rete, ecc.), nel sistema di accumulo di energia a batteria (BESS), nel sistema di allarme del sito e nel meteo (previsione e modellato).

Metriche dell'impianto

Metriche di rete elettrica

Metriche dell'inverter

Metriche della cassetta di giunzione (GAK)

Metriche delle stringhe

Metriche di controllo

Metriche di irraggiamento

Metriche ambientali

Metriche di perdita

Metriche di report

Metriche del Digital Twin

Metriche delle analitiche edge

Il Data Scraper calcola un insieme di analitiche direttamente presso l'impianto e le pubblica come serie rappresentabili in grafico accanto alle misurazioni grezze. Sono le serie alla base delle funzionalità di performance ratio, curtailment e liquidazione della piattaforma. La maggior parte delle famiglie esiste una volta per sorgente di irraggiamento — indicata come <source> qui sotto, una tra pyranometer (sensori in loco), satellite (irraggiamento derivato da satellite per il sito) o weather (irraggiamento modellato dai dati meteorologici) — così ogni sorgente mantiene le proprie serie indipendenti e un input in deriva non può mai distorcere silenziosamente le altre.

Irraggiamento e produzione modellata

L'irraggiamento sul piano dei moduli visto da ciascuna sorgente e la produzione teorica dell'impianto (senza curtailment) modellata a partire da esso. Un set per sorgente — 13 serie in totale.

Performance ratio

La produzione effettiva confrontata con la produzione modellata — un canale PR indipendente per ciascuna sorgente di irraggiamento, a livello di impianto. Vedi Potenza attesa e performance ratio per il funzionamento dei filtri.

Potenza ed energia attese

L'aspettativa calibrata sul PR — la produzione modellata scalata sull'efficienza reale dell'impianto. È la baseline con cui il watchdog di salute dei componenti confronta la produzione in tempo reale.

Modello e performance ratio per componente

L'analogo a livello di componente del modello dell'intero impianto: produzione teorica e PR di un singolo inverter, cassetta di giunzione (GAK) o stringa, usando l'orientamento e la potenza di picco propri di quel componente. Emesso per le sorgenti weather e pyranometer; le serie portano le label di identità del componente. <component> è uno tra inverter, gak, string — 12 serie in totale, più il marcatore giornaliero di completamento.

Canali di potenza live e di previsione

Riferimenti di produzione in tempo reale e prospettici.

Curtailment

La produzione mancata attribuita alla sua causa — <party> è grid (un setpoint del gestore di rete limita la produzione) o marketer (il limite del marketer diretto limita la produzione). Ogni combinazione viene emessa come potenza istantanea ed energia cumulativa, in due varianti: la serie liquidata e una serie live calcolata in tempo reale. 24 serie in totale.

Famiglie di liquidazione

Le serie a supporto della liquidazione e dell'indennizzo del curtailment. La famiglia fixed (forfettaria) implementa il metodo di liquidazione indipendente dalla sorgente: il riferimento è la potenza di rete media misurata nei 15 minuti precedenti l'inizio del curtailment, congelata per l'intera misura — nessun input di irraggiamento necessario. La famiglia Mischpreis valorizza l'energia da curtailment con il prezzo misto di mercato tedesco al quarto d'ora, fornendo un valore di ricavo in EUR per intervallo di 15 minuti.

Metriche della batteria

La famiglia battery_* è il vocabolario di metriche indipendente dal produttore per qualsiasi sistema di accumulo di energia a batteria (BESS). Segue una rigida gerarchia di componenti in cui l'identificazione delle istanze risiede nelle label, non nel nome della metrica:

battery_environment_*       sensori ambientali attorno al BESS
battery_pcs_*               Power Conversion System collegato alla rete, a monte del box
battery_box_*               un box / container BESS — la batteria DC
└── battery_storage_*       un cabinet / rack all'interno del box
    └── battery_module_*    un modulo all'interno del cabinet
        └── battery_cell_*  una singola cella all'interno del modulo

La gerarchia della batteria (box → storage → module → cell) descrive la batteria DC stessa. Il PCS (battery_pcs_*) è il convertitore AC↔DC collegato alla rete che si trova a monte del box — possiede il lato AC del BESS oltre alla propria telemetria di convertitore, ed è identificato per dispositivo dalla label pcs. Modellarlo come componente a sé stante permette di raccogliere la batteria e il suo convertitore come due dispositivi indipendenti per lo stesso container senza che le loro serie collidano.

Questa è una specifica di sola raccolta — gli adattatori pubblicano i valori grezzi esattamente come il produttore li espone, senza aggregazioni, derivazioni, modificatori _min / _max / _mean, né flag di stato / salute. Tutta l'interpretazione, le aggregazioni e gli allarmi sono compiti a valle del digital twin.

Ambiente

Sensori ambientali attorno al BESS — distinti dalla label sensor.

Livello PCS

Il Power Conversion System collegato alla rete — il convertitore AC↔DC a monte del box batteria. Possiede il lato AC del BESS (che la batteria DC non misura mai), oltre alla propria lettura del bus DC, allo stato della batteria che ritrasmette e alla telemetria lato convertitore. Un PCS è un dispositivo distinto, identificato dalla label pcs; phase distingue le grandezze AC per fase. Convenzione di segno: positivo = carica (rete → batteria); la direzione viene risolta dai contatori di energia direzionali, mai da un bit di stato.

Bus DC

La vista propria del convertitore sul collegamento DC — lo stato DC autorevole della batteria rimane a livello di box.

Lato AC

Setpoint

Vista in sola lettura degli obiettivi di dispacciamento attivi.

Contatori di energia

Pubblicati esattamente come li riportano i contatori a vita del dispositivo stesso — contatori direzionali separati, quindi non serve alcuna decisione sul segno.

Stato della batteria ritrasmesso e limiti del convertitore

Il PCS ritrasmette un riepilogo del sistema di gestione della batteria e riporta i propri limiti operativi dinamici. Dove il sistema di gestione della batteria viene raccolto direttamente, battery_box_soc è autorevole e il valore ritrasmesso è ridondante; in un sito con solo PCS è l'unico stato di carica disponibile.

Livello box

Il vertice del lato batteria — un box / container BESS. Label obbligatoria: box. Label opzionali: inverter, phase. Le metriche lato AC sono presenti solo quando la conversione AC↔DC è fisicamente situata a livello di box.

Flusso di energia lato AC

Interfaccia lato DC

Chimica e stato

Livello storage

Un cabinet / rack all'interno di un box. Label obbligatorie: box, storage. Le metriche AC sono rare a questo livello — sono presenti solo quando la conversione AC↔DC è fisicamente situata a livello di storage.

Flusso di energia lato AC

Lo stesso vocabolario AC del livello box, senza le varianti per fase o di setpoint.

Interfaccia lato DC

Chimica e stato

Livello modulo

Un modulo all'interno di un cabinet — la più piccola unità dotata di un proprio chip BMS. Label obbligatorie: box, storage, module. Le metriche AC non sono praticamente mai presenti a questo livello.

Interfaccia lato DC

Chimica e stato

Livello cella

La più piccola unità fisica. Le celle sono collegate in serie all'interno di un modulo e condividono la corrente del modulo, quindi corrente e potenza per cella non sono significative. Label obbligatorie: box, storage, module, cell.

Metriche di previsione meteo

Metriche meteo giornaliere

Metriche meteo a 15 minuti

Metriche di calcolo meteo

Metriche del modello meteo

Metriche di potenza del modello meteo

Metriche di potenza del modello clearsky

Metriche del sistema di allarme

La famiglia alarm_* è la segnalazione di allarme del sito stesso. Nulla al suo interno viene misurato: ogni valore è la posizione di un contatto a relè letto tramite gli ingressi digitali di un controllore — le uscite a relè di una centrale antintrusione, più i contatti di supervisione dell'armadio di comunicazione a cui la centrale è cablata.

Ogni serie è un indicatore 0/1 normalizzato in modo che 1 significhi sempre «la condizione è presente» (porta aperta, allarme scattato, UPS su batteria, interruttore intervenuto) e 0 significhi normale, qualunque sia la polarità del contatto. L'assenza non è mai uno zero: un segnale che il dispositivo non ha servito in questo ciclo non viene pubblicato affatto, e un contatto che l'operatore ha dichiarato non cablato viene trattenuto invece di restare permanentemente in allarme. L'identificazione dell'istanza vive nell'etichetta alarm — il sistema di allarme a cui i segnali appartengono — mai nel nome della metrica.

Ogni segnale tranne alarm_door_open apre inoltre un evento di parco con lo stesso nome finché è attivo; una porta aperta è routine e resta solo una serie. Vedi Sistema di allarme per la pagina che queste serie alimentano.

Metriche di rete

Le metriche di rete descrivono la connettività tra il dispositivo IoT e il cloud, indipendentemente da qualsiasi scraper o servizio specifico.

Metriche dell'agente

Le metriche dell'agente descrivono gli agenti di raccolta dati stessi — sia lo stato per-sorgente dei singoli adattatori dello scraper, sia la salute complessiva e il traffico degli agenti e della connettività di supporto. Queste metriche permettono alle tue dashboard di correlare le lacune nei dati con guasti degli adattatori o della connettività, anziché con le apparecchiature in misura.

Metriche delle sorgenti dello scraper

Il Data Scraper emette un insieme di queste metriche per ciascuna sorgente di adattatore attiva. Le serie sono distinte dalle label source, source_num e name, in modo che le lacune nei dati possano essere correlate direttamente con la salute dell'adattatore anziché con le apparecchiature in misura.

• scraper_health_state: Stato corrente dell'adattatore, codificato come intero: 0 = inizializzazione, 1 = sano, 2 = non sano, 3 = riconnessione, 4 = bloccato (il logger restituisce valori obsoleti/fermi), 5 = in pausa.
• scraper_cycles_total: Numero di cicli di fetch che l'adattatore ha eseguito dall'avvio del processo (si azzera al riavvio).
• scraper_errors_total: Numero di cicli di fetch terminati con un'eccezione dall'avvio del processo (si azzera al riavvio).
• scraper_last_success_timestamp: Secondi epoch Unix dell'ultimo ciclo di fetch riuscito. Emesso solo dopo il primo successo.

Metriche dei servizi dell'agente

Queste metriche tracciano la salute e l'utilizzo di rete dei singoli servizi dell'agente (Data Scraper, Digital Twin e servizi di supporto) in esecuzione su un dispositivo, così da poter capire se una lacuna nei dati riguarda l'apparecchiatura o l'agente stesso.

Traffico di rete

Salute dell'agente

VPN dell'organizzazione

Connettività e traffico per il collegamento VPN a livello di organizzazione tra l'impianto e il cloud.

VPN diretta

Connettività e traffico per ciascun tunnel VPN diretto (per impianto). Le serie portano una label vpn_name così che ogni tunnel sia identificato individualmente.

VPN SaaS

Connettività e traffico per il tunnel integrato agente-cloud che trasporta verso l'impianto il traffico di accesso remoto della piattaforma.

Server VPN

Quando l'agente stesso funge da server VPN per le connessioni in ingresso, queste metriche riportano lo stato del server e ogni peer che si connette. Le serie per peer portano le label interface, peer_uid e peer_kind, così le dashboard possono distinguere le connessioni degli utenti dai collegamenti tra siti.

• agent_vpn_server_peer_last_handshake: Secondi epoch Unix dell'ultimo handshake completato del peer; 0 significa che il peer non ne ha mai completato uno. Per i peer OpenVPN, che non espongono un timestamp per handshake, sotto la stessa metrica viene pubblicato l'orario di inizio della connessione, così una singola query copre entrambi i protocolli.

Metriche dell'operatore

La flotta di operatori invia metriche infrastrutturali per il monitoraggio dei tunnel VPN e la salute degli operatori, permettendoti di vedere lo stato della connettività lato cloud che collega i tuoi impianti alla piattaforma.

Metriche dei tunnel VPN

• operator_vpn_connected: 1 se il tunnel VPN ha un handshake recente (negli ultimi 3 minuti), 0 altrimenti
• operator_vpn_rx_bytes: Totale di byte ricevuti attraverso il tunnel VPN (counter)
• operator_vpn_tx_bytes: Totale di byte trasmessi attraverso il tunnel VPN (counter)

Metriche di salute dell'operatore

• operator_health: 1 se l'operatore ha una connessione cloud attiva, 0 se in stato di timeout
• operator_uptime_seconds: Secondi trascorsi dall'avvio del processo dell'operatore
• operator_cloud_response_age_seconds: Secondi trascorsi dall'ultima risposta riuscita dell'API cloud

Processo di raccolta

Il processo di raccolta dei dati segue un flusso di lavoro strutturato:

1. Discovery: Il sistema identifica tutti i componenti da monitorare in base alla configurazione del parco
2. Pianificazione: Le pianificazioni di raccolta sono ottimizzate in base all'importanza e alla variabilità delle metriche
3. Recupero: Il data scraper si connette ai dispositivi e raccoglie le misurazioni grezze
4. Validazione: I dati raccolti sono validati per accuratezza e conformità ai range
5. Arricchimento: Vengono aggiunte informazioni contestuali (timestamp, identificatori dei componenti, ecc.)
6. Trasmissione: I dati sono trasmessi in modo sicuro al database time-series
7. Verifica: Il sistema conferma l'avvenuta archiviazione e disponibilità

Punti di integrazione

Il sistema di raccolta delle metriche si integra con altri componenti della piattaforma:

• Dashboard di monitoraggio: Fornisce visualizzazione dei dati in tempo reale
• Rilevamento eventi: Fornisce dati per l'identificazione di anomalie e problemi
• Motore di reportistica: Fornisce misurazioni per i report di prestazione
• Sistema di analisi: Alimenta i calcoli avanzati di prestazione
• Modulo di previsione: Fornisce dati storici per i modelli di previsione

Sicurezza dei dati

Tutte le metriche raccolte sono protette tramite molteplici misure di sicurezza:

• Crittografia: I dati sono crittografati sia in transito sia a riposo
• Controllo degli accessi: Le metriche sono soggette allo stesso modello di permessi delle altre risorse
• Auditing: Ogni accesso ai dati delle metriche è registrato per finalità di conformità
• Anonimizzazione: I dati aggregati utilizzati per il benchmarking sono anonimizzati

Estensibilità

Il sistema di raccolta delle metriche è progettato per l'estensibilità:

• Nuove famiglie di dispositivi: Costruiamo un adattatore dedicato per ciascuna famiglia di dispositivi su richiesta — se il tuo impianto usa un logger, un inverter, un contatore o un sistema di batterie che non supportiamo ancora, può essere aggiunto senza un generico catch-all.
• Metriche personalizzate: Supporto per misurazioni specifiche del sito o dell'apparecchiatura.
• Sorgenti di dati esterne: Le serie meteo e di irraggiamento di riferimento vengono integrate insieme ai dati del tuo impianto per alimentare analisi e previsioni.

Funzionalità correlate

• Data Scraper — l'agente edge che raccoglie queste metriche con un adattatore dedicato per famiglia di dispositivi
• Digital Twin — trasforma le metriche grezze in produzione simulata, performance ratio e rilevamenti di perdite
• API di esportazione metriche — interroga e scarica queste metriche per il tuo uso
• MiroxQL — il formato di query per l'accesso programmatico e grezzo alle metriche raccolte
• Monitoraggio in tempo reale — dashboard live costruite sulle metriche raccolte