Metrikerfassung
Mirox sammelt Leistungsdaten Ihrer Anlagen für erneuerbare Energien in einem einzigen, standardisierten Metrik-Vokabular — die Grundlage für jede Überwachungs-, Analyse-, Berichts- und Prognosefunktion der Plattform. Diese Seite ist der Referenzkatalog dafür, was gemessen wird und wie die Messungen organisiert sind.
Die vollständige Taxonomie umfasst 376 standardisierte Metriknamen in elf Familien: Anlagenproduktion (powerplant), Batteriespeicher, Wettereingaben, wetterbasierte Modelle sowie mehrere betriebliche Familien, die die Erfassung selbst beschreiben — Netzwerküberwachung, die Agenten, die Operator-Flotte, grundlegende Netzwerkerreichbarkeit und die Scraper-Quellen. Die folgenden Tabellen dokumentieren die Familien, die Sie am häufigsten visualisieren werden; die betrieblichen Familien werden in den Abschnitten Netzwerkmetriken und Agentenmetriken zusammengefasst.
Data-Scraper-Architektur
Im Kern der Metrikerfassung steht der Data Scraper, die Edge-Komponente, die Zeitreihendaten von Ihren Anlagen sammelt. Statt einer einzigen generischen Protokoll-Engine verwendet er einen eigenen Adapter pro Gerätefamilie (Datenlogger, Wechselrichter, Zähler, Batteriesysteme), der jeweils für die Schnittstelle des entsprechenden Herstellers entwickelt wurde. Der Data Scraper kann in zwei Bereitstellungsmodi betrieben werden:
Cloud-basierte Erfassung
Bei der Bereitstellung in der Cloud:
- Verbindet sich über sichere Internetverbindungen mit den Solarparks
- Aggregiert Daten von mehreren Standorten zentral
- Übernimmt Verbindungsverwaltung und Wiederholungslogik
- Optimiert die Bandbreitennutzung durch intelligentes Polling
Edge-basierte Erfassung
Bei der Bereitstellung am Edge (vor Ort):
- Schnittstelle direkt zur lokalen Ausrüstung für minimale Latenz
- Arbeitet mit lokaler Pufferung, um Internetausfälle abzufangen
- Führt vorläufige Datenvalidierung und -filterung durch
- Synchronisiert mit der Cloud, sobald eine Verbindung verfügbar ist
Die Dual-Mode-Architektur gewährleistet eine zuverlässige Datenerfassung unabhängig von den Konnektivitätsbedingungen des Standorts oder der Systemgröße.
Erfasste Metriken
Das Metrikerfassungssystem sammelt einen umfassenden Satz von Messungen, die vollständige Transparenz über die Leistung von Anlagen für erneuerbare Energien bieten. Die Metriken sind entlang dreier orthogonaler Achsen gruppiert:
- Standortmetriken beschreiben den physischen Standort selbst — seine Anlage, seinen Batteriespeicher und das umgebende Wetter.
- Netzwerkmetriken beschreiben die Konnektivität zwischen dem Standort und der Cloud.
- Agentenmetriken beschreiben die Datenerfassungsagenten selbst — die Scraper-Quellen und die unterstützenden Infrastrukturdienste, die auf dem IoT-Gerät laufen.
Standortmetriken
Standortmetriken sind die rohen Zeitreihenmessungen, die direkt von der an einem Standort für erneuerbare Energien installierten Ausrüstung erfasst werden. Sie sind nach Domäne in die Anlage (PV-Wechselrichter, Netzanschluss usw.), das Batteriespeichersystem (BESS) und das Wetter (Vorhersage und modelliert) unterteilt.
Anlagenmetriken (Powerplant)
Netzmetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_energy_grid_total | Energie | Wh |
| powerplant_energy_grid_out_total | Energie | Wh |
| powerplant_grid_energy_total_reactive | Energie | VArh |
| powerplant_grid_energy_total_apparent | Energie | VAh |
| powerplant_power_grid | Leistung | W |
| powerplant_grid_power_reactive | Leistung | VAr |
| powerplant_grid_power_apparent | Leistung | VA |
Hinweis zur Namenskonvention
Die Metriken powerplant_energy_grid_* und powerplant_power_grid folgen aus historischen Gründen nicht dem Standard-Namensmuster (powerplant_grid_energy_* und powerplant_grid_power). Andere Netzmetriken folgen dem Standardmuster powerplant_grid_*. Diese veralteten Metriknamen werden in einer zukünftigen Version an das Standardmuster angepasst.
Wechselrichtermetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_inverter_energy_ac_total | Energie | Wh |
| powerplant_inverter_energy_dc_total | Energie | Wh |
| powerplant_inverter_energy_consumed_total | Energie | Wh |
| powerplant_inverter_power_ac | Leistung | W |
| powerplant_inverter_power_dc | Leistung | W |
| powerplant_inverter_power_reactive | Leistung | VAr |
| powerplant_inverter_power_max | Leistung | W |
| powerplant_inverter_setpoint_power_active | Sollwert | W |
| powerplant_inverter_setpoint_power_active_percent | Sollwert | % |
| powerplant_inverter_setpoint_power_reactive | Sollwert | VAr |
| powerplant_inverter_max_power | Abschaltung | % |
| powerplant_inverter_voltage_ac | Spannung | V |
| powerplant_inverter_current_ac | Strom | A |
| powerplant_inverter_voltage_dc | Spannung | V |
| powerplant_inverter_current_dc | Strom | A |
| powerplant_inverter_resistance_iso | Widerstand | Ohm |
| powerplant_inverter_cos | Leistungsfaktor | - |
| powerplant_inverter_frequency | Frequenz | Hz |
| powerplant_inverter_temperature | Temperatur | °C |
| powerplant_inverter_current_ac_phase | Strom | A |
| powerplant_inverter_voltage_ac__phase__L1_L2 | Spannung | V |
| powerplant_inverter_voltage_ac__phase__L2_L3 | Spannung | V |
| powerplant_inverter_voltage_ac__phase__L3_L1 | Spannung | V |
| powerplant_inverter_current_ac__phase__L1 | Strom | A |
| powerplant_inverter_current_ac__phase__L2 | Strom | A |
| powerplant_inverter_current_ac__phase__L3 | Strom | A |
Generatoranschlusskasten-Metriken (GAK)
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_gak_voltage | Spannung | V |
| powerplant_gak_current | Strom | A |
| powerplant_gak_power | Leistung | W |
| powerplant_gak_energy_total | Energie | Wh |
| powerplant_gak_temperature | Temperatur | °C |
String-Metriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_string_voltage | Spannung | V |
| powerplant_string_current | Strom | A |
| powerplant_string_power | Leistung | W |
| powerplant_string_energy_total | Energie | Wh |
Steuerungsmetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_max_power_by_grid | Abschaltung | % |
| powerplant_max_power_by_external | Abschaltung | % |
| powerplant_max_power_by_local | Abschaltung | % |
| powerplant_control_connection_grid | Steuerung | bool |
| powerplant_control_connection_external | Steuerung | bool |
| powerplant_control_interface_ready | Steuerung | bool |
| powerplant_power_max | Leistung | W |
| powerplant_max_power_source | Steuerung | - |
Einstrahlungsmetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_solar_radiation | Einstrahlung | W/m² |
| powerplant_energy_irradiation_total | Energie | Wh |
| powerplant_solar_ghi_reference | Einstrahlung | W/m² |
| powerplant_solar_ghi_reference_energy | Energie | Wh |
Umweltmetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_humidity | Luftfeuchtigkeit | % |
| powerplant_ambient_temperature | Temperatur | °C |
| powerplant_module_temperature | Temperatur | °C |
| powerplant_wind_speed | Windgeschwindigkeit | m/s |
| powerplant_wind_direction | Windrichtung | ° |
Verlustmetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_energy_loss_total | Energie | Wh |
| powerplant_power_loss | Leistung | W |
Berichtsmetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_power_report | Leistung | W |
| powerplant_energy_report_total | Energie | Wh |
| powerplant_energy_radiation_total | Energie | Wh |
Digital-Twin-Metriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_grid_power_simulation | Leistung | W |
| powerplant_grid_energy_total_simulation | Energie | Wh |
| powerplant_grid_prrc | PRRC | - |
| powerplant_grid_sim_err | Fehler | - |
| powerplant_inverter_power_ac_simulation | Leistung | W |
| powerplant_inverter_energy_ac_total_simulation | Energie | Wh |
| powerplant_inverter_prrc | PRRC | - |
| powerplant_inverter_sim_err | Fehler | - |
| powerplant_gak_power_simulation | Leistung | W |
| powerplant_gak_energy_total_simulation | Energie | Wh |
| powerplant_gak_prrc | PRRC | - |
| powerplant_gak_sim_err | Fehler | - |
| powerplant_string_power_simulation | Leistung | W |
| powerplant_string_energy_total_simulation | Energie | Wh |
| powerplant_string_shadow_factor | Faktor | - |
| powerplant_string_prrc | PRRC | - |
| powerplant_string_sim_err | Fehler | - |
Batteriemetriken
Die Familie battery_* ist das herstellerunabhängige Metrik-Vokabular für jedes Batteriespeichersystem (BESS). Sie folgt einer strikten Komponentenhierarchie, bei der die Instanzidentifikation in Labels lebt, nicht im Metriknamen:
battery_environment_* ambient sensors around the BESS
battery_box_* a BESS box / container — top of the battery side
└── battery_storage_* a cabinet / rack inside the box
└── battery_module_* a module inside the cabinet
└── battery_cell_* an individual cell inside the module
Dies ist eine reine Erfassungs-Spezifikation — Adapter veröffentlichen Rohwerte exakt so, wie der Hersteller sie bereitstellt, ohne Aggregationen, Ableitungen, _min / _max / _mean-Modifikatoren oder Status- bzw. Health-Flags. Jegliche Interpretation, Zusammenfassung und Alarmierung sind nachgelagerte Aufgaben des Digital Twin.
Zwei verschiedene Arten von „Spannung"
Die Spezifikation trennt bewusst zwei physikalisch unterschiedliche Größen, die beide zufällig in Volt gemessen werden:
- Zellspannung (
*_cell_voltage) — die chemische Klemmenspannung, die von den Zellen erzeugt wird. Auf Zellebene ist es die Einzelzellenspannung (~3,2 V für eine LFP-Zelle). Auf höheren Ebenen ist es die Summe aller Zellspannungen desselben Serienstrangs. Sie ändert sich nur mit dem Ladezustand. - Schnittstellenspannung (
*_voltage_dc,_dc_in,_dc_out) — das, was an den elektrischen Klemmen der Batterie eingespeist oder entnommen wird. Unterscheidet sich von der Zellspannung um I·R während des Ladens / Entladens.
Die beiden sind physikalisch dieselbe Zahl, wenn die Batterie im Ruhezustand ist; sie weichen um den IR-Spannungsabfall in dem Moment voneinander ab, in dem ein Strom fließt.
Richtungsabhängige DC-Varianten
Für jede DC-Größe (voltage_dc, current_dc, power_dc) auf Box-, Storage- und Modulebene gibt es drei Varianten: *_dc (vorzeichenbehaftet, einzelnes Register des Herstellers), *_dc_in (immer positiv — Wert beim Laden) und *_dc_out (immer positiv — Wert beim Entladen). Adapter veröffentlichen jeweils die Variante(n), die der Hersteller tatsächlich bereitstellt.
Environment
Umgebungssensoren rund um das BESS — unterschieden durch das Label sensor.
| Metrikname | Typ | Einheit |
|---|---|---|
| battery_environment_temperature | Temperatur | °C |
| battery_environment_humidity | Luftfeuchtigkeit | % |
Box-Ebene
Die oberste Ebene der Batterieseite — eine BESS-Box / ein Container. Erforderliches Label: box. Optionale Labels: inverter, phase. AC-seitige Metriken sind nur vorhanden, wenn die AC↔DC-Wandlung physisch auf Box-Ebene angesiedelt ist.
AC-seitiger Energiefluss
| Metrikname | Typ | Einheit |
|---|---|---|
| battery_box_voltage_ac | Spannung | V |
| battery_box_voltage_ac__phase__L1_L2 | Spannung | V |
| battery_box_voltage_ac__phase__L2_L3 | Spannung | V |
| battery_box_voltage_ac__phase__L3_L1 | Spannung | V |
| battery_box_current_ac | Strom | A |
| battery_box_current_ac__phase__L1 | Strom | A |
| battery_box_current_ac__phase__L2 | Strom | A |
| battery_box_current_ac__phase__L3 | Strom | A |
| battery_box_frequency | Frequenz | Hz |
| battery_box_power_ac | Leistung | W |
| battery_box_power_ac_in | Leistung | W |
| battery_box_power_ac_out | Leistung | W |
| battery_box_power_ac_reactive | Blindleistung | VAr |
| battery_box_power_ac_setpoint | Sollwert | W |
| battery_box_power_ac_setpoint_reactive | Sollwert | VAr |
| battery_box_energy_ac_in_total | Energie | Wh |
| battery_box_energy_ac_out_total | Energie | Wh |
DC-seitige Schnittstelle
| Metrikname | Typ | Einheit |
|---|---|---|
| battery_box_voltage_dc | Spannung | V |
| battery_box_voltage_dc_in | Spannung | V |
| battery_box_voltage_dc_out | Spannung | V |
| battery_box_current_dc | Strom | A |
| battery_box_current_dc_in | Strom | A |
| battery_box_current_dc_out | Strom | A |
| battery_box_power_dc | Leistung | W |
| battery_box_power_dc_in | Leistung | W |
| battery_box_power_dc_out | Leistung | W |
| battery_box_energy_dc_in_total | Energie | Wh |
| battery_box_energy_dc_out_total | Energie | Wh |
Chemie & Zustand
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| battery_box_cell_voltage | Spannung (Summe) | V | Summe der Zellspannungen am DC-Bus der Box. |
| battery_box_soc | Ladezustand | % | Box-weiter Ladezustand (0–100). |
| battery_box_soh | Gesundheitszustand | % | Box-weiter Gesundheitszustand (0–100). |
| battery_box_temperature | Temperatur | °C | Repräsentative Temperatur auf Box-Ebene. |
| battery_box_energy_nominal | Energie | Wh | Installierte Zellen-Nennkapazität zu Beginn der Lebensdauer. Sinkt mit dem SoH. |
| battery_box_energy_usable | Energie | Wh | Maximal nutzbare Energie — die statische, vom BMS erlaubte Kapazität, der SoC = 100 % entspricht (typischerweise 85–95 % von _nominal). |
| battery_box_energy_charged | Energie | Wh | Aktuell in der Box gespeicherte Energie, abgeleitet aus soc / 100 × energy_usable. |
Storage-Ebene
Ein Schrank / Rack innerhalb einer Box. Erforderliche Labels: box, storage. AC-Metriken sind auf dieser Ebene selten.
DC-seitige Schnittstelle
| Metrikname | Typ | Einheit |
|---|---|---|
| battery_storage_voltage_dc | Spannung | V |
| battery_storage_voltage_dc_in | Spannung | V |
| battery_storage_voltage_dc_out | Spannung | V |
| battery_storage_current_dc | Strom | A |
| battery_storage_current_dc_in | Strom | A |
| battery_storage_current_dc_out | Strom | A |
| battery_storage_power_dc | Leistung | W |
| battery_storage_power_dc_in | Leistung | W |
| battery_storage_power_dc_out | Leistung | W |
| battery_storage_energy_dc_in_total | Energie | Wh |
| battery_storage_energy_dc_out_total | Energie | Wh |
Chemie & Zustand
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| battery_storage_cell_voltage | Spannung (Summe) | V | Summe aller Zellspannungen im Serienstrang des Storage. |
| battery_storage_soc | Ladezustand | % | Ladezustand dieses Storage (0–100). |
| battery_storage_soh | Gesundheitszustand | % | Gesundheitszustand dieses Storage (0–100). |
| battery_storage_temperature | Temperatur | °C | Repräsentative Temperatur auf Storage-Ebene. |
| battery_storage_energy_nominal | Energie | Wh | Installierte Zellen-Nennkapazität dieses Storage (Beginn der Lebensdauer). |
| battery_storage_energy_usable | Energie | Wh | Maximal nutzbare Energie — die statische, vom BMS erlaubte Kapazität, der SoC = 100 % entspricht (typischerweise 85–95 % von _nominal). |
| battery_storage_energy_charged | Energie | Wh | Aktuell gespeicherte Energie, abgeleitet aus soc / 100 × energy_usable. |
| battery_storage_comm_quality | Qualität | % | Qualität der Kommunikationsverbindung auf Storage-Ebene (0–100). |
Modul-Ebene
Ein Modul innerhalb eines Schranks — die kleinste Einheit mit eigenem BMS-Chip. Erforderliche Labels: box, storage, module. AC-Metriken sind hier praktisch nie vorhanden.
DC-seitige Schnittstelle
| Metrikname | Typ | Einheit |
|---|---|---|
| battery_module_voltage_dc | Spannung | V |
| battery_module_voltage_dc_in | Spannung | V |
| battery_module_voltage_dc_out | Spannung | V |
| battery_module_current_dc | Strom | A |
| battery_module_current_dc_in | Strom | A |
| battery_module_current_dc_out | Strom | A |
| battery_module_power_dc | Leistung | W |
| battery_module_power_dc_in | Leistung | W |
| battery_module_power_dc_out | Leistung | W |
| battery_module_energy_dc_in_total | Energie | Wh |
| battery_module_energy_dc_out_total | Energie | Wh |
Chemie & Zustand
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| battery_module_cell_voltage | Spannung (Summe) | V | Summe der Zellspannungen im Serienstrang dieses Moduls. |
| battery_module_soc | Ladezustand | % | Modul-Ladezustand (0–100). |
| battery_module_soh | Gesundheitszustand | % | Modul-Gesundheitszustand (0–100). |
| battery_module_temperature | Temperatur | °C | Repräsentative Modultemperatur. |
| battery_module_energy_nominal | Energie | Wh | Maximal speicherbare Energie dieses Moduls. |
| battery_module_energy_usable | Energie | Wh | Maximal nutzbare Energie — die statische, vom BMS erlaubte Kapazität, der SoC = 100 % entspricht. |
| battery_module_energy_charged | Energie | Wh | Aktuell gespeicherte Energie, abgeleitet aus soc / 100 × energy_usable. |
| battery_module_comm_quality | Qualität | % | Qualität der BMS-Kommunikation zwischen diesem Modul und seinem Storage-Controller (0–100). |
Zell-Ebene
Die kleinste physische Einheit. Zellen sind innerhalb eines Moduls in Reihe geschaltet und teilen sich den Modulstrom, sodass Strom und Leistung pro Zelle nicht aussagekräftig sind. Erforderliche Labels: box, storage, module, cell.
| Metrikname | Typ | Einheit |
|---|---|---|
| battery_cell_voltage | Spannung | V |
| battery_cell_temperature | Temperatur | °C |
Wettervorhersage-Metriken
Tägliche Wettermetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| weather_forecast_daily_shortwave_radiation_sum | Strahlung | Wh/m² |
| weather_forecast_daily_precipitation_sum | Niederschlag | mm |
| weather_forecast_daily_rain_sum | Regen | mm |
| weather_forecast_daily_showers_sum | Schauer | mm |
| weather_forecast_daily_snowfall_sum | Schneefall | cm |
| weather_forecast_daily_precipitation_hours | Dauer | h |
| weather_forecast_daily_weather_code | Code | - |
| weather_forecast_daily_temperature_2m_max | Temperatur | °C |
| weather_forecast_daily_wind_speed_10m_max | Windgeschwindigkeit | m/s |
| weather_forecast_daily_wind_gusts_10m_max | Windböen | m/s |
| weather_forecast_daily_wind_direction_10m_dominant | Windrichtung | ° |
15-Minuten-Wettermetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| weather_forecast_minutely_15_terrestrial_radiation | Strahlung | W/m² |
| weather_forecast_minutely_15_shortwave_radiation | Strahlung | W/m² |
| weather_forecast_minutely_15_diffuse_radiation | Strahlung | W/m² |
| weather_forecast_minutely_15_direct_normal_irradiance | Einstrahlung | W/m² |
| weather_forecast_minutely_15_lightning_potential | Potenzial | - |
| weather_forecast_minutely_15_precipitation | Niederschlag | mm |
| weather_forecast_minutely_15_snowfall | Schneefall | cm |
| weather_forecast_minutely_15_rain | Regen | mm |
| weather_forecast_minutely_15_weather_code | Code | - |
| weather_forecast_minutely_15_relative_humidity_2m | Luftfeuchtigkeit | % |
| weather_forecast_minutely_15_dew_point_2m | Temperatur | °C |
| weather_forecast_minutely_15_apparent_temperature | Temperatur | °C |
| weather_forecast_minutely_15_cloud_cover | Bewölkung | % |
| weather_forecast_minutely_15_temperature_2m | Temperatur | °C |
| weather_forecast_minutely_15_temperature_80m | Temperatur | °C |
| weather_forecast_minutely_15_temperature_120m | Temperatur | °C |
| weather_forecast_minutely_15_temperature_180m | Temperatur | °C |
| weather_forecast_minutely_15_wind_speed_10m | Windgeschwindigkeit | m/s |
| weather_forecast_minutely_15_wind_speed_80m | Windgeschwindigkeit | m/s |
| weather_forecast_minutely_15_wind_speed_120m | Windgeschwindigkeit | m/s |
| weather_forecast_minutely_15_wind_speed_180m | Windgeschwindigkeit | m/s |
| weather_forecast_minutely_15_wind_direction_10m | Windrichtung | ° |
| weather_forecast_minutely_15_wind_direction_80m | Windrichtung | ° |
| weather_forecast_minutely_15_wind_direction_120m | Windrichtung | ° |
| weather_forecast_minutely_15_wind_direction_180m | Windrichtung | ° |
| weather_forecast_minutely_15_wind_gusts_10m | Windböen | m/s |
| weather_forecast_minutely_15_snow_depth | Schneehöhe | m |
| weather_forecast_minutely_15_visibility | Sichtweite | m |
Wetterberechnungs-Metriken
| Metrikname | Typ | Einheit |
|---|---|---|
| weather_forecast_minutely_15_gti | Einstrahlung | W/m² |
| weather_forecast_minutely_15_gti_direct | Einstrahlung | W/m² |
| weather_forecast_minutely_15_gti_clearsky | Einstrahlung | W/m² |
| weather_forecast_minutely_15_ghi_direct | Einstrahlung | W/m² |
| weather_forecast_minutely_15_ghi_direct_clearsky | Einstrahlung | W/m² |
| weather_forecast_minutely_15_gti_direct_clearsky | Einstrahlung | W/m² |
| weather_forecast_minutely_15_gti_energy | Energie | Wh |
Wettermodell-Metriken
Wettermodell-Leistungsmetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_power_model_dc | Leistung | W |
| powerplant_energy_model_dc_total | Energie | Wh |
| powerplant_power_model_ac | Leistung | W |
| powerplant_energy_model_ac_total | Energie | Wh |
| powerplant_power_model_grid | Leistung | W |
| powerplant_energy_model_grid_total | Energie | Wh |
| powerplant_energy_model_grid_in_total | Energie | Wh |
| powerplant_energy_model_grid_out_total | Energie | Wh |
Clearsky-Modell-Leistungsmetriken
| Metrikname | Typ | Einheit |
|---|---|---|
| powerplant_power_clearsky_dc | Leistung | W |
| powerplant_energy_clearsky_dc_total | Energie | Wh |
| powerplant_power_clearsky_ac | Leistung | W |
| powerplant_energy_clearsky_ac_total | Energie | Wh |
| powerplant_power_clearsky_grid | Leistung | W |
| powerplant_energy_clearsky_grid_total | Energie | Wh |
| powerplant_energy_clearsky_grid_in_total | Energie | Wh |
| powerplant_energy_clearsky_grid_out_total | Energie | Wh |
Netzwerkmetriken
Netzwerkmetriken beschreiben die Konnektivität zwischen dem IoT-Gerät und der Cloud, unabhängig von einem bestimmten Scraper oder Dienst.
| Metrikname | Typ | Einheit |
|---|---|---|
| network_ping_latency_ms | Latenz | ms |
| network_ping_packet_loss_percent | Paketverlust | % |
| network_ping_success | Erfolg | bool |
| network_connection_status | Status | - |
Agentenmetriken
Agentenmetriken beschreiben die Datenerfassungsagenten selbst — sowohl den Zustand einzelner Scraper-Adapter pro Quelle als auch die allgemeine Gesundheit und den Datenverkehr der Agenten und der unterstützenden Konnektivität. Diese Metriken ermöglichen es Ihren Dashboards, Datenlücken mit Adapter- oder Konnektivitätsausfällen statt mit der gemessenen Ausrüstung zu korrelieren.
Scraper-Quellenmetriken
Der Data Scraper gibt einen Satz dieser Metriken pro aktiver Adapter-Quelle aus. Die Zeitreihen werden durch die Labels source, source_num und name unterschieden, sodass Datenlücken direkt mit der Adapter-Gesundheit statt mit der gemessenen Ausrüstung korreliert werden können.
| Metrikname | Typ | Einheit | Labels |
|---|---|---|---|
| scraper_health_state | Zustand | code | source, source_num, name |
| scraper_cycles_total | Zähler | - | source, source_num, name |
| scraper_errors_total | Zähler | - | source, source_num, name |
| scraper_last_success_timestamp | Zeitstempel | s | source, source_num, name |
- scraper_health_state: Aktueller Adapter-Zustand, codiert als Ganzzahl:
0= Initialisierung,1= gesund,2= ungesund,3= wird neu verbunden,4= eingefroren (der Logger liefert veraltete/feststeckende Werte),5= pausiert. - scraper_cycles_total: Anzahl der Abrufzyklen, die der Adapter seit Prozessstart ausgeführt hat (wird beim Neustart zurückgesetzt).
- scraper_errors_total: Anzahl der Abrufzyklen, die seit Prozessstart mit einer Ausnahme endeten (wird beim Neustart zurückgesetzt).
- scraper_last_success_timestamp: Unix-Epochensekunden des letzten erfolgreichen Abrufzyklus. Wird erst nach dem ersten Erfolg ausgegeben.
Agentendienst-Metriken
Diese Metriken verfolgen die Gesundheit und Netzwerknutzung der einzelnen Agentendienste (Data Scraper, Digital Twin und unterstützende Dienste), die auf einem Gerät laufen, sodass Sie erkennen können, ob eine Datenlücke an der Ausrüstung oder am Agenten selbst liegt.
Netzwerkverkehr
| Metrikname | Typ | Einheit |
|---|---|---|
| agent_network_rx_bytes | Zähler | bytes |
| agent_network_tx_bytes | Zähler | bytes |
Agentengesundheit
| Metrikname | Typ | Einheit |
|---|---|---|
| agent_health | Status | bool |
| agent_uptime_seconds | Dauer | s |
| agent_boottime | Zeitstempel | s |
Organisations-VPN
Konnektivität und Datenverkehr für die organisationsweite VPN-Verbindung zwischen der Anlage und der Cloud.
| Metrikname | Typ | Einheit |
|---|---|---|
| agent_organization_vpn_connected | Status | bool |
| agent_organization_vpn_rx_bytes | Zähler | bytes |
| agent_organization_vpn_tx_bytes | Zähler | bytes |
Direktes VPN
Konnektivität und Datenverkehr für jeden direkten (anlagenspezifischen) VPN-Tunnel. Die Zeitreihen tragen ein Label vpn_name, sodass jeder Tunnel einzeln identifiziert wird.
| Metrikname | Typ | Einheit |
|---|---|---|
| agent_direct_vpn_connected | Status | bool |
| agent_direct_vpn_rx_bytes | Zähler | bytes |
| agent_direct_vpn_tx_bytes | Zähler | bytes |
Operator-Metriken
Die Operator-Flotte sendet Infrastrukturmetriken für die VPN-Tunnelüberwachung und die Operator-Gesundheit, sodass Sie den Zustand der cloudseitigen Konnektivität sehen können, die Ihre Anlagen mit der Plattform verbindet.
VPN-Tunnel-Metriken
| Metrikname | Typ | Einheit | Labels |
|---|---|---|---|
| operator_vpn_connected | Status | bool | vpn_service, organization, cluster, region |
| operator_vpn_rx_bytes | Datenverkehr | bytes | vpn_service, organization, cluster, region |
| operator_vpn_tx_bytes | Datenverkehr | bytes | vpn_service, organization, cluster, region |
- operator_vpn_connected:
1, wenn der VPN-Tunnel einen aktuellen Handshake hat (innerhalb der letzten 3 Minuten), sonst0 - operator_vpn_rx_bytes: Gesamtzahl der über den VPN-Tunnel empfangenen Bytes (Zähler)
- operator_vpn_tx_bytes: Gesamtzahl der über den VPN-Tunnel übertragenen Bytes (Zähler)
Operator-Gesundheitsmetriken
| Metrikname | Typ | Einheit | Labels |
|---|---|---|---|
| operator_health | Status | bool | operator, cluster, region |
| operator_uptime_seconds | Dauer | s | operator, cluster, region |
| operator_cloud_response_age_seconds | Dauer | s | operator, cluster, region |
- operator_health:
1, wenn der Operator eine aktive Cloud-Verbindung hat,0im Timeout-Zustand - operator_uptime_seconds: Sekunden seit dem Start des Operator-Prozesses
- operator_cloud_response_age_seconds: Sekunden seit der letzten erfolgreichen Cloud-API-Antwort
Erfassungsprozess
Der Datenerfassungsprozess folgt einem strukturierten Workflow:
- Erkennung: Das System identifiziert alle zu überwachenden Komponenten anhand der Park-Konfiguration
- Planung: Erfassungspläne werden auf Basis von Metrikwichtigkeit und Variabilität optimiert
- Abruf: Der Data Scraper verbindet sich mit den Geräten und sammelt Rohmessungen
- Validierung: Die erfassten Daten werden auf Genauigkeit und Bereichskonformität geprüft
- Anreicherung: Kontextinformationen werden hinzugefügt (Zeitstempel, Komponentenkennungen usw.)
- Übertragung: Die Daten werden sicher an die Zeitreihendatenbank übertragen
- Verifizierung: Das System bestätigt die erfolgreiche Speicherung und Verfügbarkeit
Integrationspunkte
Das Metrikerfassungssystem integriert sich mit anderen Plattformkomponenten:
- Überwachungs-Dashboard: Bietet Echtzeit-Datenvisualisierung
- Ereigniserkennung: Liefert Daten zur Identifikation von Anomalien und Problemen
- Berichts-Engine: Stellt Messungen für Leistungsberichte bereit
- Analysesystem: Speist Daten in erweiterte Leistungsberechnungen ein
- Prognosemodul: Liefert historische Daten für Vorhersagemodelle
Datensicherheit
Alle erfassten Metriken werden durch mehrere Sicherheitsmaßnahmen geschützt:
- Verschlüsselung: Die Daten werden sowohl bei der Übertragung als auch im Ruhezustand verschlüsselt
- Zugriffskontrolle: Metriken unterliegen demselben Berechtigungsmodell wie andere Ressourcen
- Auditierung: Jeder Zugriff auf Metrikdaten wird zu Compliance-Zwecken protokolliert
- Anonymisierung: Aggregierte Daten, die für Benchmarking verwendet werden, werden anonymisiert
Erweiterbarkeit
Das Metrikerfassungssystem ist auf Erweiterbarkeit ausgelegt:
- Neue Gerätefamilien: Wir entwickeln auf Anfrage einen eigenen Adapter für jede Gerätefamilie — wenn Ihre Anlage einen Logger, Wechselrichter, Zähler oder ein Batteriesystem verwendet, das wir noch nicht unterstützen, kann es ohne eine generische Universallösung hinzugefügt werden.
- Benutzerdefinierte Metriken: Unterstützung für standort- oder gerätespezifische Messungen.
- Externe Datenquellen: Wetter- und Referenz-Einstrahlungsreihen werden zusammen mit Ihren Anlagendaten eingebunden, um Analyse und Prognose zu ermöglichen.
Verwandte Funktionen
- Data Scraper — der Edge-Agent, der diese Metriken mit einem eigenen Adapter pro Gerätefamilie sammelt
- Digital Twin — wandelt die Rohmetriken in simulierte Produktion, Performance Ratio und Verlustbefunde um
- Metrics Export API — fragen Sie diese Metriken ab und laden Sie sie für Ihre eigene Verwendung herunter
- MiroxQL — das Abfrageformat für programmatischen und Rohdatenzugriff auf Ihre erfassten Metriken
- Echtzeit-Überwachung — Live-Dashboards, die auf den erfassten Metriken aufbauen