Collecte de métriques
Mirox rassemble les données de performance de vos centrales d'énergie renouvelable en un vocabulaire de métriques unique et standardisé — le socle de chaque capacité de supervision, d'analyse, de reporting et de prévision de la plateforme. Cette page constitue le catalogue de référence de ce qui est mesuré et de la façon dont les mesures sont organisées.
La taxonomie complète couvre 376 noms de métriques standardisés répartis en onze familles : production de la centrale (powerplant), stockage par batterie, entrées météo, modèles dérivés de la météo, ainsi que plusieurs familles opérationnelles qui décrivent la collecte elle-même — supervision réseau, agents, flotte d'opérateurs, accessibilité réseau de base et sources du scraper. Les tableaux ci-dessous documentent les familles que vous représenterez le plus souvent en graphiques ; les familles opérationnelles sont résumées dans les sections Métriques réseau et Métriques d'agent.
Architecture du Data Scraper
Au cœur de la collecte de métriques se trouve le Data Scraper, le composant edge qui collecte les données de séries temporelles de vos centrales. Plutôt qu'un moteur de protocole générique unique, il utilise un adaptateur dédié par famille d'équipements (data loggers, onduleurs, compteurs, systèmes de batteries), chacun conçu pour l'interface de ce fabricant. Le Data Scraper peut fonctionner selon deux modes de déploiement :
Collecte dans le cloud
Lorsqu'il est déployé dans le cloud :
- Se connecte aux parcs solaires via des connexions Internet sécurisées
- Agrège les données de plusieurs sites de manière centralisée
- Gère la gestion des connexions et la logique de nouvelle tentative
- Optimise l'utilisation de la bande passante grâce à un polling intelligent
Collecte en périphérie (edge)
Lorsqu'il est déployé en périphérie (sur site) :
- S'interface directement avec les équipements locaux pour une latence minimale
- Fonctionne avec une mise en mémoire tampon locale pour faire face aux coupures Internet
- Effectue une validation et un filtrage préliminaires des données
- Se synchronise avec le cloud lorsque la connectivité est disponible
L'architecture bimode garantit une collecte de données fiable quelles que soient les conditions de connectivité du site ou l'échelle du système.
Métriques collectées
Le système de collecte de métriques rassemble un ensemble complet de mesures qui offrent une visibilité totale sur la performance des centrales d'énergie renouvelable. Les métriques sont regroupées selon trois axes orthogonaux :
- Les métriques de site décrivent le site physique lui-même — sa centrale, son stockage par batterie et la météo qui l'entoure.
- Les métriques réseau décrivent la connectivité entre le site et le cloud.
- Les métriques d'agent décrivent les agents de collecte de données eux-mêmes — les sources du scraper et les services d'infrastructure de support exécutés sur l'appareil IoT.
Métriques de site
Les métriques de site sont les mesures brutes de séries temporelles collectées directement depuis les équipements installés sur un site d'énergie renouvelable. Elles sont partitionnées par domaine en la centrale (onduleurs PV, raccordement réseau, etc.), le système de stockage d'énergie par batterie (BESS) et la météo (prévision et modélisée).
Métriques de la centrale
Métriques réseau électrique
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_energy_grid_total | Energy | Wh |
| powerplant_energy_grid_out_total | Energy | Wh |
| powerplant_grid_energy_total_reactive | Energy | VArh |
| powerplant_grid_energy_total_apparent | Energy | VAh |
| powerplant_power_grid | Power | W |
| powerplant_grid_power_reactive | Power | VAr |
| powerplant_grid_power_apparent | Power | VA |
Note sur la convention de nommage
Les métriques powerplant_energy_grid_* et powerplant_power_grid ne suivent pas le schéma de nommage standard (powerplant_grid_energy_* et powerplant_grid_power) pour des raisons historiques. Les autres métriques réseau suivent le schéma standard powerplant_grid_*. Ces noms de métriques hérités seront mis à jour pour suivre le schéma standard dans une version future.
Métriques d'onduleur
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_inverter_energy_ac_total | Energy | Wh |
| powerplant_inverter_energy_dc_total | Energy | Wh |
| powerplant_inverter_energy_consumed_total | Energy | Wh |
| powerplant_inverter_power_ac | Power | W |
| powerplant_inverter_power_dc | Power | W |
| powerplant_inverter_power_reactive | Power | VAr |
| powerplant_inverter_power_max | Power | 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 | Voltage | V |
| powerplant_inverter_current_ac | Current | A |
| powerplant_inverter_voltage_dc | Voltage | V |
| powerplant_inverter_current_dc | Current | A |
| powerplant_inverter_resistance_iso | Resistance | Ohm |
| powerplant_inverter_cos | Power Factor | - |
| powerplant_inverter_frequency | Frequency | Hz |
| powerplant_inverter_temperature | Temperature | °C |
| powerplant_inverter_current_ac_phase | Current | A |
| powerplant_inverter_voltage_ac__phase__L1_L2 | Voltage | V |
| powerplant_inverter_voltage_ac__phase__L2_L3 | Voltage | V |
| powerplant_inverter_voltage_ac__phase__L3_L1 | Voltage | V |
| powerplant_inverter_current_ac__phase__L1 | Current | A |
| powerplant_inverter_current_ac__phase__L2 | Current | A |
| powerplant_inverter_current_ac__phase__L3 | Current | A |
Métriques de boîte de jonction (GAK)
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_gak_voltage | Voltage | V |
| powerplant_gak_current | Current | A |
| powerplant_gak_power | Power | W |
| powerplant_gak_energy_total | Energy | Wh |
| powerplant_gak_temperature | Temperature | °C |
Métriques de string
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_string_voltage | Voltage | V |
| powerplant_string_current | Current | A |
| powerplant_string_power | Power | W |
| powerplant_string_energy_total | Energy | Wh |
Métriques de contrôle
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_max_power_by_grid | Shutdown | % |
| powerplant_max_power_by_external | Shutdown | % |
| powerplant_max_power_by_local | Shutdown | % |
| powerplant_control_connection_grid | Control | bool |
| powerplant_control_connection_external | Control | bool |
| powerplant_control_interface_ready | Control | bool |
| powerplant_power_max | Power | W |
| powerplant_max_power_source | Control | - |
Métriques d'irradiance
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_solar_radiation | Irradiance | W/m² |
| powerplant_energy_irradiation_total | Energy | Wh |
| powerplant_solar_ghi_reference | Irradiance | W/m² |
| powerplant_solar_ghi_reference_energy | Energy | Wh |
Métriques environnementales
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_humidity | Humidity | % |
| powerplant_ambient_temperature | Temperature | °C |
| powerplant_module_temperature | Temperature | °C |
| powerplant_wind_speed | Wind Speed | m/s |
| powerplant_wind_direction | Wind Direction | ° |
Métriques de pertes
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_energy_loss_total | Energy | Wh |
| powerplant_power_loss | Power | W |
Métriques de rapport
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_power_report | Power | W |
| powerplant_energy_report_total | Energy | Wh |
| powerplant_energy_radiation_total | Energy | Wh |
Métriques du jumeau numérique
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_grid_power_simulation | Power | W |
| powerplant_grid_energy_total_simulation | Energy | Wh |
| powerplant_grid_prrc | PRRC | - |
| powerplant_grid_sim_err | Error | - |
| powerplant_inverter_power_ac_simulation | Power | W |
| powerplant_inverter_energy_ac_total_simulation | Energy | Wh |
| powerplant_inverter_prrc | PRRC | - |
| powerplant_inverter_sim_err | Error | - |
| powerplant_gak_power_simulation | Power | W |
| powerplant_gak_energy_total_simulation | Energy | Wh |
| powerplant_gak_prrc | PRRC | - |
| powerplant_gak_sim_err | Error | - |
| powerplant_string_power_simulation | Power | W |
| powerplant_string_energy_total_simulation | Energy | Wh |
| powerplant_string_shadow_factor | Factor | - |
| powerplant_string_prrc | PRRC | - |
| powerplant_string_sim_err | Error | - |
Métriques de batterie
La famille battery_* est le vocabulaire de métriques indépendant du fabricant pour tout système de stockage d'énergie par batterie (BESS). Elle suit une hiérarchie de composants stricte où l'identification de l'instance réside dans des labels, et non dans le nom de la métrique :
battery_environment_* capteurs ambiants autour du BESS
battery_box_* une box / un conteneur BESS — sommet du côté batterie
└── battery_storage_* une armoire / un rack à l'intérieur de la box
└── battery_module_* un module à l'intérieur de l'armoire
└── battery_cell_* une cellule individuelle à l'intérieur du module
Il s'agit d'une spécification de collecte uniquement — les adaptateurs publient les valeurs brutes exactement comme le fabricant les expose, sans agrégations, dérivations, modificateurs _min / _max / _mean, ni indicateurs d'état ou de santé. Toute interprétation, consolidation et gestion d'alarmes relèvent du jumeau numérique en aval.
Deux types distincts de « tension »
La spécification sépare délibérément deux grandeurs physiquement différentes qui se trouvent toutes deux exprimées en volts :
- Tension de cellule (
*_cell_voltage) — la tension chimique aux bornes produite par les cellules. Au niveau de la cellule, il s'agit de la tension d'une cellule unique (~3,2 V pour une cellule LFP). Aux niveaux supérieurs, il s'agit de la somme de toutes les tensions de cellules d'une même chaîne série. Elle ne varie qu'avec l'état de charge. - Tension d'interface (
*_voltage_dc,_dc_in,_dc_out) — ce qui est injecté dans la batterie ou prélevé à ses bornes électriques. Diffère de la tension de cellule par I·R lors de la charge / décharge.
Les deux représentent physiquement la même valeur lorsque la batterie est au repos ; elles divergent de la chute IR dès qu'un courant circule.
Variantes DC sensibles à la direction
Pour chaque grandeur DC (voltage_dc, current_dc, power_dc) aux niveaux box, storage et module, il existe trois variantes : *_dc (signée, registre unique du fabricant), *_dc_in (toujours positive — valeur pendant la charge) et *_dc_out (toujours positive — valeur pendant la décharge). Les adaptateurs publient la ou les variantes que le fabricant expose réellement.
Environnement
Capteurs ambiants autour du BESS — distingués par le label sensor.
| Nom de la métrique | Type | Unité |
|---|---|---|
| battery_environment_temperature | Temperature | °C |
| battery_environment_humidity | Humidity | % |
Niveau box
Le sommet du côté batterie — une box / un conteneur BESS. Label requis : box. Labels facultatifs : inverter, phase. Les métriques côté AC ne sont présentes que lorsque la conversion AC↔DC se situe physiquement au niveau de la box.
Flux d'énergie côté AC
| Nom de la métrique | Type | Unité |
|---|---|---|
| battery_box_voltage_ac | Voltage | V |
| battery_box_voltage_ac__phase__L1_L2 | Voltage | V |
| battery_box_voltage_ac__phase__L2_L3 | Voltage | V |
| battery_box_voltage_ac__phase__L3_L1 | Voltage | V |
| battery_box_current_ac | Current | A |
| battery_box_current_ac__phase__L1 | Current | A |
| battery_box_current_ac__phase__L2 | Current | A |
| battery_box_current_ac__phase__L3 | Current | A |
| battery_box_frequency | Frequency | Hz |
| battery_box_power_ac | Power | W |
| battery_box_power_ac_in | Power | W |
| battery_box_power_ac_out | Power | W |
| battery_box_power_ac_reactive | Reactive Power | VAr |
| battery_box_power_ac_setpoint | Setpoint | W |
| battery_box_power_ac_setpoint_reactive | Setpoint | VAr |
| battery_box_energy_ac_in_total | Energy | Wh |
| battery_box_energy_ac_out_total | Energy | Wh |
Interface côté DC
| Nom de la métrique | Type | Unité |
|---|---|---|
| battery_box_voltage_dc | Voltage | V |
| battery_box_voltage_dc_in | Voltage | V |
| battery_box_voltage_dc_out | Voltage | V |
| battery_box_current_dc | Current | A |
| battery_box_current_dc_in | Current | A |
| battery_box_current_dc_out | Current | A |
| battery_box_power_dc | Power | W |
| battery_box_power_dc_in | Power | W |
| battery_box_power_dc_out | Power | W |
| battery_box_energy_dc_in_total | Energy | Wh |
| battery_box_energy_dc_out_total | Energy | Wh |
Chimie et état
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| battery_box_cell_voltage | Voltage (sum) | V | Somme des tensions de cellules sur le bus DC de la box. |
| battery_box_soc | State of Charge | % | État de charge à l'échelle de la box (0–100). |
| battery_box_soh | State of Health | % | État de santé à l'échelle de la box (0–100). |
| battery_box_temperature | Temperature | °C | Température représentative au niveau de la box. |
| battery_box_energy_nominal | Energy | Wh | Énergie nominale installée des cellules en début de vie. Diminue avec le SoH. |
| battery_box_energy_usable | Energy | Wh | Énergie utilisable maximale — la capacité statique autorisée par le BMS à laquelle correspond un SoC = 100 % (typiquement 85–95 % de _nominal). |
| battery_box_energy_charged | Energy | Wh | Énergie actuellement stockée dans la box, dérivée de soc / 100 × energy_usable. |
Niveau storage
Une armoire / un rack à l'intérieur d'une box. Labels requis : box, storage. Les métriques AC sont rares à ce niveau.
Interface côté DC
| Nom de la métrique | Type | Unité |
|---|---|---|
| battery_storage_voltage_dc | Voltage | V |
| battery_storage_voltage_dc_in | Voltage | V |
| battery_storage_voltage_dc_out | Voltage | V |
| battery_storage_current_dc | Current | A |
| battery_storage_current_dc_in | Current | A |
| battery_storage_current_dc_out | Current | A |
| battery_storage_power_dc | Power | W |
| battery_storage_power_dc_in | Power | W |
| battery_storage_power_dc_out | Power | W |
| battery_storage_energy_dc_in_total | Energy | Wh |
| battery_storage_energy_dc_out_total | Energy | Wh |
Chimie et état
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| battery_storage_cell_voltage | Voltage (sum) | V | Somme de toutes les tensions de cellules de la chaîne série du storage. |
| battery_storage_soc | State of Charge | % | État de charge de ce storage (0–100). |
| battery_storage_soh | State of Health | % | État de santé de ce storage (0–100). |
| battery_storage_temperature | Temperature | °C | Température représentative au niveau du storage. |
| battery_storage_energy_nominal | Energy | Wh | Énergie nominale installée des cellules de ce storage (début de vie). |
| battery_storage_energy_usable | Energy | Wh | Énergie utilisable maximale — la capacité statique autorisée par le BMS à laquelle correspond un SoC = 100 % (typiquement 85–95 % de _nominal). |
| battery_storage_energy_charged | Energy | Wh | Énergie actuellement stockée, dérivée de soc / 100 × energy_usable. |
| battery_storage_comm_quality | Quality | % | Qualité de la liaison de communication au niveau du storage (0–100). |
Niveau module
Un module à l'intérieur d'une armoire — la plus petite unité dotée de sa propre puce BMS. Labels requis : box, storage, module. Les métriques AC ne sont pratiquement jamais présentes ici.
Interface côté DC
| Nom de la métrique | Type | Unité |
|---|---|---|
| battery_module_voltage_dc | Voltage | V |
| battery_module_voltage_dc_in | Voltage | V |
| battery_module_voltage_dc_out | Voltage | V |
| battery_module_current_dc | Current | A |
| battery_module_current_dc_in | Current | A |
| battery_module_current_dc_out | Current | A |
| battery_module_power_dc | Power | W |
| battery_module_power_dc_in | Power | W |
| battery_module_power_dc_out | Power | W |
| battery_module_energy_dc_in_total | Energy | Wh |
| battery_module_energy_dc_out_total | Energy | Wh |
Chimie et état
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| battery_module_cell_voltage | Voltage (sum) | V | Somme des tensions de cellules de la chaîne série de ce module. |
| battery_module_soc | State of Charge | % | État de charge du module (0–100). |
| battery_module_soh | State of Health | % | État de santé du module (0–100). |
| battery_module_temperature | Temperature | °C | Température représentative du module. |
| battery_module_energy_nominal | Energy | Wh | Énergie maximale stockable de ce module. |
| battery_module_energy_usable | Energy | Wh | Énergie utilisable maximale — la capacité statique autorisée par le BMS à laquelle correspond un SoC = 100 %. |
| battery_module_energy_charged | Energy | Wh | Énergie actuellement stockée, dérivée de soc / 100 × energy_usable. |
| battery_module_comm_quality | Quality | % | Qualité des communications BMS entre ce module et son contrôleur de storage (0–100). |
Niveau cellule
La plus petite unité physique. Les cellules sont connectées en série au sein d'un module et partagent le courant du module, de sorte que le courant et la puissance par cellule n'ont pas de sens. Labels requis : box, storage, module, cell.
| Nom de la métrique | Type | Unité |
|---|---|---|
| battery_cell_voltage | Voltage | V |
| battery_cell_temperature | Temperature | °C |
Métriques de prévision météo
Métriques météo quotidiennes
| Nom de la métrique | Type | Unité |
|---|---|---|
| weather_forecast_daily_shortwave_radiation_sum | Radiation | Wh/m² |
| weather_forecast_daily_precipitation_sum | Precipitation | mm |
| weather_forecast_daily_rain_sum | Rain | mm |
| weather_forecast_daily_showers_sum | Showers | mm |
| weather_forecast_daily_snowfall_sum | Snowfall | cm |
| weather_forecast_daily_precipitation_hours | Duration | h |
| weather_forecast_daily_weather_code | Code | - |
| weather_forecast_daily_temperature_2m_max | Temperature | °C |
| weather_forecast_daily_wind_speed_10m_max | Wind Speed | m/s |
| weather_forecast_daily_wind_gusts_10m_max | Wind Gusts | m/s |
| weather_forecast_daily_wind_direction_10m_dominant | Wind Direction | ° |
Métriques météo à 15 minutes
| Nom de la métrique | Type | Unité |
|---|---|---|
| weather_forecast_minutely_15_terrestrial_radiation | Radiation | W/m² |
| weather_forecast_minutely_15_shortwave_radiation | Radiation | W/m² |
| weather_forecast_minutely_15_diffuse_radiation | Radiation | W/m² |
| weather_forecast_minutely_15_direct_normal_irradiance | Irradiance | W/m² |
| weather_forecast_minutely_15_lightning_potential | Potential | - |
| weather_forecast_minutely_15_precipitation | Precipitation | mm |
| weather_forecast_minutely_15_snowfall | Snowfall | cm |
| weather_forecast_minutely_15_rain | Rain | mm |
| weather_forecast_minutely_15_weather_code | Code | - |
| weather_forecast_minutely_15_relative_humidity_2m | Humidity | % |
| weather_forecast_minutely_15_dew_point_2m | Temperature | °C |
| weather_forecast_minutely_15_apparent_temperature | Temperature | °C |
| weather_forecast_minutely_15_cloud_cover | Cloud Cover | % |
| weather_forecast_minutely_15_temperature_2m | Temperature | °C |
| weather_forecast_minutely_15_temperature_80m | Temperature | °C |
| weather_forecast_minutely_15_temperature_120m | Temperature | °C |
| weather_forecast_minutely_15_temperature_180m | Temperature | °C |
| weather_forecast_minutely_15_wind_speed_10m | Wind Speed | m/s |
| weather_forecast_minutely_15_wind_speed_80m | Wind Speed | m/s |
| weather_forecast_minutely_15_wind_speed_120m | Wind Speed | m/s |
| weather_forecast_minutely_15_wind_speed_180m | Wind Speed | m/s |
| weather_forecast_minutely_15_wind_direction_10m | Wind Direction | ° |
| weather_forecast_minutely_15_wind_direction_80m | Wind Direction | ° |
| weather_forecast_minutely_15_wind_direction_120m | Wind Direction | ° |
| weather_forecast_minutely_15_wind_direction_180m | Wind Direction | ° |
| weather_forecast_minutely_15_wind_gusts_10m | Wind Gusts | m/s |
| weather_forecast_minutely_15_snow_depth | Snow Depth | m |
| weather_forecast_minutely_15_visibility | Visibility | m |
Métriques de calcul météo
| Nom de la métrique | Type | Unité |
|---|---|---|
| weather_forecast_minutely_15_gti | Irradiance | W/m² |
| weather_forecast_minutely_15_gti_direct | Irradiance | W/m² |
| weather_forecast_minutely_15_gti_clearsky | Irradiance | W/m² |
| weather_forecast_minutely_15_ghi_direct | Irradiance | W/m² |
| weather_forecast_minutely_15_ghi_direct_clearsky | Irradiance | W/m² |
| weather_forecast_minutely_15_gti_direct_clearsky | Irradiance | W/m² |
| weather_forecast_minutely_15_gti_energy | Energy | Wh |
Métriques de modèle météo
Métriques de puissance du modèle météo
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_power_model_dc | Power | W |
| powerplant_energy_model_dc_total | Energy | Wh |
| powerplant_power_model_ac | Power | W |
| powerplant_energy_model_ac_total | Energy | Wh |
| powerplant_power_model_grid | Power | W |
| powerplant_energy_model_grid_total | Energy | Wh |
| powerplant_energy_model_grid_in_total | Energy | Wh |
| powerplant_energy_model_grid_out_total | Energy | Wh |
Métriques de puissance du modèle ciel clair
| Nom de la métrique | Type | Unité |
|---|---|---|
| powerplant_power_clearsky_dc | Power | W |
| powerplant_energy_clearsky_dc_total | Energy | Wh |
| powerplant_power_clearsky_ac | Power | W |
| powerplant_energy_clearsky_ac_total | Energy | Wh |
| powerplant_power_clearsky_grid | Power | W |
| powerplant_energy_clearsky_grid_total | Energy | Wh |
| powerplant_energy_clearsky_grid_in_total | Energy | Wh |
| powerplant_energy_clearsky_grid_out_total | Energy | Wh |
Métriques réseau
Les métriques réseau décrivent la connectivité entre l'appareil IoT et le cloud, indépendamment de tout scraper ou service spécifique.
| Nom de la métrique | Type | Unité |
|---|---|---|
| network_ping_latency_ms | Latency | ms |
| network_ping_packet_loss_percent | Packet Loss | % |
| network_ping_success | Success | bool |
| network_connection_status | Status | - |
Métriques d'agent
Les métriques d'agent décrivent les agents de collecte de données eux-mêmes — à la fois l'état par source des adaptateurs de scraper individuels, ainsi que la santé globale et le trafic des agents et de la connectivité de support. Ces métriques permettent à vos tableaux de bord de corréler les lacunes de données avec des défaillances d'adaptateur ou de connectivité plutôt qu'avec l'équipement mesuré.
Métriques des sources du scraper
Le Data Scraper émet un jeu de ces métriques par source d'adaptateur active. Les séries sont distinguées par les labels source, source_num et name, de sorte que les lacunes de données puissent être corrélées directement avec la santé de l'adaptateur plutôt qu'avec l'équipement mesuré.
| Nom de la métrique | Type | Unité | Labels |
|---|---|---|---|
| scraper_health_state | State | code | 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 : État actuel de l'adaptateur, encodé sous forme d'entier :
0= initialisation,1= sain,2= défaillant,3= reconnexion,4= figé (le logger renvoie des valeurs périmées/bloquées),5= en pause. - scraper_cycles_total : Nombre de cycles de récupération exécutés par l'adaptateur depuis le démarrage du processus (réinitialisé au redémarrage).
- scraper_errors_total : Nombre de cycles de récupération s'étant terminés par une exception depuis le démarrage du processus (réinitialisé au redémarrage).
- scraper_last_success_timestamp : Secondes Unix epoch du dernier cycle de récupération réussi. Émis uniquement après le premier succès.
Métriques des services d'agent
Ces métriques suivent la santé et l'utilisation réseau des services d'agent individuels (Data Scraper, Digital Twin et services de support) exécutés sur un appareil, afin que vous puissiez voir si une lacune de données provient de l'équipement ou de l'agent lui-même.
Trafic réseau
| Nom de la métrique | Type | Unité |
|---|---|---|
| agent_network_rx_bytes | Counter | bytes |
| agent_network_tx_bytes | Counter | bytes |
Santé de l'agent
| Nom de la métrique | Type | Unité |
|---|---|---|
| agent_health | Status | bool |
| agent_uptime_seconds | Duration | s |
| agent_boottime | Timestamp | s |
VPN d'organisation
Connectivité et trafic de la liaison VPN à l'échelle de l'organisation entre la centrale et le cloud.
| Nom de la métrique | Type | Unité |
|---|---|---|
| agent_organization_vpn_connected | Status | bool |
| agent_organization_vpn_rx_bytes | Counter | bytes |
| agent_organization_vpn_tx_bytes | Counter | bytes |
VPN direct
Connectivité et trafic de chaque tunnel VPN direct (par centrale). Les séries portent un label vpn_name afin que chaque tunnel soit identifié individuellement.
| Nom de la métrique | Type | Unité |
|---|---|---|
| agent_direct_vpn_connected | Status | bool |
| agent_direct_vpn_rx_bytes | Counter | bytes |
| agent_direct_vpn_tx_bytes | Counter | bytes |
Métriques d'opérateur
La flotte d'opérateurs pousse des métriques d'infrastructure pour la supervision des tunnels VPN et la santé des opérateurs, vous permettant de voir l'état de la connectivité côté cloud qui relie vos centrales à la plateforme.
Métriques des tunnels VPN
| Nom de la métrique | Type | Unité | Labels |
|---|---|---|---|
| operator_vpn_connected | Status | bool | vpn_service, organization, cluster, region |
| operator_vpn_rx_bytes | Traffic | bytes | vpn_service, organization, cluster, region |
| operator_vpn_tx_bytes | Traffic | bytes | vpn_service, organization, cluster, region |
- operator_vpn_connected :
1si le tunnel VPN a eu un handshake récent (au cours des 3 dernières minutes),0sinon - operator_vpn_rx_bytes : Total des octets reçus via le tunnel VPN (compteur)
- operator_vpn_tx_bytes : Total des octets transmis via le tunnel VPN (compteur)
Métriques de santé de l'opérateur
| Nom de la métrique | Type | Unité | Labels |
|---|---|---|---|
| operator_health | Status | bool | operator, cluster, region |
| operator_uptime_seconds | Duration | s | operator, cluster, region |
| operator_cloud_response_age_seconds | Duration | s | operator, cluster, region |
- operator_health :
1si l'opérateur a une connexion cloud active,0s'il est en état de timeout - operator_uptime_seconds : Secondes écoulées depuis le démarrage du processus de l'opérateur
- operator_cloud_response_age_seconds : Secondes écoulées depuis la dernière réponse réussie de l'API cloud
Processus de collecte
Le processus de collecte de données suit un flux de travail structuré :
- Découverte : Le système identifie tous les composants à superviser en fonction de la configuration du parc
- Planification : Les calendriers de collecte sont optimisés en fonction de l'importance et de la variabilité des métriques
- Récupération : Le data scraper se connecte aux appareils et collecte les mesures brutes
- Validation : Les données collectées sont validées pour leur exactitude et leur conformité de plage
- Enrichissement : Des informations contextuelles sont ajoutées (horodatages, identifiants de composants, etc.)
- Transmission : Les données sont transmises de manière sécurisée à la base de données de séries temporelles
- Vérification : Le système confirme le stockage et la disponibilité réussis
Points d'intégration
Le système de collecte de métriques s'intègre avec les autres composants de la plateforme :
- Tableau de bord de supervision : Fournit une visualisation des données en temps réel
- Détection d'événements : Alimente l'identification des anomalies et des problèmes
- Moteur de reporting : Fournit les mesures pour les rapports de performance
- Système d'analyse : Alimente les calculs de performance avancés
- Module de prévision : Fournit les données historiques pour les modèles de prédiction
Sécurité des données
Toutes les métriques collectées sont protégées par plusieurs mesures de sécurité :
- Chiffrement : Les données sont chiffrées en transit et au repos
- Contrôle d'accès : Les métriques sont soumises au même modèle d'autorisations que les autres ressources
- Audit : Tout accès aux données de métriques est journalisé à des fins de conformité
- Anonymisation : Les données agrégées utilisées pour le benchmarking sont anonymisées
Extensibilité
Le système de collecte de métriques est conçu pour l'extensibilité :
- Nouvelles familles d'équipements : Nous développons un adaptateur dédié pour chaque famille d'équipements sur demande — si votre centrale utilise un logger, un onduleur, un compteur ou un système de batteries que nous ne prenons pas encore en charge, il peut être ajouté sans recourir à un mécanisme générique fourre-tout.
- Métriques personnalisées : Prise en charge des mesures spécifiques à un site ou à un équipement.
- Sources de données externes : Les séries météo et d'irradiance de référence sont intégrées aux côtés des données de votre centrale pour alimenter l'analyse et la prévision.
Fonctionnalités associées
- Data Scraper — l'agent edge qui collecte ces métriques avec un adaptateur dédié par famille d'équipements
- Digital Twin — transforme les métriques brutes en production simulée, performance ratio et constats de pertes
- API d'export de métriques — interrogez et téléchargez ces métriques pour votre propre usage
- MiroxQL — le format de requête pour l'accès programmatique et brut à vos métriques collectées
- Supervision en temps réel — tableaux de bord en direct construits sur les métriques collectées