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 376 nomi standardizzati di metriche distribuiti su undici famiglie: produzione dell'impianto (powerplant), accumulo a batteria, 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 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) e nel meteo (previsione e modellato).
Metriche dell'impianto
Metriche di rete elettrica
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_energy_grid_total | Energia | Wh |
| powerplant_energy_grid_out_total | Energia | Wh |
| powerplant_grid_energy_total_reactive | Energia | VArh |
| powerplant_grid_energy_total_apparent | Energia | VAh |
| powerplant_power_grid | Potenza | W |
| powerplant_grid_power_reactive | Potenza | VAr |
| powerplant_grid_power_apparent | Potenza | VA |
Nota sulla convenzione di denominazione
Le metriche powerplant_energy_grid_* e powerplant_power_grid non seguono lo schema di denominazione standard (powerplant_grid_energy_* e powerplant_grid_power) per motivi legacy. Le altre metriche di rete seguono lo schema standard powerplant_grid_*. Questi nomi di metriche legacy saranno aggiornati per seguire lo schema standard in una versione futura.
Metriche dell'inverter
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_inverter_energy_ac_total | Energia | Wh |
| powerplant_inverter_energy_dc_total | Energia | Wh |
| powerplant_inverter_energy_consumed_total | Energia | Wh |
| powerplant_inverter_power_ac | Potenza | W |
| powerplant_inverter_power_dc | Potenza | W |
| powerplant_inverter_power_reactive | Potenza | VAr |
| powerplant_inverter_power_max | Potenza | W |
| powerplant_inverter_setpoint_power_active | Setpoint | W |
| powerplant_inverter_setpoint_power_active_percent | Setpoint | % |
| powerplant_inverter_setpoint_power_reactive | Setpoint | VAr |
| powerplant_inverter_max_power | Shutdown | % |
| powerplant_inverter_voltage_ac | Tensione | V |
| powerplant_inverter_current_ac | Corrente | A |
| powerplant_inverter_voltage_dc | Tensione | V |
| powerplant_inverter_current_dc | Corrente | A |
| powerplant_inverter_resistance_iso | Resistenza | Ohm |
| powerplant_inverter_cos | Fattore di potenza | - |
| powerplant_inverter_frequency | Frequenza | Hz |
| powerplant_inverter_temperature | Temperatura | °C |
| powerplant_inverter_current_ac_phase | Corrente | A |
| powerplant_inverter_voltage_ac__phase__L1_L2 | Tensione | V |
| powerplant_inverter_voltage_ac__phase__L2_L3 | Tensione | V |
| powerplant_inverter_voltage_ac__phase__L3_L1 | Tensione | V |
| powerplant_inverter_current_ac__phase__L1 | Corrente | A |
| powerplant_inverter_current_ac__phase__L2 | Corrente | A |
| powerplant_inverter_current_ac__phase__L3 | Corrente | A |
Metriche della cassetta di giunzione (GAK)
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_gak_voltage | Tensione | V |
| powerplant_gak_current | Corrente | A |
| powerplant_gak_power | Potenza | W |
| powerplant_gak_energy_total | Energia | Wh |
| powerplant_gak_temperature | Temperatura | °C |
Metriche delle stringhe
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_string_voltage | Tensione | V |
| powerplant_string_current | Corrente | A |
| powerplant_string_power | Potenza | W |
| powerplant_string_energy_total | Energia | Wh |
Metriche di controllo
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_max_power_by_grid | Shutdown | % |
| powerplant_max_power_by_external | Shutdown | % |
| powerplant_max_power_by_local | Shutdown | % |
| powerplant_control_connection_grid | Controllo | bool |
| powerplant_control_connection_external | Controllo | bool |
| powerplant_control_interface_ready | Controllo | bool |
| powerplant_power_max | Potenza | W |
| powerplant_max_power_source | Controllo | - |
Metriche di irraggiamento
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_solar_radiation | Irraggiamento | W/m² |
| powerplant_energy_irradiation_total | Energia | Wh |
| powerplant_solar_ghi_reference | Irraggiamento | W/m² |
| powerplant_solar_ghi_reference_energy | Energia | Wh |
Metriche ambientali
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_humidity | Umidità | % |
| powerplant_ambient_temperature | Temperatura | °C |
| powerplant_module_temperature | Temperatura | °C |
| powerplant_wind_speed | Velocità del vento | m/s |
| powerplant_wind_direction | Direzione del vento | ° |
Metriche di perdita
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_energy_loss_total | Energia | Wh |
| powerplant_power_loss | Potenza | W |
Metriche di report
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_power_report | Potenza | W |
| powerplant_energy_report_total | Energia | Wh |
| powerplant_energy_radiation_total | Energia | Wh |
Metriche del Digital Twin
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_grid_power_simulation | Potenza | W |
| powerplant_grid_energy_total_simulation | Energia | Wh |
| powerplant_grid_prrc | PRRC | - |
| powerplant_grid_sim_err | Errore | - |
| powerplant_inverter_power_ac_simulation | Potenza | W |
| powerplant_inverter_energy_ac_total_simulation | Energia | Wh |
| powerplant_inverter_prrc | PRRC | - |
| powerplant_inverter_sim_err | Errore | - |
| powerplant_gak_power_simulation | Potenza | W |
| powerplant_gak_energy_total_simulation | Energia | Wh |
| powerplant_gak_prrc | PRRC | - |
| powerplant_gak_sim_err | Errore | - |
| powerplant_string_power_simulation | Potenza | W |
| powerplant_string_energy_total_simulation | Energia | Wh |
| powerplant_string_shadow_factor | Fattore | - |
| powerplant_string_prrc | PRRC | - |
| powerplant_string_sim_err | Errore | - |
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_box_* un box / container BESS — vertice del lato batteria
└── 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
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 metrica | Tipo | Unità |
|---|---|---|
| battery_environment_temperature | Temperatura | °C |
| battery_environment_humidity | Umidità | % |
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 metrica | Tipo | Unità |
|---|---|---|
| battery_box_voltage_ac | Tensione | V |
| battery_box_voltage_ac__phase__L1_L2 | Tensione | V |
| battery_box_voltage_ac__phase__L2_L3 | Tensione | V |
| battery_box_voltage_ac__phase__L3_L1 | Tensione | V |
| battery_box_current_ac | Corrente | A |
| battery_box_current_ac__phase__L1 | Corrente | A |
| battery_box_current_ac__phase__L2 | Corrente | A |
| battery_box_current_ac__phase__L3 | Corrente | A |
| battery_box_frequency | Frequenza | Hz |
| battery_box_power_ac | Potenza | W |
| battery_box_power_ac_in | Potenza | W |
| battery_box_power_ac_out | Potenza | W |
| battery_box_power_ac_reactive | Potenza reattiva | VAr |
| battery_box_power_ac_setpoint | Setpoint | W |
| battery_box_power_ac_setpoint_reactive | Setpoint | VAr |
| battery_box_energy_ac_in_total | Energia | Wh |
| battery_box_energy_ac_out_total | Energia | Wh |
Interfaccia lato DC
| Nome metrica | Tipo | Unità |
|---|---|---|
| battery_box_voltage_dc | Tensione | V |
| battery_box_voltage_dc_in | Tensione | V |
| battery_box_voltage_dc_out | Tensione | V |
| battery_box_current_dc | Corrente | A |
| battery_box_current_dc_in | Corrente | A |
| battery_box_current_dc_out | Corrente | A |
| battery_box_power_dc | Potenza | W |
| battery_box_power_dc_in | Potenza | W |
| battery_box_power_dc_out | Potenza | W |
| battery_box_energy_dc_in_total | Energia | Wh |
| battery_box_energy_dc_out_total | Energia | Wh |
Chimica e stato
| Nome metrica | Tipo | Unità | Descrizione |
|---|---|---|---|
| battery_box_cell_voltage | Tensione (somma) | V | Somma delle tensioni di cella sul bus DC del box. |
| battery_box_soc | Stato di carica | % | Stato di carica dell'intero box (0–100). |
| battery_box_soh | Stato di salute | % | Stato di salute dell'intero box (0–100). |
| battery_box_temperature | Temperatura | °C | Temperatura rappresentativa a livello di box. |
| battery_box_energy_nominal | Energia | Wh | Energia nominale installata in cella a inizio vita. Si riduce nel tempo con il SoH. |
| battery_box_energy_usable | Energia | Wh | Energia utilizzabile massima — la capacità statica consentita dal BMS a cui corrisponde SoC = 100 % (tipicamente 85–95 % di _nominal). |
| battery_box_energy_charged | Energia | Wh | Energia attualmente immagazzinata nel box, derivata da soc / 100 × energy_usable. |
Livello storage
Un cabinet / rack all'interno di un box. Label obbligatorie: box, storage. Le metriche AC sono rare a questo livello.
Interfaccia lato DC
| Nome metrica | Tipo | Unità |
|---|---|---|
| battery_storage_voltage_dc | Tensione | V |
| battery_storage_voltage_dc_in | Tensione | V |
| battery_storage_voltage_dc_out | Tensione | V |
| battery_storage_current_dc | Corrente | A |
| battery_storage_current_dc_in | Corrente | A |
| battery_storage_current_dc_out | Corrente | A |
| battery_storage_power_dc | Potenza | W |
| battery_storage_power_dc_in | Potenza | W |
| battery_storage_power_dc_out | Potenza | W |
| battery_storage_energy_dc_in_total | Energia | Wh |
| battery_storage_energy_dc_out_total | Energia | Wh |
Chimica e stato
| Nome metrica | Tipo | Unità | Descrizione |
|---|---|---|---|
| battery_storage_cell_voltage | Tensione (somma) | V | Somma di tutte le tensioni di cella nella stringa in serie dello storage. |
| battery_storage_soc | Stato di carica | % | Stato di carica di questo storage (0–100). |
| battery_storage_soh | Stato di salute | % | Stato di salute di questo storage (0–100). |
| battery_storage_temperature | Temperatura | °C | Temperatura rappresentativa a livello di storage. |
| battery_storage_energy_nominal | Energia | Wh | Energia nominale installata in cella di questo storage (inizio vita). |
| battery_storage_energy_usable | Energia | Wh | Energia utilizzabile massima — la capacità statica consentita dal BMS a cui corrisponde SoC = 100 % (tipicamente 85–95 % di _nominal). |
| battery_storage_energy_charged | Energia | Wh | Energia attualmente immagazzinata, derivata da soc / 100 × energy_usable. |
| battery_storage_comm_quality | Qualità | % | Qualità del collegamento di comunicazione a livello di storage (0–100). |
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 metrica | Tipo | Unità |
|---|---|---|
| battery_module_voltage_dc | Tensione | V |
| battery_module_voltage_dc_in | Tensione | V |
| battery_module_voltage_dc_out | Tensione | V |
| battery_module_current_dc | Corrente | A |
| battery_module_current_dc_in | Corrente | A |
| battery_module_current_dc_out | Corrente | A |
| battery_module_power_dc | Potenza | W |
| battery_module_power_dc_in | Potenza | W |
| battery_module_power_dc_out | Potenza | W |
| battery_module_energy_dc_in_total | Energia | Wh |
| battery_module_energy_dc_out_total | Energia | Wh |
Chimica e stato
| Nome metrica | Tipo | Unità | Descrizione |
|---|---|---|---|
| battery_module_cell_voltage | Tensione (somma) | V | Somma delle tensioni di cella nella stringa in serie di questo modulo. |
| battery_module_soc | Stato di carica | % | Stato di carica del modulo (0–100). |
| battery_module_soh | Stato di salute | % | Stato di salute del modulo (0–100). |
| battery_module_temperature | Temperatura | °C | Temperatura rappresentativa del modulo. |
| battery_module_energy_nominal | Energia | Wh | Energia massima immagazzinabile di questo modulo. |
| battery_module_energy_usable | Energia | Wh | Energia utilizzabile massima — la capacità statica consentita dal BMS a cui corrisponde SoC = 100 %. |
| battery_module_energy_charged | Energia | Wh | Energia attualmente immagazzinata, derivata da soc / 100 × energy_usable. |
| battery_module_comm_quality | Qualità | % | 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 metrica | Tipo | Unità |
|---|---|---|
| battery_cell_voltage | Tensione | V |
| battery_cell_temperature | Temperatura | °C |
Metriche di previsione meteo
Metriche meteo giornaliere
| Nome metrica | Tipo | Unità |
|---|---|---|
| weather_forecast_daily_shortwave_radiation_sum | Radiazione | Wh/m² |
| weather_forecast_daily_precipitation_sum | Precipitazione | mm |
| weather_forecast_daily_rain_sum | Pioggia | mm |
| weather_forecast_daily_showers_sum | Rovesci | mm |
| weather_forecast_daily_snowfall_sum | Nevicata | cm |
| weather_forecast_daily_precipitation_hours | Durata | h |
| weather_forecast_daily_weather_code | Codice | - |
| weather_forecast_daily_temperature_2m_max | Temperatura | °C |
| weather_forecast_daily_wind_speed_10m_max | Velocità del vento | m/s |
| weather_forecast_daily_wind_gusts_10m_max | Raffiche di vento | m/s |
| weather_forecast_daily_wind_direction_10m_dominant | Direzione del vento | ° |
Metriche meteo a 15 minuti
| Nome metrica | Tipo | Unità |
|---|---|---|
| weather_forecast_minutely_15_terrestrial_radiation | Radiazione | W/m² |
| weather_forecast_minutely_15_shortwave_radiation | Radiazione | W/m² |
| weather_forecast_minutely_15_diffuse_radiation | Radiazione | W/m² |
| weather_forecast_minutely_15_direct_normal_irradiance | Irraggiamento | W/m² |
| weather_forecast_minutely_15_lightning_potential | Potenziale | - |
| weather_forecast_minutely_15_precipitation | Precipitazione | mm |
| weather_forecast_minutely_15_snowfall | Nevicata | cm |
| weather_forecast_minutely_15_rain | Pioggia | mm |
| weather_forecast_minutely_15_weather_code | Codice | - |
| weather_forecast_minutely_15_relative_humidity_2m | Umidità | % |
| weather_forecast_minutely_15_dew_point_2m | Temperatura | °C |
| weather_forecast_minutely_15_apparent_temperature | Temperatura | °C |
| weather_forecast_minutely_15_cloud_cover | Copertura nuvolosa | % |
| weather_forecast_minutely_15_temperature_2m | Temperatura | °C |
| weather_forecast_minutely_15_temperature_80m | Temperatura | °C |
| weather_forecast_minutely_15_temperature_120m | Temperatura | °C |
| weather_forecast_minutely_15_temperature_180m | Temperatura | °C |
| weather_forecast_minutely_15_wind_speed_10m | Velocità del vento | m/s |
| weather_forecast_minutely_15_wind_speed_80m | Velocità del vento | m/s |
| weather_forecast_minutely_15_wind_speed_120m | Velocità del vento | m/s |
| weather_forecast_minutely_15_wind_speed_180m | Velocità del vento | m/s |
| weather_forecast_minutely_15_wind_direction_10m | Direzione del vento | ° |
| weather_forecast_minutely_15_wind_direction_80m | Direzione del vento | ° |
| weather_forecast_minutely_15_wind_direction_120m | Direzione del vento | ° |
| weather_forecast_minutely_15_wind_direction_180m | Direzione del vento | ° |
| weather_forecast_minutely_15_wind_gusts_10m | Raffiche di vento | m/s |
| weather_forecast_minutely_15_snow_depth | Spessore neve | m |
| weather_forecast_minutely_15_visibility | Visibilità | m |
Metriche di calcolo meteo
| Nome metrica | Tipo | Unità |
|---|---|---|
| weather_forecast_minutely_15_gti | Irraggiamento | W/m² |
| weather_forecast_minutely_15_gti_direct | Irraggiamento | W/m² |
| weather_forecast_minutely_15_gti_clearsky | Irraggiamento | W/m² |
| weather_forecast_minutely_15_ghi_direct | Irraggiamento | W/m² |
| weather_forecast_minutely_15_ghi_direct_clearsky | Irraggiamento | W/m² |
| weather_forecast_minutely_15_gti_direct_clearsky | Irraggiamento | W/m² |
| weather_forecast_minutely_15_gti_energy | Energia | Wh |
Metriche del modello meteo
Metriche di potenza del modello meteo
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_power_model_dc | Potenza | W |
| powerplant_energy_model_dc_total | Energia | Wh |
| powerplant_power_model_ac | Potenza | W |
| powerplant_energy_model_ac_total | Energia | Wh |
| powerplant_power_model_grid | Potenza | W |
| powerplant_energy_model_grid_total | Energia | Wh |
| powerplant_energy_model_grid_in_total | Energia | Wh |
| powerplant_energy_model_grid_out_total | Energia | Wh |
Metriche di potenza del modello clearsky
| Nome metrica | Tipo | Unità |
|---|---|---|
| powerplant_power_clearsky_dc | Potenza | W |
| powerplant_energy_clearsky_dc_total | Energia | Wh |
| powerplant_power_clearsky_ac | Potenza | W |
| powerplant_energy_clearsky_ac_total | Energia | Wh |
| powerplant_power_clearsky_grid | Potenza | W |
| powerplant_energy_clearsky_grid_total | Energia | Wh |
| powerplant_energy_clearsky_grid_in_total | Energia | Wh |
| powerplant_energy_clearsky_grid_out_total | Energia | Wh |
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 metrica | Tipo | Unità |
|---|---|---|
| network_ping_latency_ms | Latenza | ms |
| network_ping_packet_loss_percent | Perdita di pacchetti | % |
| network_ping_success | Successo | bool |
| network_connection_status | Stato | - |
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 metrica | Tipo | Unità | Label |
|---|---|---|---|
| scraper_health_state | Stato | codice | source, source_num, name |
| scraper_cycles_total | Counter | - | source, source_num, name |
| scraper_errors_total | Counter | - | source, source_num, name |
| scraper_last_success_timestamp | Timestamp | s | source, 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 metrica | Tipo | Unità |
|---|---|---|
| agent_network_rx_bytes | Counter | byte |
| agent_network_tx_bytes | Counter | byte |
Salute dell'agente
| Nome metrica | Tipo | Unità |
|---|---|---|
| agent_health | Stato | bool |
| agent_uptime_seconds | Durata | s |
| agent_boottime | Timestamp | s |
VPN dell'organizzazione
Connettività e traffico per il collegamento VPN a livello di organizzazione tra l'impianto e il cloud.
| Nome metrica | Tipo | Unità |
|---|---|---|
| agent_organization_vpn_connected | Stato | bool |
| agent_organization_vpn_rx_bytes | Counter | byte |
| agent_organization_vpn_tx_bytes | Counter | byte |
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 metrica | Tipo | Unità |
|---|---|---|
| agent_direct_vpn_connected | Stato | bool |
| agent_direct_vpn_rx_bytes | Counter | byte |
| agent_direct_vpn_tx_bytes | Counter | byte |
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 metrica | Tipo | Unità | Label |
|---|---|---|---|
| operator_vpn_connected | Stato | bool | vpn_service, organization, cluster, region |
| operator_vpn_rx_bytes | Traffico | byte | vpn_service, organization, cluster, region |
| operator_vpn_tx_bytes | Traffico | byte | vpn_service, organization, cluster, region |
- operator_vpn_connected:
1se il tunnel VPN ha un handshake recente (negli ultimi 3 minuti),0altrimenti - 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 metrica | Tipo | Unità | Label |
|---|---|---|---|
| operator_health | Stato | bool | operator, cluster, region |
| operator_uptime_seconds | Durata | s | operator, cluster, region |
| operator_cloud_response_age_seconds | Durata | s | operator, cluster, region |
- operator_health:
1se l'operatore ha una connessione cloud attiva,0se 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:
- Discovery: Il sistema identifica tutti i componenti da monitorare in base alla configurazione del parco
- Pianificazione: Le pianificazioni di raccolta sono ottimizzate in base all'importanza e alla variabilità delle metriche
- Recupero: Il data scraper si connette ai dispositivi e raccoglie le misurazioni grezze
- Validazione: I dati raccolti sono validati per accuratezza e conformità ai range
- Arricchimento: Vengono aggiunte informazioni contestuali (timestamp, identificatori dei componenti, ecc.)
- Trasmissione: I dati sono trasmessi in modo sicuro al database time-series
- 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