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 458 noms de métriques standardisés répartis en douze familles : production de la centrale (powerplant), stockage par batterie, le système d'alarme du site, 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, son système d'alarme 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), le système d'alarme du site 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_vendor_status | Statut | code |
| 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_external_w | Shutdown | W |
| powerplant_max_power_by_local | Shutdown | % |
| powerplant_battery_setpoint_external | Control | % |
| powerplant_battery_setpoint_local_w | Control | W |
| 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 des analyses edge
Le Data Scraper calcule un ensemble d'analyses directement sur la centrale et les publie sous forme de séries traçables aux côtés des mesures brutes. Ce sont les séries qui sous-tendent les fonctionnalités de performance ratio, d'écrêtement et de règlement de la plateforme. La plupart des familles existent une fois par source d'irradiance — notée <source> ci-dessous, l'une de pyranometer (capteurs sur site), satellite (irradiance dérivée du satellite pour le site) ou weather (irradiance modélisée à partir de données météorologiques) — de sorte que chaque source conserve ses propres séries indépendantes et qu'une entrée qui dérive ne puisse jamais fausser silencieusement les autres.
Irradiance et production modélisée
L'irradiance dans le plan des modules vue par chaque source, et la production théorique (non écrêtée) de la centrale modélisée à partir de celle-ci. Un jeu par source — 13 séries au total.
| Motif de nom de métrique | Type | Unité | Description |
|---|---|---|---|
powerplant_<source>_radiation_power | Irradiance | W/m² | Irradiance dans le plan des modules issue de cette source — l'ensoleillement qui atteint réellement les modules. |
powerplant_<source>_radiation_energy_total | Energy | Wh/m² | Irradiation cumulée intégrée à partir de la série ci-dessus. |
| powerplant_pyranometer_ghi_radiation_power | Irradiance | W/m² | Irradiance horizontale (GHI) moyenne et nettoyée de la centrale — présente uniquement lorsque la centrale dispose de pyranomètres horizontaux. |
powerplant_<source>_power | Power | W | Production théorique de la centrale modélisée à partir de l'irradiance de cette source et des orientations des modules de la centrale. |
powerplant_<source>_energy_total | Energy | Wh | Énergie modélisée cumulée. |
Performance ratio
La production réelle comparée à la production modélisée — une voie de PR indépendante par source d'irradiance, au niveau de la centrale. Voir Puissance attendue et performance ratio pour le fonctionnement des filtres.
| Motif de nom de métrique | Type | Unité | Description |
|---|---|---|---|
powerplant_<source>_pr | Performance Ratio | - | Production mesurée rapportée à la production modélisée. |
powerplant_<source>_pr_filter | Filter | - | Décomposition par filtre — quel filtre de qualité (faible luminosité, écrêtage, écrêtement, gel/neige/brouillard, lacunes de données) a exclu un instant du PR propre. |
powerplant_<source>_pr_validity | Validity | bool | 1 lorsque l'instant a passé tous les filtres et compte dans le PR fiable. |
Puissance et énergie attendues
L'attente calibrée par le PR — la production modélisée mise à l'échelle de l'efficacité réelle de la centrale. C'est la référence à laquelle le watchdog de santé des composants confronte la production en direct.
| Motif de nom de métrique | Type | Unité | Description |
|---|---|---|---|
powerplant_<source>_expected_power | Power | W | Production attendue de la centrale dans les conditions actuelles. |
powerplant_<source>_expected_energy_total | Energy | Wh | Énergie attendue cumulée. |
Modèle et performance ratio par composant
L'analogue au niveau composant du modèle à l'échelle de la centrale : production théorique et PR d'un onduleur, d'une boîte de jonction (GAK) ou d'un string individuel, utilisant l'orientation et la puissance crête propres à ce composant. Émis pour les sources weather et pyranometer ; les séries portent les labels d'identité du composant. <component> est l'un de inverter, gak, string — 12 séries au total, plus le marqueur quotidien de complétude.
| Motif de nom de métrique | Type | Unité | Description |
|---|---|---|---|
powerplant_<source>_<component>_power | Power | W | Production modélisée d'un composant à partir de l'irradiance de cette source. |
powerplant_<source>_<component>_pr | Performance Ratio | - | Performance ratio par composant (valeurs propres et filtrées uniquement). |
| powerplant_simulation_day_complete | Marker | - | Horodaté une fois par source et par jour lorsque les séries de modèle du jour sont vérifiées complètes. |
Voies de puissance en direct et de prévision
Références de production en temps réel et prospectives.
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| powerplant_pyranometer_live_power | Power | W | Puissance attendue en temps réel, ajustée par le PR, à partir des capteurs sur site. |
| powerplant_satellite_live_power | Power | W | Puissance attendue en temps réel, ajustée par le PR, à partir de l'irradiance satellite. |
| powerplant_pyranometer_live_energy_total | Energy | Wh | Énergie cumulée de la voie en direct pyranomètre. |
| powerplant_satellite_live_energy_total | Energy | Wh | Énergie cumulée de la voie en direct satellite. |
| powerplant_clearsky_power | Power | W | Production théorique en conditions idéales (ciel clair) — le plafond physique d'une journée écoulée. |
| powerplant_clearsky_energy_total | Energy | Wh | Énergie ciel clair cumulée. |
| powerplant_weather_forecast_power | Power | W | Prévision de production à un jour dérivée des données météo. |
| powerplant_weather_forecast_energy_total | Energy | Wh | Énergie de prévision cumulée. |
| powerplant_clearsky_forecast_power | Power | W | Prévision ciel clair — le plafond en conditions idéales pour l'horizon de prévision. |
| powerplant_clearsky_forecast_energy_total | Energy | Wh | Énergie de prévision ciel clair cumulée. |
Écrêtement
La production manquée attribuée à sa cause — <party> est grid (une consigne du gestionnaire de réseau limite la production) ou marketer (le plafond du marketer direct limite la production). Chaque combinaison est émise sous forme de puissance instantanée et d'énergie cumulée, en deux variantes : la série réglée et une série live calculée en temps réel. 24 séries au total.
| Motif de nom de métrique | Type | Unité | Description |
|---|---|---|---|
powerplant_<source>curtailment<party>_power | Power | W | Perte d'écrêtement réglée — la production manquée du fait de l'acteur dont la limitation est contraignante. |
powerplant_<source>curtailment<party>_energy_total | Energy | Wh | Énergie d'écrêtement réglée cumulée. |
powerplant_<source>live_curtailment<party>_power | Power | W | La même attribution calculée en direct, aux horodatages réels. |
powerplant_<source>live_curtailment<party>_energy_total | Energy | Wh | Énergie d'écrêtement en direct cumulée. |
Familles de règlement
Les séries qui sous-tendent le règlement et l'indemnisation de l'écrêtement. La famille fixed (forfaitaire) met en œuvre la méthode de règlement indépendante des sources : la référence est la puissance réseau mesurée moyenne sur les 15 minutes précédant le début de l'écrêtement, figée pour toute la durée de la mesure — aucune entrée d'irradiance n'est nécessaire. La famille Mischpreis valorise l'énergie écrêtée au prix mixte du marché allemand au quart d'heure, donnant une valeur de revenu en EUR par intervalle de 15 minutes.
| Motif de nom de métrique | Type | Unité | Description |
|---|---|---|---|
powerplant_fixed_curtailment_<party>_power | Power | W | Perte d'écrêtement forfaitaire par rapport à la référence pré-écrêtement figée. |
powerplant_fixed_curtailment_<party>_energy_total | Energy | Wh | Énergie d'écrêtement forfaitaire cumulée. |
| powerplant_fixed_curtailment_reference_power | Power | W | La dernière puissance de référence non écrêtée valide que la méthode forfaitaire fige au début de l'écrêtement. |
powerplant_mischpreis_<variant>_<party>_revenue | Revenue | EUR | Valeur de marché de l'énergie écrêtée par intervalle de 15 minutes. <variant> est l'une des voies d'écrêtement ci-dessus : pyranometer, satellite, weather, leurs équivalents _live, ou fixed — 14 séries au total. |
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_pcs_* Power Conversion System raccordé au réseau, en amont de la box
battery_box_* une box / un conteneur BESS — la batterie DC
└── 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
La hiérarchie batterie (box → storage → module → cellule) décrit la batterie DC elle-même. Le PCS (battery_pcs_*) est le convertisseur AC↔DC raccordé au réseau situé en amont de la box — il possède le côté AC du BESS ainsi que sa propre télémétrie de convertisseur, et est identifié par appareil via le label pcs. Le modéliser comme un composant à part entière permet de collecter la batterie et son convertisseur comme deux appareils indépendants pour un même conteneur, sans collision entre leurs séries.
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 PCS
Le Power Conversion System raccordé au réseau — le convertisseur AC↔DC en amont de la box batterie. Il possède le côté AC du BESS (que la batterie DC ne mesure jamais), ainsi que sa propre lecture du bus DC, l'état de la batterie qu'il relaie et la télémétrie côté convertisseur. Un PCS est un appareil distinct, identifié par le label pcs ; phase distingue les grandeurs AC par phase. Convention de signe : positif = charge (réseau → batterie) ; la direction est résolue à partir des compteurs d'énergie directionnels, jamais d'un bit d'état.
Bus DC
La vue propre du convertisseur sur la liaison DC — l'état DC faisant autorité pour la batterie reste au niveau de la box.
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| battery_pcs_voltage_dc | Voltage | V | Tension du bus DC mesurée au convertisseur. |
| battery_pcs_current_dc | Current | A | Courant DC. Signé (+ = charge). |
| battery_pcs_power_dc | Power | W | Puissance DC. Signée. |
Côté AC
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| battery_pcs_voltage_ac | Voltage | V | Tension AC efficace (RMS) entre phases. |
| battery_pcs_voltage_ac__phase__L1_L2 | Voltage | V | Tension AC par phase (entre phases). |
| battery_pcs_voltage_ac__phase__L2_L3 | Voltage | V | Tension AC par phase (entre phases). |
| battery_pcs_voltage_ac__phase__L3_L1 | Voltage | V | Tension AC par phase (entre phases). |
| battery_pcs_current_ac | Current | A | Courant AC efficace (RMS). |
| battery_pcs_current_ac__phase__L1 | Current | A | Courant AC par phase. |
| battery_pcs_current_ac__phase__L2 | Current | A | Courant AC par phase. |
| battery_pcs_current_ac__phase__L3 | Current | A | Courant AC par phase. |
| battery_pcs_frequency | Frequency | Hz | Fréquence AC. |
| battery_pcs_power_ac | Power | W | Puissance active, côté AC. Signée. |
| battery_pcs_power_ac_in | Power | W | Puissance active entrant dans la batterie (charge depuis le réseau). Toujours positive. |
| battery_pcs_power_ac_out | Power | W | Puissance active sortant de la batterie (décharge vers le réseau). Toujours positive. |
| battery_pcs_power_ac_reactive | Reactive Power | VAr | Puissance réactive, côté AC. Signée. |
| battery_pcs_power_factor | Power Factor | - | Facteur de puissance (−1…1). |
Consignes
Vue en lecture seule des cibles de dispatch actives.
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| battery_pcs_power_ac_setpoint | Setpoint | W | Consigne de puissance active. Signée. |
| battery_pcs_power_ac_setpoint_reactive | Setpoint | VAr | Consigne de puissance réactive. Signée. |
| battery_pcs_power_factor_setpoint | Setpoint | - | Consigne de facteur de puissance. |
Compteurs d'énergie
Publiés exactement tels que les compteurs cumulés propres à l'appareil les rapportent — des compteurs directionnels séparés, aucune décision de signe n'est donc nécessaire.
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| battery_pcs_energy_ac_in_total | Energy | Wh | Énergie AC cumulée chargée dans la batterie. |
| battery_pcs_energy_ac_out_total | Energy | Wh | Énergie AC cumulée déchargée de la batterie. |
État batterie relayé et limites du convertisseur
Le PCS relaie une synthèse du système de gestion de batterie et rapporte ses propres limites de fonctionnement dynamiques. Là où le système de gestion de batterie est collecté directement, battery_box_soc fait autorité et la valeur relayée est redondante ; sur un site équipé du seul PCS, c'est le seul état de charge disponible.
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| battery_pcs_soc | State of Charge | % | État de charge relayé depuis le système de gestion de batterie (0–100). |
| battery_pcs_current_limit_charge | Limit | A | Courant de charge maximal autorisé (dynamique). |
| battery_pcs_current_limit_discharge | Limit | A | Courant de décharge maximal autorisé. |
| battery_pcs_power_limit_charge | Limit | W | Puissance de charge maximale autorisée. |
| battery_pcs_power_limit_discharge | Limit | W | Puissance de décharge maximale autorisée. |
| battery_pcs_temperature | Temperature | °C | Température du convertisseur — l'état thermique du convertisseur, pas une température de cellule de batterie. |
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 — elles ne sont présentes que lorsque la conversion AC↔DC se situe physiquement au niveau du storage.
Flux d'énergie côté AC
Le même vocabulaire AC qu'au niveau de la box, sans variantes par phase ni consignes.
| Nom de la métrique | Type | Unité |
|---|---|---|
| battery_storage_voltage_ac | Voltage | V |
| battery_storage_current_ac | Current | A |
| battery_storage_frequency | Frequency | Hz |
| battery_storage_power_ac | Power | W |
| battery_storage_power_ac_in | Power | W |
| battery_storage_power_ac_out | Power | W |
| battery_storage_power_ac_reactive | Reactive Power | VAr |
| battery_storage_energy_ac_in_total | Energy | Wh |
| battery_storage_energy_ac_out_total | Energy | Wh |
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 du système d'alarme
La famille alarm_* est la signalisation d'alarme du site lui-même. Rien n'y est mesuré : chaque valeur est la position d'un contact de relais lu via les entrées numériques d'un automate — les sorties relais d'une centrale d'alarme intrusion, ainsi que les contacts de supervision de l'armoire de communication sur laquelle la centrale est câblée.
Chaque série est une jauge 0/1 normalisée de sorte que 1 signifie toujours « la condition est présente » (porte ouverte, alarme déclenchée, ASI sur batterie, disjoncteur déclenché) et 0 signifie normal, quelle que soit la polarité du contact. Une absence n'est jamais un zéro : un signal que l'équipement n'a pas servi lors de ce cycle n'est pas publié du tout, et un contact que l'exploitant a déclaré non câblé est retenu plutôt que laissé en alarme permanente. L'identification d'instance vit dans le label alarm — le système d'alarme auquel les signaux appartiennent — jamais dans le nom de la métrique.
Chaque signal sauf alarm_door_open ouvre en outre un événement de parc du même nom tant qu'il est actif ; une porte ouverte relève de la routine et reste une simple série. Voir Système d'alarme pour la page que ces séries alimentent.
| Nom de la métrique | Type | Unité | Description |
|---|---|---|---|
| alarm_door_open | État | 0/1 | La centrale signale le portail ou la porte comme ouvert. Série uniquement — jamais un événement. |
| alarm_triggered | État | 0/1 | La centrale a déclenché une alarme. |
| alarm_fault | État | 0/1 | La centrale signale un dérangement qui lui est propre. |
| alarm_cabinet_ups_alarm | État | 0/1 | L'ASI de l'armoire de communication signale un défaut. |
| alarm_cabinet_ups_on_battery | État | 0/1 | Perte du réseau — l'ASI alimente l'armoire. |
| alarm_cabinet_heating_breaker_tripped | État | 0/1 | Le disjoncteur du chauffage de l'armoire a déclenché. |
| alarm_cabinet_main_switch_off | État | 0/1 | L'interrupteur général de l'armoire est coupé. |
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 |
VPN SaaS
Connectivité et trafic du tunnel intégré agent-vers-cloud qui achemine le trafic d'accès distant de la plateforme vers la centrale.
| Nom de la métrique | Type | Unité |
|---|---|---|
| agent_saas_vpn_connected | Status | bool |
| agent_saas_vpn_rx_bytes | Counter | bytes |
| agent_saas_vpn_tx_bytes | Counter | bytes |
Serveur VPN
Lorsque l'agent agit lui-même comme serveur VPN pour les connexions entrantes, ces métriques rapportent l'état du serveur et chaque pair qui se connecte. Les séries par pair portent les labels interface, peer_uid et peer_kind, afin que les tableaux de bord puissent distinguer les connexions d'utilisateurs des liaisons de sites.
| Nom de la métrique | Type | Unité |
|---|---|---|
| agent_vpn_server_running | Status | bool |
| agent_vpn_server_peer_connected | Status | bool |
| agent_vpn_server_peer_rx_bytes | Counter | bytes |
| agent_vpn_server_peer_tx_bytes | Counter | bytes |
| agent_vpn_server_peer_last_handshake | Timestamp | s |
- agent_vpn_server_peer_last_handshake : Secondes Unix epoch du dernier handshake abouti du pair ;
0signifie que le pair n'en a jamais abouti un. Pour les pairs OpenVPN, qui n'exposent pas d'horodatage par handshake, l'heure de début de connexion est publiée sous la même métrique afin qu'une seule requête couvre les deux protocoles.
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