MiroxMirox
  • Piattaforma

    • Filosofia
    • Panoramica della piattaforma
    • Risorse della piattaforma
  • 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
    • 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
    • Ticket
    • Previsioni
    • Report
    • Metriche
  • Integrazione e condivisione

    • Cooperazioni
    • Token API
    • VPN
    • Proxy
  • IA

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

    • Mercato e tariffe
    • Contabilità e fatturazione
  • Collaborazione

    • Inviti
  • Sicurezza

    • Autenticazione
    • Blocco account
    • Sistema di permessi
    • Segmentazione di rete
    • Restrizioni di cooperazione
    • Audit log degli accessi
    • Attività e audit trail
  • Nodi

    • mrxnode
  • Applicazione

    • Controllo della porta
    • Relè generico
  • Cluster edge

    • Orchestrazione
  • 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
    • Componenti
    • VPN diretta (per agente)
    • Volume dati
    • Importa lo storico
  • Organizzazione

    • Permessi dei membri
    • Cooperazioni
    • Archiviazione file
    • Servizi VPN
  • Esportazione di dati

    • API di esportazione metriche
    • MiroxQL — linguaggio di query
    • Generazione esterna di report
    • Grafana
    • Dashboard Grafana
    • Panoramica dell'API
  • Assistenza

    • Richiedi un'integrazione
  • mrxnode

    • Panoramica
    • Guide
    • Distribuzione su container
    • Riferimento comandi
    • Risoluzione dei problemi
  • Reportistica

    • Generatore di report esterno
    • Esportazione di dati grezzi per Excel
  • Accesso remoto
  • AI in Mirox
  • Importazione dello storico
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Piattaforma

    • Filosofia
    • Panoramica della piattaforma
    • Risorse della piattaforma
  • 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
    • 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
    • Ticket
    • Previsioni
    • Report
    • Metriche
  • Integrazione e condivisione

    • Cooperazioni
    • Token API
    • VPN
    • Proxy
  • IA

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

    • Mercato e tariffe
    • Contabilità e fatturazione
  • Collaborazione

    • Inviti
  • Sicurezza

    • Autenticazione
    • Blocco account
    • Sistema di permessi
    • Segmentazione di rete
    • Restrizioni di cooperazione
    • Audit log degli accessi
    • Attività e audit trail
  • Nodi

    • mrxnode
  • Applicazione

    • Controllo della porta
    • Relè generico
  • Cluster edge

    • Orchestrazione
  • 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
    • Componenti
    • VPN diretta (per agente)
    • Volume dati
    • Importa lo storico
  • Organizzazione

    • Permessi dei membri
    • Cooperazioni
    • Archiviazione file
    • Servizi VPN
  • Esportazione di dati

    • API di esportazione metriche
    • MiroxQL — linguaggio di query
    • Generazione esterna di report
    • Grafana
    • Dashboard Grafana
    • Panoramica dell'API
  • Assistenza

    • Richiedi un'integrazione
  • mrxnode

    • Panoramica
    • Guide
    • Distribuzione su container
    • Riferimento comandi
    • Risoluzione dei problemi
  • Reportistica

    • Generatore di report esterno
    • Esportazione di dati grezzi per Excel
  • Accesso remoto
  • AI in Mirox
  • Importazione dello storico
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Piattaforma

    • Filosofia della piattaforma
    • Panoramica della piattaforma
    • Risorse della piattaforma
  • Mirox-Cloud

    • Panoramica del cloud
    • Microservizi connessi
  • Mirox-Agent

    • Mirox-Agent
    • Opzioni di distribuzione dell'agente
    • Data Scraper
    • Digital Twin
  • Dettagli tecnici

    • Raccolta di metriche

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

Nome metricaTipoUnità
powerplant_energy_grid_totalEnergiaWh
powerplant_energy_grid_out_totalEnergiaWh
powerplant_grid_energy_total_reactiveEnergiaVArh
powerplant_grid_energy_total_apparentEnergiaVAh
powerplant_power_gridPotenzaW
powerplant_grid_power_reactivePotenzaVAr
powerplant_grid_power_apparentPotenzaVA
powerplant_energy_consumed_totalEnergiaWh
powerplant_grid_energy_total_reactive_capacitiveEnergiaVArh
powerplant_grid_energy_total_reactive_inductiveEnergiaVArh
powerplant_grid_powerPotenzaW
powerplant_grid_energy_totalEnergiaWh

powerplant_grid_power è l'interpolazione al minuto di powerplant_power_grid, sommata su tutti i contatori, e powerplant_grid_energy_total il contatore di energia della piattaforma (consapevole dei riavvii) integrato da essa — l'unica serie monotona di produzione del sito letta dalle analisi (un parco con più contatori ha più powerplant_energy_grid_total grezzi). Entrambe portano l'etichetta boot_time; leggere il contatore con sum(increase(…)).

Nota sulla convenzione di denominazione

Le metriche grezze di contatore powerplant_energy_grid_* e powerplant_power_grid non seguono lo schema di denominazione standard (powerplant_grid_*) per motivi legacy e mantengono i loro nomi per compatibilità. Non leggere powerplant_grid_power / powerplant_grid_energy_total come loro gemelle rinominate: sono le serie calcolate al minuto dalla piattaforma descritte sopra — una serie di impianto sommata, non una per contatore.

Contatori di partenza FV e batteria

Un parco con una batteria (o un altro produttore) dietro lo stesso punto di connessione alla rete misura ogni partenza separatamente. La famiglia di rete sopra è il punto di connessione, sommato a livello di parco; la partenza FV pubblica la famiglia powerplant_pv_* e quella della batteria la famiglia powerplant_battery_* — le stesse grandezze con la stessa convenzione di segno (produzione / scarica positive). I due contatori della batteria prendono il nome da ciò che l'unità ha fatto: _energy_discharge_total è ciò che ha erogato, _energy_charge_total ciò che ha assorbito. Da non confondere con le famiglie battery_* sotto, che sono la vista del controller della batteria sui livelli box, storage, modulo e cella.

Nome metricaTipoUnità
powerplant_pv_powerPotenzaW
powerplant_pv_power_apparentPotenzaVA
powerplant_pv_power_reactivePotenza reattivaVAr
powerplant_pv_energy_totalEnergiaWh
powerplant_pv_energy_consumed_totalEnergiaWh
powerplant_pv_energy_total_reactiveEnergiaVArh
powerplant_pv_energy_total_reactive_capacitiveEnergiaVArh
powerplant_pv_energy_total_reactive_inductiveEnergiaVArh
powerplant_battery_powerPotenzaW
powerplant_battery_power_apparentPotenzaVA
powerplant_battery_power_reactivePotenza reattivaVAr
powerplant_battery_energy_discharge_totalEnergiaWh
powerplant_battery_energy_charge_totalEnergiaWh
powerplant_battery_energy_total_reactiveEnergiaVArh
powerplant_battery_energy_total_reactive_capacitiveEnergiaVArh
powerplant_battery_energy_total_reactive_inductiveEnergiaVArh

Totali CA dell'impianto

Totali CA a livello di impianto pubblicati dai logger che riportano l'impianto come un'unica unità CA (nomenclatura legacy, energy/power prima di ac).

Nome metricaTipoUnità
powerplant_energy_ac_totalEnergiaWh
powerplant_energy_ac_reactive_totalEnergiaVArh
powerplant_power_acPotenzaW
powerplant_power_ac_reactivePotenza reattivaVAr
powerplant_power_ac_apparentPotenzaVA

Metriche dell'inverter

Nome metricaTipoUnità
powerplant_inverter_energy_ac_totalEnergiaWh
powerplant_inverter_energy_dc_totalEnergiaWh
powerplant_inverter_energy_consumed_totalEnergiaWh
powerplant_inverter_power_acPotenzaW
powerplant_inverter_power_dcPotenzaW
powerplant_inverter_power_reactivePotenzaVAr
powerplant_inverter_power_maxPotenzaW
powerplant_inverter_setpoint_power_activeSetpointW
powerplant_inverter_setpoint_power_active_percentSetpoint%
powerplant_inverter_setpoint_power_reactiveSetpointVAr
powerplant_inverter_max_powerShutdown%
powerplant_inverter_voltage_acTensioneV
powerplant_inverter_current_acCorrenteA
powerplant_inverter_voltage_dcTensioneV
powerplant_inverter_current_dcCorrenteA
powerplant_inverter_resistance_isoResistenzaOhm
powerplant_inverter_vendor_statusStatocodice
powerplant_inverter_cosFattore di potenza-
powerplant_inverter_frequencyFrequenzaHz
powerplant_inverter_temperatureTemperatura°C
powerplant_inverter_current_ac_phaseCorrenteA
powerplant_inverter_voltage_ac__phase__L1_L2TensioneV
powerplant_inverter_voltage_ac__phase__L2_L3TensioneV
powerplant_inverter_voltage_ac__phase__L3_L1TensioneV
powerplant_inverter_current_ac__phase__L1CorrenteA
powerplant_inverter_current_ac__phase__L2CorrenteA
powerplant_inverter_current_ac__phase__L3CorrenteA
powerplant_inverter_powerPotenzaW
powerplant_inverter_energy_totalEnergiaWh
powerplant_inverter_data_completeValiditàbool
powerplant_inverter_derating_reasonMotivocode
powerplant_inverter_operating_stateStatocode

powerplant_inverter_power / powerplant_inverter_energy_total sono gli equivalenti al minuto, sommati sugli inverter, della coppia di rete sopra (una serie di impianto con etichetta boot_time, non una per inverter). powerplant_inverter_data_complete è il verdetto al minuto su quella somma: 1 quando ogni inverter atteso ha contribuito, 0 altrimenti, assente quando nessun verdetto era possibile. powerplant_inverter_operating_state è lo stato operativo standard della piattaforma derivato dal codice di stato del produttore (0 sconosciuto, 1 inattivo, 2 in produzione, 3 produzione limitata, 4 auto-limitazione, 5 fermato da comando, 6 fermato da protezione, 7 irraggiungibile, 8 guasto — numerato in modo che max restituisca lo stato peggiore), mentre powerplant_inverter_derating_reason è il codice del motivo di una limitazione nel vocabolario del produttore.

Metriche della cassetta di giunzione (GAK)

Nome metricaTipoUnità
powerplant_gak_voltageTensioneV
powerplant_gak_currentCorrenteA
powerplant_gak_powerPotenzaW
powerplant_gak_energy_totalEnergiaWh
powerplant_gak_temperatureTemperatura°C

Metriche delle stringhe

Nome metricaTipoUnità
powerplant_string_voltageTensioneV
powerplant_string_currentCorrenteA
powerplant_string_powerPotenzaW
powerplant_string_energy_totalEnergiaWh

Metriche della turbina eolica

Una turbina eolica è un componente piatto dell'impianto come un inverter, identificato dall'etichetta turbine_id (con turbine_name e turbine_vendor). I valori sono le medie a 10 minuti registrate dal controller della turbina. powerplant_turbine_blade_pitch_angle porta un'etichetta blade (A/B/C) e powerplant_turbine_temperature un'etichetta sensor (moltiplicatore, generatore, trasformatore, navicella, …). Le serie time_* sono i secondi per intervallo di 10 minuti trascorsi in ogni stato — disponibilità misurata, non dedotta dai buchi. Le serie di limitazione e perdita sono il divario misurato tra potenza possibile e reale, attribuito a una parte dal codice di stato del controller (grid = gestore di rete, marketer = dispacciamento del trader / controller di parco, environment = fermi per ombra / pipistrelli / ghiaccio / meteo, command = fermi manuali o di servizio, fault = allarme turbina); i loro contatori _energy_total sono totali cumulativi mantenuti dalla piattaforma.

Nome metricaTipoUnità
powerplant_turbine_power_acPotenzaW
powerplant_turbine_power_ac_possiblePotenzaW
powerplant_turbine_power_ac_reactivePotenza reattivaVAr
powerplant_turbine_energy_ac_totalEnergiaWh
powerplant_turbine_energy_consumed_totalEnergiaWh
powerplant_turbine_voltage_ac__phase__L1TensioneV
powerplant_turbine_voltage_ac__phase__L2TensioneV
powerplant_turbine_voltage_ac__phase__L3TensioneV
powerplant_turbine_current_ac__phase__L1CorrenteA
powerplant_turbine_current_ac__phase__L2CorrenteA
powerplant_turbine_current_ac__phase__L3CorrenteA
powerplant_turbine_frequencyFrequenzaHz
powerplant_turbine_power_factorFattore di potenza-
powerplant_turbine_wind_speedVelocità del ventom/s
powerplant_turbine_wind_directionDirezione del vento°
powerplant_turbine_nacelle_directionDirezione°
powerplant_turbine_rotor_speedVelocitàrpm
powerplant_turbine_generator_speedVelocitàrpm
powerplant_turbine_blade_pitch_angleAngolo°
powerplant_turbine_temperatureTemperatura°C
powerplant_turbine_temperature_ambientTemperatura°C
powerplant_turbine_time_runningDuratas
powerplant_turbine_time_okDuratas
powerplant_turbine_time_alarmDuratas
powerplant_turbine_time_wind_okDuratas
powerplant_turbine_time_grid_okDuratas
powerplant_turbine_time_serviceDuratas
powerplant_turbine_time_derate_remoteDuratas
powerplant_turbine_time_derate_internalDuratas
powerplant_turbine_vendor_statusStatocode
powerplant_turbine_pause_reasonMotivocode
powerplant_turbine_operating_stateStatocode
powerplant_turbine_setpoint_power_activeSetpointW
powerplant_turbine_stop_commandComandobool
powerplant_turbine_curtailment_grid_powerPotenzaW
powerplant_turbine_curtailment_marketer_powerPotenzaW
powerplant_turbine_curtailment_environment_powerPotenzaW
powerplant_turbine_curtailment_command_powerPotenzaW
powerplant_turbine_loss_fault_powerPotenzaW
powerplant_turbine_curtailment_grid_energy_totalEnergiaWh
powerplant_turbine_curtailment_marketer_energy_totalEnergiaWh
powerplant_turbine_curtailment_environment_energy_totalEnergiaWh
powerplant_turbine_curtailment_command_energy_totalEnergiaWh
powerplant_turbine_loss_fault_energy_totalEnergiaWh

Serie informative dei componenti

I nomi che un operatore ha dato ai componenti, pubblicati come serie proprie affinché i dashboard mostrino i nomi attuali senza che la telemetria li porti come etichette (un cambio di etichetta dividerebbe una serie). Una serie per componente, indicizzata esattamente come la sua telemetria (inverter_id; gak_id; string_number, con gak_id solo dietro una cassetta di parallelo; id per un contatore di immissione; turbine_id) più l'etichetta del nome (inverter_name, gak_name, string_name, meter_name, turbine_name). Il valore è l'istante di emissione; la serie viene rinnovata a ogni sincronizzazione dell'albero, quindi una rinomina compare alla sincronizzazione successiva. Mai tracciare, sommare o creare allarmi su queste serie — vanno unite alla telemetria come mostrato in Creare i propri dashboard Grafana.

Nome metricaTipoUnità
powerplant_inverter_infoInfo-
powerplant_gak_infoInfo-
powerplant_string_infoInfo-
powerplant_feedin_infoInfo-
powerplant_turbine_infoInfo-

Metriche di controllo

Nome metricaTipoUnità
powerplant_max_power_by_gridShutdown%
powerplant_max_power_by_externalShutdown%
powerplant_max_power_by_external_wShutdownW
powerplant_max_power_by_localShutdown%
powerplant_battery_setpoint_externalControllo%
powerplant_battery_setpoint_local_wControlloW
powerplant_max_power_import_by_gridLimite%
powerplant_battery_setpoint_external_wSetpointW
powerplant_battery_setpoint_appliedSetpoint%
powerplant_battery_setpoint_applied_wSetpointW
powerplant_battery_max_power_charge_by_gridLimite%
powerplant_battery_max_power_charge_by_grid_wLimiteW
powerplant_battery_max_power_discharge_by_gridLimite%
powerplant_battery_max_power_discharge_by_grid_wLimiteW
powerplant_control_connection_gridControllobool
powerplant_control_connection_externalControllobool
powerplant_control_interface_readyControllobool
powerplant_power_maxPotenzaW
powerplant_max_power_sourceControllo-

I setpoint della batteria hanno segno (positivo = scarica, negativo = carica): _external / _external_w è l'ordine del trader, _local_w l'inserimento manuale dell'operatore, _applied / _applied_w ciò che il controller di impianto comanda effettivamente allo storage dopo aver fuso ogni ordine e ogni limite in un unico numero. I limiti sono grandezze positive: powerplant_max_power_import_by_grid è il limite del gestore di rete su ciò che l'impianto può prelevare (100 = nessuna riduzione), e le coppie battery_max_power_charge/discharge_by_grid i limiti del gestore di rete sullo storage all'interno di un impianto più grande, una corsia per direzione. Ogni dispositivo pubblica la corsia che esprime nativamente (percentuale o watt); la piattaforma non converte mai tra le due.

Metriche di irraggiamento

Nome metricaTipoUnità
powerplant_solar_radiationIrraggiamentoW/m²
powerplant_energy_irradiation_totalEnergiaWh
powerplant_solar_ghi_referenceIrraggiamentoW/m²
powerplant_solar_ghi_reference_energyEnergiaWh

Metriche ambientali

Nome metricaTipoUnità
powerplant_humidityUmidità%
powerplant_ambient_temperatureTemperatura°C
powerplant_module_temperatureTemperatura°C
powerplant_wind_speedVelocità del ventom/s
powerplant_wind_directionDirezione del vento°

Metriche di perdita

Nome metricaTipoUnità
powerplant_energy_loss_totalEnergiaWh
powerplant_power_lossPotenzaW

Metriche di report

Nome metricaTipoUnità
powerplant_power_reportPotenzaW
powerplant_energy_report_totalEnergiaWh
powerplant_energy_radiation_totalEnergiaWh

Metriche del Digital Twin

Nome metricaTipoUnità
powerplant_grid_power_simulationPotenzaW
powerplant_grid_energy_total_simulationEnergiaWh
powerplant_grid_prrcPRRC-
powerplant_grid_sim_errErrore-
powerplant_inverter_power_ac_simulationPotenzaW
powerplant_inverter_energy_ac_total_simulationEnergiaWh
powerplant_inverter_prrcPRRC-
powerplant_inverter_sim_errErrore-
powerplant_gak_power_simulationPotenzaW
powerplant_gak_energy_total_simulationEnergiaWh
powerplant_gak_prrcPRRC-
powerplant_gak_sim_errErrore-
powerplant_string_power_simulationPotenzaW
powerplant_string_energy_total_simulationEnergiaWh
powerplant_string_shadow_factorFattore-
powerplant_string_prrcPRRC-
powerplant_string_sim_errErrore-
powerplant_grid_power_lossPotenzaW
powerplant_grid_energy_total_lossEnergiaWh
powerplant_inverter_power_lossPotenzaW
powerplant_inverter_energy_total_lossEnergiaWh
powerplant_gak_power_lossPotenzaW
powerplant_gak_energy_total_lossEnergiaWh
powerplant_string_power_lossPotenzaW
powerplant_string_energy_total_lossEnergiaWh

Metriche di stato

Il verdetto giornaliero di produzione della piattaforma per componente: 1 quando il componente ha prodotto normalmente, 0 altrimenti, con lo stato dettagliato nell'etichetta status. Da non confondere con powerplant_inverter_operating_state, che è ciò che il dispositivo stesso riporta a ogni interrogazione.

Nome metricaTipoUnità
powerplant_string_statusStatobool
powerplant_gak_statusStatobool
powerplant_inverter_statusStatobool
powerplant_grid_statusStatobool

Dati configurati

Pubblicati una volta per giorno locale del parco dalla piattaforma a partire dalla configurazione dell'impianto, mai misurati: la potenza di picco di ogni componente e del parco, il limite inverter del parco e i conteggi dei componenti. I componenti nascosti sono esclusi e un valore non configurato non scrive alcun campione, così "non configurato" resta distinguibile da "configurato a zero". Da leggere come qualsiasi serie, ad es. last_over_time(powerplant_inverter_peak_power[1d]).

Nome metricaTipoUnità
powerplant_inverter_peak_powerPotenzaW
powerplant_gak_peak_powerPotenzaW
powerplant_string_peak_powerPotenzaW
powerplant_park_peak_powerPotenzaW
powerplant_park_limit_inverterPotenzaW
powerplant_park_inverter_countConteggio-
powerplant_park_string_countConteggio-

Metriche deprecate

Mantenute solo per i dashboard che già le usano — i nuovi dashboard devono usare powerplant_solar_radiation e powerplant_inverter_frequency.

Nome metricaTipoUnità
powerplant_power_radiationPotenzaW
powerplant_frequency_gridFrequenzaHz

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.

Pattern del nome metricaTipoUnitàDescrizione
powerplant_<source>_radiation_powerIrraggiamentoW/m²Irraggiamento sul piano dei moduli da questa sorgente — la luce solare che colpisce effettivamente i moduli.
powerplant_<source>_radiation_energy_totalEnergiaWh/m²Irradiazione cumulativa integrata a partire dalla serie qui sopra.
powerplant_pyranometer_ghi_radiation_powerIrraggiamentoW/m²Irraggiamento orizzontale (GHI) medio dell'impianto, ripulito — presente solo quando l'impianto dispone di piranometri orizzontali.
powerplant_<source>_powerPotenzaWProduzione teorica dell'impianto modellata dall'irraggiamento di questa sorgente e dagli orientamenti dei moduli dell'impianto.
powerplant_<source>_energy_totalEnergiaWhEnergia modellata cumulativa.
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.

Pattern del nome metricaTipoUnitàDescrizione
powerplant_<source>_prPerformance ratio-Produzione misurata rispetto alla produzione modellata.
powerplant_<source>_pr_filterFiltro-Suddivisione per filtro — quale filtro di qualità (luce scarsa, clipping, curtailment, gelo/neve/nebbia, gap di dati) ha escluso un istante dal PR pulito.
powerplant_<source>_pr_validityValiditàbool1 quando l'istante ha superato tutti i filtri e conta per il PR affidabile.
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.

Pattern del nome metricaTipoUnitàDescrizione
powerplant_<source>_expected_powerPotenzaWProduzione attesa dell'impianto nelle condizioni correnti.
powerplant_<source>_expected_energy_totalEnergiaWhEnergia attesa cumulativa.
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.

Pattern del nome metricaTipoUnitàDescrizione
powerplant_<source>_<component>_powerPotenzaWProduzione modellata di un componente dall'irraggiamento di questa sorgente.
powerplant_<source>_<component>_prPerformance ratio-Performance ratio per componente (solo valori puliti e filtrati).
powerplant_simulation_day_completeMarcatore-Registrato una volta per sorgente e giorno quando le serie del modello della giornata risultano verificate come complete.
Canali di potenza live e di previsione

Riferimenti di produzione in tempo reale e prospettici.

Nome metricaTipoUnitàDescrizione
powerplant_pyranometer_live_powerPotenzaWPotenza attesa in tempo reale, corretta per il PR, dai sensori in loco.
powerplant_satellite_live_powerPotenzaWPotenza attesa in tempo reale, corretta per il PR, dall'irraggiamento satellitare.
powerplant_pyranometer_live_energy_totalEnergiaWhEnergia cumulativa del canale live da piranometro.
powerplant_satellite_live_energy_totalEnergiaWhEnergia cumulativa del canale live da satellite.
powerplant_clearsky_powerPotenzaWProduzione teorica in condizioni ideali (cielo sereno) — il tetto fisico per una giornata consolidata.
powerplant_clearsky_energy_totalEnergiaWhEnergia cumulativa di cielo sereno.
powerplant_weather_forecast_powerPotenzaWPrevisione di produzione day-ahead derivata dai dati meteo.
powerplant_weather_forecast_energy_totalEnergiaWhEnergia di previsione cumulativa.
powerplant_clearsky_forecast_powerPotenzaWPrevisione di cielo sereno — il tetto in condizioni ideali per l'orizzonte di previsione.
powerplant_clearsky_forecast_energy_totalEnergiaWhEnergia cumulativa della previsione di cielo sereno.
powerplant_weather_forecast_radiation_powerIrraggiamentoW/m²Irraggiamento nel piano dei moduli, ponderato per la capacità, da cui viene calcolata la potenza della previsione meteo — l'ingresso proprio della previsione, come misura.
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.

Pattern del nome metricaTipoUnitàDescrizione
powerplant_<source>curtailment<party>_powerPotenzaWPerdita da curtailment liquidata — produzione mancata a causa del soggetto che impone il curtailment vincolante.
powerplant_<source>curtailment<party>_energy_totalEnergiaWhEnergia da curtailment liquidata cumulativa.
powerplant_<source>live_curtailment<party>_powerPotenzaWLa stessa attribuzione calcolata live, con timestamp reali.
powerplant_<source>live_curtailment<party>_energy_totalEnergiaWhEnergia da curtailment live cumulativa.
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.

Pattern del nome metricaTipoUnitàDescrizione
powerplant_fixed_curtailment_<party>_powerPotenzaWPerdita da curtailment forfettaria rispetto al riferimento congelato pre-curtailment.
powerplant_fixed_curtailment_<party>_energy_totalEnergiaWhEnergia da curtailment forfettaria cumulativa.
powerplant_fixed_curtailment_reference_powerPotenzaWL'ultima potenza di riferimento valida senza curtailment che il metodo forfettario congela all'inizio del curtailment.
powerplant_mischpreis_<variant>_<party>_revenueRicavoEURValore di mercato dell'energia soggetta a curtailment per intervallo di 15 minuti. <variant> è uno dei canali di curtailment qui sopra: pyranometer, satellite, weather, le loro controparti _live, oppure fixed — 14 serie in totale.
Famiglie di conguaglio eolico

L'eolico onshore conguaglia la limitazione per turbina e somma in una corsia di parco: i punti per turbina portano un'etichetta turbine_id, la somma di parco nessuna — separarli con turbine_id!~".+", poiché un semplice sum(...) su entrambi conta doppio. Tre metodi condividono la stessa matematica e le stesse etichette: nacelle (l'anemometro della turbina stessa alimenta la curva di potenza certificata), windref (il predefinito — la velocità del vento di una turbina di riferimento o di un servizio meteorologico) e windfixed (forfettario: l'ultima potenza misurata senza restrizioni, congelata per l'intera misura). L'immissione Marktprämie è l'immissione in rete misurata con ogni quarto d'ora a prezzo negativo azzerato, una copia per negative_price_rule. <party> è grid o marketer.

Schema del nome metricaTipoUnitàDescrizione
powerplant_nacelle_curtailment_<party>_powerPotenzaWPerdita da limitazione, metodo anemometro di navicella.
powerplant_nacelle_curtailment_<party>_energy_totalEnergiaWhEnergia di limitazione cumulata, metodo navicella.
powerplant_windref_curtailment_<party>_powerPotenzaWPerdita da limitazione, metodo vento di riferimento (predefinito).
powerplant_windref_curtailment_<party>_energy_totalEnergiaWhEnergia di limitazione cumulata, metodo vento di riferimento.
powerplant_windfixed_curtailment_<party>_powerPotenzaWPerdita da limitazione, metodo eolico forfettario.
powerplant_windfixed_curtailment_<party>_energy_totalEnergiaWhEnergia di limitazione cumulata, metodo eolico forfettario.
powerplant_marktpraemie_feedin_powerPotenzaWImmissione idonea alla Marktprämie come media al quarto d'ora.
powerplant_marktpraemie_feedin_energy_totalEnergiaWhEnergia di immissione idonea alla Marktprämie cumulata, per mese di consegna (etichetta period).
powerplant_mischpreis_<wind method>_grid_revenueRicavoEURValore di mercato dell'energia limitata dalla rete per intervallo di 15 minuti; <wind method> è nacelle, windref o windfixed. Solo somma di parco, solo parte rete.

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.

Due tipi distinti di "tensione"

La specifica separa deliberatamente due grandezze fisicamente diverse che si misurano entrambe in volt:

  • Tensione di cella (*_cell_voltage) — la tensione chimica ai morsetti prodotta dalle celle. A livello di cella è la tensione della singola cella (~3,2 V per una cella LFP). Ai livelli superiori è la somma di tutte le tensioni di cella sulla stessa stringa in serie. Varia solo con lo stato di carica.
  • Tensione di interfaccia (*_voltage_dc, _dc_in, _dc_out) — ciò che viene immesso o prelevato dalla batteria ai suoi morsetti elettrici. Differisce dalla tensione di cella di un valore I·R durante la carica / scarica.

I due valori sono fisicamente identici quando la batteria è a riposo; divergono per la caduta IR nel momento in cui scorre una qualsiasi corrente.

Varianti DC consapevoli della direzione

Per ciascuna grandezza DC (voltage_dc, current_dc, power_dc) ai livelli box, storage e module esistono tre varianti: *_dc (con segno, registro singolo del produttore), *_dc_in (sempre positivo — valore durante la carica) e *_dc_out (sempre positivo — valore durante la scarica). Gli adattatori pubblicano quale(i) variante(i) il produttore effettivamente espone.

Ambiente

Sensori ambientali attorno al BESS — distinti dalla label sensor.

Nome metricaTipoUnità
battery_environment_temperatureTemperatura°C
battery_environment_humidityUmidità%

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.

Nome metricaTipoUnitàDescrizione
battery_pcs_voltage_dcTensioneVTensione del bus DC misurata al convertitore.
battery_pcs_current_dcCorrenteACorrente DC. Con segno (+ = carica).
battery_pcs_power_dcPotenzaWPotenza DC. Con segno.
Lato AC
Nome metricaTipoUnitàDescrizione
battery_pcs_voltage_acTensioneVTensione AC RMS concatenata.
battery_pcs_voltage_ac__phase__L1_L2TensioneVTensione AC per fase (concatenata).
battery_pcs_voltage_ac__phase__L2_L3TensioneVTensione AC per fase (concatenata).
battery_pcs_voltage_ac__phase__L3_L1TensioneVTensione AC per fase (concatenata).
battery_pcs_current_acCorrenteACorrente AC RMS.
battery_pcs_current_ac__phase__L1CorrenteACorrente AC per fase.
battery_pcs_current_ac__phase__L2CorrenteACorrente AC per fase.
battery_pcs_current_ac__phase__L3CorrenteACorrente AC per fase.
battery_pcs_frequencyFrequenzaHzFrequenza AC.
battery_pcs_power_acPotenzaWPotenza attiva, lato AC. Con segno.
battery_pcs_power_ac_inPotenzaWPotenza attiva verso la batteria (carica dalla rete). Sempre positiva.
battery_pcs_power_ac_outPotenzaWPotenza attiva in uscita dalla batteria (scarica verso la rete). Sempre positiva.
battery_pcs_power_ac_reactivePotenza reattivaVArPotenza reattiva, lato AC. Con segno.
battery_pcs_power_factorFattore di potenza-Fattore di potenza (−1…1).
Setpoint

Vista in sola lettura degli obiettivi di dispacciamento attivi.

Nome metricaTipoUnitàDescrizione
battery_pcs_power_ac_setpointSetpointWSetpoint di potenza attiva. Con segno.
battery_pcs_power_ac_setpoint_reactiveSetpointVArSetpoint di potenza reattiva. Con segno.
battery_pcs_power_factor_setpointSetpoint-Setpoint del fattore di potenza.
battery_pcs_vendor_statusStatocodeLo stato operativo del convertitore nel vocabolario del produttore (l'etichetta battery_vendor seleziona la tabella di decodifica). Un buco significa "non letto"; mai sommare o mediare.
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.

Nome metricaTipoUnitàDescrizione
battery_pcs_energy_ac_in_totalEnergiaWhEnergia AC caricata nella batteria sull'intera vita utile.
battery_pcs_energy_ac_out_totalEnergiaWhEnergia AC scaricata dalla batteria sull'intera vita utile.
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.

Nome metricaTipoUnitàDescrizione
battery_pcs_socStato di carica%Stato di carica ritrasmesso dal sistema di gestione della batteria (0–100).
battery_pcs_current_limit_chargeLimiteACorrente di carica massima consentita (dinamica).
battery_pcs_current_limit_dischargeLimiteACorrente di scarica massima consentita.
battery_pcs_power_limit_chargeLimiteWPotenza di carica massima consentita.
battery_pcs_power_limit_dischargeLimiteWPotenza di scarica massima consentita.
battery_pcs_temperatureTemperatura°CTemperatura del convertitore — lo stato termico del convertitore, non una temperatura di cella della batteria.

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
Nome metricaTipoUnità
battery_box_voltage_acTensioneV
battery_box_voltage_ac__phase__L1_L2TensioneV
battery_box_voltage_ac__phase__L2_L3TensioneV
battery_box_voltage_ac__phase__L3_L1TensioneV
battery_box_current_acCorrenteA
battery_box_current_ac__phase__L1CorrenteA
battery_box_current_ac__phase__L2CorrenteA
battery_box_current_ac__phase__L3CorrenteA
battery_box_frequencyFrequenzaHz
battery_box_power_acPotenzaW
battery_box_power_ac_inPotenzaW
battery_box_power_ac_outPotenzaW
battery_box_power_ac_reactivePotenza reattivaVAr
battery_box_power_ac_setpointSetpointW
battery_box_power_ac_setpoint_reactiveSetpointVAr
battery_box_energy_ac_in_totalEnergiaWh
battery_box_energy_ac_out_totalEnergiaWh
Interfaccia lato DC
Nome metricaTipoUnità
battery_box_voltage_dcTensioneV
battery_box_voltage_dc_inTensioneV
battery_box_voltage_dc_outTensioneV
battery_box_current_dcCorrenteA
battery_box_current_dc_inCorrenteA
battery_box_current_dc_outCorrenteA
battery_box_power_dcPotenzaW
battery_box_power_dc_inPotenzaW
battery_box_power_dc_outPotenzaW
battery_box_energy_dc_in_totalEnergiaWh
battery_box_energy_dc_out_totalEnergiaWh
Chimica e stato
Nome metricaTipoUnitàDescrizione
battery_box_cell_voltageTensione (somma)VSomma delle tensioni di cella sul bus DC del box.
battery_box_socStato di carica%Stato di carica dell'intero box (0–100).
battery_box_sohStato di salute%Stato di salute dell'intero box (0–100).
battery_box_temperatureTemperatura°CTemperatura rappresentativa a livello di box.
battery_box_energy_nominalEnergiaWhEnergia nominale installata in cella a inizio vita. Si riduce nel tempo con il SoH.
battery_box_energy_usableEnergiaWhEnergia utilizzabile massima — la capacità statica consentita dal BMS a cui corrisponde SoC = 100 % (tipicamente 85–95 % di _nominal).
battery_box_energy_chargedEnergiaWhEnergia attualmente immagazzinata nel box, derivata da soc / 100 × energy_usable.
battery_box_cell_voltage_minTensioneVTensione di cella più bassa nel box, come riportata dal BMS.
battery_box_cell_voltage_maxTensioneVTensione di cella più alta nel box.
battery_box_cell_temperature_minTemperatura°CTemperatura di cella più bassa nel box.
battery_box_cell_temperature_maxTemperatura°CTemperatura di cella più alta nel box.
battery_box_power_limit_chargeLimiteWCiò che il BMS consente attualmente al box di assorbire. Grandezza positiva; un box limitato è sotto il valore nominale.
battery_box_power_limit_dischargeLimiteWCiò che il BMS consente attualmente al box di erogare.
battery_box_power_auxiliaryPotenzaWCiò che i sistemi propri del box assorbono per funzionare (climatizzazione, elettronica, pompe). Consumo positivo, mai incluso nelle corsie di carica/scarica.
battery_box_energy_auxiliary_totalEnergiaWhContatore cumulativo del consumo ausiliario.
battery_box_vendor_statusStatocodeLa parola di stato del container nel vocabolario del produttore (etichetta battery_vendor). Un buco significa "non letto"; mai sommare o mediare.

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.

Nome metricaTipoUnità
battery_storage_voltage_acTensioneV
battery_storage_current_acCorrenteA
battery_storage_frequencyFrequenzaHz
battery_storage_power_acPotenzaW
battery_storage_power_ac_inPotenzaW
battery_storage_power_ac_outPotenzaW
battery_storage_power_ac_reactivePotenza reattivaVAr
battery_storage_energy_ac_in_totalEnergiaWh
battery_storage_energy_ac_out_totalEnergiaWh
Interfaccia lato DC
Nome metricaTipoUnità
battery_storage_voltage_dcTensioneV
battery_storage_voltage_dc_inTensioneV
battery_storage_voltage_dc_outTensioneV
battery_storage_current_dcCorrenteA
battery_storage_current_dc_inCorrenteA
battery_storage_current_dc_outCorrenteA
battery_storage_power_dcPotenzaW
battery_storage_power_dc_inPotenzaW
battery_storage_power_dc_outPotenzaW
battery_storage_energy_dc_in_totalEnergiaWh
battery_storage_energy_dc_out_totalEnergiaWh
Chimica e stato
Nome metricaTipoUnitàDescrizione
battery_storage_cell_voltageTensione (somma)VSomma di tutte le tensioni di cella nella stringa in serie dello storage.
battery_storage_socStato di carica%Stato di carica di questo storage (0–100).
battery_storage_sohStato di salute%Stato di salute di questo storage (0–100).
battery_storage_temperatureTemperatura°CTemperatura rappresentativa a livello di storage.
battery_storage_energy_nominalEnergiaWhEnergia nominale installata in cella di questo storage (inizio vita).
battery_storage_energy_usableEnergiaWhEnergia utilizzabile massima — la capacità statica consentita dal BMS a cui corrisponde SoC = 100 % (tipicamente 85–95 % di _nominal).
battery_storage_energy_chargedEnergiaWhEnergia attualmente immagazzinata, derivata da soc / 100 × energy_usable.
battery_storage_comm_qualityQualità%Qualità del collegamento di comunicazione a livello di storage (0–100).
battery_storage_power_limit_chargeLimiteWLimite di carica per storage attualmente consentito dal BMS. Grandezza positiva.
battery_storage_power_limit_dischargeLimiteWLimite di scarica per storage attualmente consentito dal BMS.
battery_storage_cycle_countConteggio-Equivalenti di cicli completi come contati dal BMS dalla messa in servizio.
battery_storage_vendor_statusStatocodeLo stato operativo del rack nel vocabolario del produttore (etichetta battery_vendor). Mai sommare o mediare.

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
Nome metricaTipoUnità
battery_module_voltage_dcTensioneV
battery_module_voltage_dc_inTensioneV
battery_module_voltage_dc_outTensioneV
battery_module_current_dcCorrenteA
battery_module_current_dc_inCorrenteA
battery_module_current_dc_outCorrenteA
battery_module_power_dcPotenzaW
battery_module_power_dc_inPotenzaW
battery_module_power_dc_outPotenzaW
battery_module_energy_dc_in_totalEnergiaWh
battery_module_energy_dc_out_totalEnergiaWh
Chimica e stato
Nome metricaTipoUnitàDescrizione
battery_module_cell_voltageTensione (somma)VSomma delle tensioni di cella nella stringa in serie di questo modulo.
battery_module_socStato di carica%Stato di carica del modulo (0–100).
battery_module_sohStato di salute%Stato di salute del modulo (0–100).
battery_module_temperatureTemperatura°CTemperatura rappresentativa del modulo.
battery_module_energy_nominalEnergiaWhEnergia massima immagazzinabile di questo modulo.
battery_module_energy_usableEnergiaWhEnergia utilizzabile massima — la capacità statica consentita dal BMS a cui corrisponde SoC = 100 %.
battery_module_energy_chargedEnergiaWhEnergia attualmente immagazzinata, derivata da soc / 100 × energy_usable.
battery_module_comm_qualityQualità%Qualità delle comunicazioni BMS tra questo modulo e il suo controller di storage (0–100).

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.

Nome metricaTipoUnità
battery_cell_voltageTensioneV
battery_cell_temperatureTemperatura°C
battery_cell_socStato di carica%
battery_cell_sohStato di salute%

Metriche di previsione meteo

Metriche meteo giornaliere

Nome metricaTipoUnità
weather_forecast_daily_shortwave_radiation_sumRadiazioneWh/m²
weather_forecast_daily_precipitation_sumPrecipitazionemm
weather_forecast_daily_rain_sumPioggiamm
weather_forecast_daily_showers_sumRovescimm
weather_forecast_daily_snowfall_sumNevicatacm
weather_forecast_daily_precipitation_hoursDuratah
weather_forecast_daily_weather_codeCodice-
weather_forecast_daily_temperature_2m_maxTemperatura°C
weather_forecast_daily_wind_speed_10m_maxVelocità del ventom/s
weather_forecast_daily_wind_gusts_10m_maxRaffiche di ventom/s
weather_forecast_daily_wind_direction_10m_dominantDirezione del vento°

Metriche meteo a 15 minuti

Nome metricaTipoUnità
weather_forecast_minutely_15_terrestrial_radiationRadiazioneW/m²
weather_forecast_minutely_15_shortwave_radiationRadiazioneW/m²
weather_forecast_minutely_15_diffuse_radiationRadiazioneW/m²
weather_forecast_minutely_15_direct_normal_irradianceIrraggiamentoW/m²
weather_forecast_minutely_15_lightning_potentialPotenziale-
weather_forecast_minutely_15_precipitationPrecipitazionemm
weather_forecast_minutely_15_snowfallNevicatacm
weather_forecast_minutely_15_rainPioggiamm
weather_forecast_minutely_15_weather_codeCodice-
weather_forecast_minutely_15_relative_humidity_2mUmidità%
weather_forecast_minutely_15_dew_point_2mTemperatura°C
weather_forecast_minutely_15_apparent_temperatureTemperatura°C
weather_forecast_minutely_15_cloud_coverCopertura nuvolosa%
weather_forecast_minutely_15_temperature_2mTemperatura°C
weather_forecast_minutely_15_temperature_80mTemperatura°C
weather_forecast_minutely_15_temperature_120mTemperatura°C
weather_forecast_minutely_15_temperature_180mTemperatura°C
weather_forecast_minutely_15_wind_speed_10mVelocità del ventom/s
weather_forecast_minutely_15_wind_speed_80mVelocità del ventom/s
weather_forecast_minutely_15_wind_speed_120mVelocità del ventom/s
weather_forecast_minutely_15_wind_speed_180mVelocità del ventom/s
weather_forecast_minutely_15_wind_direction_10mDirezione del vento°
weather_forecast_minutely_15_wind_direction_80mDirezione del vento°
weather_forecast_minutely_15_wind_direction_120mDirezione del vento°
weather_forecast_minutely_15_wind_direction_180mDirezione del vento°
weather_forecast_minutely_15_wind_gusts_10mRaffiche di ventom/s
weather_forecast_minutely_15_snow_depthSpessore nevem
weather_forecast_minutely_15_visibilityVisibilitàm

Metriche di calcolo meteo

Nome metricaTipoUnità
weather_forecast_minutely_15_gtiIrraggiamentoW/m²
weather_forecast_minutely_15_gti_directIrraggiamentoW/m²
weather_forecast_minutely_15_gti_clearskyIrraggiamentoW/m²
weather_forecast_minutely_15_ghi_directIrraggiamentoW/m²
weather_forecast_minutely_15_ghi_direct_clearskyIrraggiamentoW/m²
weather_forecast_minutely_15_gti_direct_clearskyIrraggiamentoW/m²
weather_forecast_minutely_15_gti_energyEnergiaWh

Metriche del modello meteo

Metriche di potenza del modello meteo

Nome metricaTipoUnità
powerplant_power_model_dcPotenzaW
powerplant_energy_model_dc_totalEnergiaWh
powerplant_power_model_acPotenzaW
powerplant_energy_model_ac_totalEnergiaWh
powerplant_power_model_gridPotenzaW
powerplant_energy_model_grid_totalEnergiaWh
powerplant_energy_model_grid_in_totalEnergiaWh
powerplant_energy_model_grid_out_totalEnergiaWh

Metriche di potenza del modello clearsky

Nome metricaTipoUnità
powerplant_power_clearsky_dcPotenzaW
powerplant_energy_clearsky_dc_totalEnergiaWh
powerplant_power_clearsky_acPotenzaW
powerplant_energy_clearsky_ac_totalEnergiaWh
powerplant_power_clearsky_gridPotenzaW
powerplant_energy_clearsky_grid_totalEnergiaWh
powerplant_energy_clearsky_grid_in_totalEnergiaWh
powerplant_energy_clearsky_grid_out_totalEnergiaWh

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.

Nome della metricaTipoUnitàDescrizione
alarm_door_openStato0/1La centrale segnala cancello o porta come aperti. Solo serie — mai un evento.
alarm_triggeredStato0/1La centrale ha fatto scattare un allarme.
alarm_faultStato0/1La centrale segnala un proprio guasto.
alarm_cabinet_ups_alarmStato0/1L'UPS dell'armadio di comunicazione segnala un difetto.
alarm_cabinet_ups_on_batteryStato0/1Rete persa — l'UPS sostiene l'armadio.
alarm_cabinet_heating_breaker_trippedStato0/1L'interruttore magnetotermico del riscaldamento dell'armadio è intervenuto.
alarm_cabinet_main_switch_offStato0/1L'interruttore generale dell'armadio è spento.

Metriche di rete

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

Nome metricaTipoUnità
network_ping_latency_msLatenzams
network_ping_packet_loss_percentPerdita di pacchetti%
network_ping_successSuccessobool
network_connection_statusStato-

Metriche di monitoraggio della rete

I controlli attivi dell'agente (ICMP, TCP, HTTP) sui dispositivi della rete dell'impianto. Le serie per dispositivo portano device_ip, device_name, device_type e device_vendor; i controlli TCP aggiungono la porta, quelli HTTP l'endpoint. netmon_park_network_up è una serie di riepilogo per impianto.

Nome metricaTipoUnità
netmon_park_network_upStatobool
netmon_device_upStatobool
netmon_device_ping_latency_msLatenzams
netmon_device_ping_packet_loss_percentPerdita di pacchetti%
netmon_tcp_port_openStatobool
netmon_tcp_port_response_msTempo di rispostams
netmon_http_status_codeStato HTTPcode
netmon_http_response_msTempo di rispostams
netmon_http_upStatobool
netmon_discovered_devices_totalConteggio-
netmon_snmp_devices_totalConteggio-
netmon_discovery_duration_secondsDuratas

Metriche SNMP

Lette dai dispositivi SNMP della rete dell'impianto (switch, router, gateway). Le serie per dispositivo portano le stesse etichette di cui sopra; le serie per interfaccia aggiungono if_index, if_name e if_type.

Nome metricaTipoUnità
snmp_device_uptime_secondsDuratas
snmp_device_availableDisponibilitàbool
snmp_device_cpu_usage_percentUtilizzo%
snmp_device_memory_usage_percentUtilizzo%
snmp_device_memory_used_bytesMemoriabytes
snmp_device_memory_total_bytesMemoriabytes
snmp_device_temperature_celsiusTemperatura°C
snmp_interface_statusStatocode
snmp_interface_admin_statusStatocode
snmp_interface_speed_bpsVelocitàbit/s
snmp_interface_in_bytes_totalTrafficobytes
snmp_interface_out_bytes_totalTrafficobytes
snmp_interface_in_errors_totalErrori-
snmp_interface_out_errors_totalErrori-
snmp_interface_in_discards_totalScarti-
snmp_interface_out_discards_totalScarti-

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.

Nome metricaTipoUnitàLabel
scraper_health_stateStatocodicesource, source_num, name
scraper_cycles_totalCounter-source, source_num, name
scraper_errors_totalCounter-source, source_num, name
scraper_last_success_timestampTimestampssource, source_num, name
  • 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

Nome metricaTipoUnità
agent_network_rx_bytesCounterbyte
agent_network_tx_bytesCounterbyte

Salute dell'agente

Nome metricaTipoUnità
agent_healthStatobool
agent_uptime_secondsDuratas
agent_boottimeTimestamps

VPN dell'organizzazione

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

Nome metricaTipoUnità
agent_organization_vpn_connectedStatobool
agent_organization_vpn_rx_bytesCounterbyte
agent_organization_vpn_tx_bytesCounterbyte

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.

Nome metricaTipoUnità
agent_direct_vpn_connectedStatobool
agent_direct_vpn_rx_bytesCounterbyte
agent_direct_vpn_tx_bytesCounterbyte

VPN SaaS

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

Nome metricaTipoUnità
agent_saas_vpn_connectedStatobool
agent_saas_vpn_rx_bytesCounterbyte
agent_saas_vpn_tx_bytesCounterbyte

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.

Nome metricaTipoUnità
agent_vpn_server_runningStatobool
agent_vpn_server_peer_connectedStatobool
agent_vpn_server_peer_rx_bytesCounterbyte
agent_vpn_server_peer_tx_bytesCounterbyte
agent_vpn_server_peer_last_handshakeTimestamps
  • 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

Nome metricaTipoUnitàLabel
operator_vpn_connectedStatoboolvpn_service, organization, cluster, region
operator_vpn_rx_bytesTrafficobytevpn_service, organization, cluster, region
operator_vpn_tx_bytesTrafficobytevpn_service, organization, cluster, region
  • 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

Nome metricaTipoUnitàLabel
operator_healthStatobooloperator, cluster, region
operator_uptime_secondsDuratasoperator, cluster, region
operator_cloud_response_age_secondsDuratasoperator, cluster, region
operator_cloud_liveness_age_secondsDuratasoperator, cluster, region
  • 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
  • operator_cloud_liveness_age_seconds: Secondi dall'ultima conferma che il processo cloud è vivo (endpoint di salute) — resta aggiornato anche mentre l'API principale restituisce errori, quindi è il criterio di sicurezza

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
© 2026 Mirox Verwaltungs GmbH. Tutti i diritti riservati. | Informativa sulla privacy