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 458 standardisierte Metriknamen in zwölf Familien: Anlagenproduktion (powerplant), Batteriespeicher, die Alarmanlage des Standorts, 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, seine Alarmanlage 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), die Alarmanlage des Standorts 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_vendor_status | Status | Code |
| 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_external_w | Abschaltung | W |
| powerplant_max_power_by_local | Abschaltung | % |
| powerplant_battery_setpoint_external | Steuerung | % |
| powerplant_battery_setpoint_local_w | Steuerung | W |
| 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 | - |
Edge-Analytik-Metriken
Der Data Scraper berechnet eine Reihe von Analysen direkt an der Anlage und veröffentlicht sie als visualisierbare Zeitreihen neben den Rohmessungen. Dies sind die Zeitreihen hinter den Performance-Ratio-, Curtailment- und Abrechnungsfunktionen der Plattform. Die meisten Familien existieren einmal pro Einstrahlungsquelle — unten als <source> geschrieben, eine von pyranometer (Sensoren vor Ort), satellite (satellitenbasierte Einstrahlung für den Standort) oder weather (modellierte Einstrahlung aus meteorologischen Daten) — sodass jede Quelle ihre eigenen unabhängigen Zeitreihen behält und eine driftende Eingabe die anderen nie unbemerkt verfälschen kann.
Einstrahlung & modellierte Produktion
Die Einstrahlung in Modulebene, die jede Quelle sieht, und die daraus modellierte theoretische (unabgeregelte) Anlagenleistung. Ein Satz pro Quelle — insgesamt 13 Zeitreihen.
| Metriknamen-Muster | Typ | Einheit | Beschreibung |
|---|---|---|---|
powerplant_<source>_radiation_power | Einstrahlung | W/m² | Einstrahlung in Modulebene aus dieser Quelle — das Sonnenlicht, das tatsächlich auf die Module trifft. |
powerplant_<source>_radiation_energy_total | Energie | Wh/m² | Kumulierte Einstrahlung, integriert aus der obigen Zeitreihe. |
| powerplant_pyranometer_ghi_radiation_power | Einstrahlung | W/m² | Bereinigte horizontale Einstrahlung (GHI) im Anlagenmittel — nur vorhanden, wenn die Anlage horizontale Pyranometer besitzt. |
powerplant_<source>_power | Leistung | W | Theoretische Anlagenleistung, modelliert aus der Einstrahlung dieser Quelle und den Modulausrichtungen der Anlage. |
powerplant_<source>_energy_total | Energie | Wh | Kumulierte modellierte Energie. |
Performance-Ratio
Die tatsächliche Produktion im Vergleich zur modellierten Produktion — eine unabhängige PR-Spur pro Einstrahlungsquelle, auf Anlagenebene. Wie die Filter arbeiten, erfahren Sie unter Erwartete Leistung und Performance-Ratio.
| Metriknamen-Muster | Typ | Einheit | Beschreibung |
|---|---|---|---|
powerplant_<source>_pr | Performance-Ratio | - | Gemessene Produktion geteilt durch modellierte Produktion. |
powerplant_<source>_pr_filter | Filter | - | Aufschlüsselung pro Filter — welcher Qualitätsfilter (Schwachlicht, Clipping, Curtailment, Frost/Schnee/Nebel, Datenlücken) einen Zeitpunkt aus der bereinigten PR ausgeschlossen hat. |
powerplant_<source>_pr_validity | Gültigkeit | bool | 1, wenn der Zeitpunkt jeden Filter bestanden hat und in die vertrauenswürdige PR einfließt. |
Erwartete Leistung & Energie
Die PR-kalibrierte Erwartung — die modellierte Produktion, skaliert mit der realen Effizienz der Anlage. Dies ist die Baseline, an der der Komponentengesundheits-Watchdog die Live-Produktion misst.
| Metriknamen-Muster | Typ | Einheit | Beschreibung |
|---|---|---|---|
powerplant_<source>_expected_power | Leistung | W | Erwartete Anlagenleistung unter den aktuellen Bedingungen. |
powerplant_<source>_expected_energy_total | Energie | Wh | Kumulierte erwartete Energie. |
Modell & Performance-Ratio pro Komponente
Das Pendant des anlagenweiten Modells auf Komponentenebene: theoretische Leistung und PR eines einzelnen Wechselrichters, Generatoranschlusskastens (GAK) oder Strings, unter Verwendung der eigenen Ausrichtung und Spitzenleistung der Komponente. Ausgegeben für die Quellen weather und pyranometer; die Zeitreihen tragen die Identitäts-Labels der Komponente. <component> ist eines von inverter, gak, string — insgesamt 12 Zeitreihen, plus die tägliche Abschlussmarkierung.
| Metriknamen-Muster | Typ | Einheit | Beschreibung |
|---|---|---|---|
powerplant_<source>_<component>_power | Leistung | W | Modellierte Leistung einer Komponente aus der Einstrahlung dieser Quelle. |
powerplant_<source>_<component>_pr | Performance-Ratio | - | Performance-Ratio pro Komponente (nur bereinigte, gefilterte Werte). |
| powerplant_simulation_day_complete | Marker | - | Wird einmal pro Quelle und Tag gestempelt, wenn die Modell-Zeitreihen des Tages als vollständig verifiziert sind. |
Live- & Prognose-Leistungsspuren
Echtzeit- und vorausschauende Produktionsreferenzen.
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| powerplant_pyranometer_live_power | Leistung | W | PR-korrigierte erwartete Leistung in Echtzeit aus Sensoren vor Ort. |
| powerplant_satellite_live_power | Leistung | W | PR-korrigierte erwartete Leistung in Echtzeit aus Satelliten-Einstrahlung. |
| powerplant_pyranometer_live_energy_total | Energie | Wh | Kumulierte Energie der Pyranometer-Live-Spur. |
| powerplant_satellite_live_energy_total | Energie | Wh | Kumulierte Energie der Satelliten-Live-Spur. |
| powerplant_clearsky_power | Leistung | W | Theoretische Leistung bei Idealbedingungen (Clear-Sky) — die physikalische Obergrenze für einen abgeschlossenen Tag. |
| powerplant_clearsky_energy_total | Energie | Wh | Kumulierte Clear-Sky-Energie. |
| powerplant_weather_forecast_power | Leistung | W | Day-Ahead-Produktionsprognose, abgeleitet aus Wetterdaten. |
| powerplant_weather_forecast_energy_total | Energie | Wh | Kumulierte Prognoseenergie. |
| powerplant_clearsky_forecast_power | Leistung | W | Clear-Sky-Prognose — die Idealbedingungs-Obergrenze für den Prognosehorizont. |
| powerplant_clearsky_forecast_energy_total | Energie | Wh | Kumulierte Clear-Sky-Prognoseenergie. |
Curtailment
Entgangene Produktion, ihrer Ursache zugeordnet — <party> ist grid (ein Sollwert des Netzbetreibers begrenzt die Produktion) oder marketer (die Deckelung des Direktvermarkters begrenzt die Produktion). Jede Kombination wird als Momentanleistung und kumulierte Energie ausgegeben, in zwei Varianten: als abgerechnete Zeitreihe und als in Echtzeit berechnete live-Zeitreihe. Insgesamt 24 Zeitreihen.
| Metriknamen-Muster | Typ | Einheit | Beschreibung |
|---|---|---|---|
powerplant_<source>curtailment<party>_power | Leistung | W | Abgerechneter Curtailment-Verlust — entgangene Produktion aufgrund der bindenden abregelnden Partei. |
powerplant_<source>curtailment<party>_energy_total | Energie | Wh | Kumulierte abgerechnete Curtailment-Energie. |
powerplant_<source>live_curtailment<party>_power | Leistung | W | Dieselbe Zuordnung live berechnet, mit echten Zeitstempeln. |
powerplant_<source>live_curtailment<party>_energy_total | Energie | Wh | Kumulierte Live-Curtailment-Energie. |
Abrechnungsfamilien
Zeitreihen hinter Curtailment-Abrechnung und -Entschädigung. Die fixed-Familie (Pauschalverfahren) implementiert das quellenunabhängige Abrechnungsverfahren: Die Referenz ist die durchschnittlich gemessene Netzleistung der 15 Minuten vor Beginn des Curtailments, eingefroren für die gesamte Maßnahme — keine Einstrahlungseingabe nötig. Die Mischpreis-Familie bewertet Curtailment-Energie mit dem viertelstündlichen deutschen Markt-Mischpreis und liefert einen Erlöswert in EUR pro 15-Minuten-Intervall.
| Metriknamen-Muster | Typ | Einheit | Beschreibung |
|---|---|---|---|
powerplant_fixed_curtailment_<party>_power | Leistung | W | Pauschaler Curtailment-Verlust gegen die eingefrorene Referenz vor dem Curtailment. |
powerplant_fixed_curtailment_<party>_energy_total | Energie | Wh | Kumulierte pauschale Curtailment-Energie. |
| powerplant_fixed_curtailment_reference_power | Leistung | W | Die letzte gültige unabgeregelte Referenzleistung, die das Pauschalverfahren bei Curtailment-Beginn einfriert. |
powerplant_mischpreis_<variant>_<party>_revenue | Erlös | EUR | Marktwert der abgeregelten Energie pro 15-Minuten-Intervall. <variant> ist eine der obigen Curtailment-Spuren: pyranometer, satellite, weather, ihre _live-Gegenstücke oder fixed — insgesamt 14 Zeitreihen. |
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_pcs_* grid-tied Power Conversion System in front of the box
battery_box_* a BESS box / container — the DC battery
└── battery_storage_* a cabinet / rack inside the box
└── battery_module_* a module inside the cabinet
└── battery_cell_* an individual cell inside the module
Die Batteriehierarchie (box → storage → module → cell) beschreibt die DC-Batterie selbst. Das PCS (battery_pcs_*) ist der netzgekoppelte AC↔DC-Wandler vor der Box — es besitzt die AC-Seite des BESS sowie eigene Wandler-Telemetrie und wird pro Gerät durch das Label pcs identifiziert. Die Modellierung als eigene Komponente erlaubt es, die Batterie und ihren Wandler als zwei unabhängige Geräte für denselben Container zu erfassen, ohne dass ihre Zeitreihen kollidieren.
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 | % |
PCS-Ebene
Das netzgekoppelte Power Conversion System — der AC↔DC-Wandler vor der Batteriebox. Es besitzt die AC-Seite des BESS (die die DC-Batterie nie misst), dazu die eigene DC-Bus-Messung, den weitergereichten Batteriezustand und wandlerseitige Telemetrie. Ein PCS ist ein eigenständiges Gerät, identifiziert durch das Label pcs; phase unterscheidet phasenbezogene AC-Größen. Vorzeichenkonvention: positiv = Laden (Netz → Batterie); die Richtung wird aus den richtungsgetrennten Energiezählern abgeleitet, nie aus einem Status-Bit.
DC-Bus
Die eigene Sicht des Wandlers auf den DC-Zwischenkreis — der maßgebliche DC-Zustand der Batterie bleibt auf Box-Ebene.
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| battery_pcs_voltage_dc | Spannung | V | Am Wandler gemessene DC-Bus-Spannung. |
| battery_pcs_current_dc | Strom | A | DC-Strom. Vorzeichenbehaftet (+ = Laden). |
| battery_pcs_power_dc | Leistung | W | DC-Leistung. Vorzeichenbehaftet. |
AC-Seite
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| battery_pcs_voltage_ac | Spannung | V | Effektive AC-Spannung zwischen Außenleitern. |
| battery_pcs_voltage_ac__phase__L1_L2 | Spannung | V | AC-Spannung pro Phase (Außenleiter-Außenleiter). |
| battery_pcs_voltage_ac__phase__L2_L3 | Spannung | V | AC-Spannung pro Phase (Außenleiter-Außenleiter). |
| battery_pcs_voltage_ac__phase__L3_L1 | Spannung | V | AC-Spannung pro Phase (Außenleiter-Außenleiter). |
| battery_pcs_current_ac | Strom | A | Effektiver AC-Strom. |
| battery_pcs_current_ac__phase__L1 | Strom | A | AC-Strom pro Phase. |
| battery_pcs_current_ac__phase__L2 | Strom | A | AC-Strom pro Phase. |
| battery_pcs_current_ac__phase__L3 | Strom | A | AC-Strom pro Phase. |
| battery_pcs_frequency | Frequenz | Hz | AC-Frequenz. |
| battery_pcs_power_ac | Leistung | W | Wirkleistung, AC-Seite. Vorzeichenbehaftet. |
| battery_pcs_power_ac_in | Leistung | W | Wirkleistung in die Batterie (Laden aus dem Netz). Immer positiv. |
| battery_pcs_power_ac_out | Leistung | W | Wirkleistung aus der Batterie (Entladen ins Netz). Immer positiv. |
| battery_pcs_power_ac_reactive | Blindleistung | VAr | Blindleistung, AC-Seite. Vorzeichenbehaftet. |
| battery_pcs_power_factor | Leistungsfaktor | - | Leistungsfaktor (−1…1). |
Sollwerte
Nur-Lese-Sicht auf die aktiven Dispatch-Vorgaben.
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| battery_pcs_power_ac_setpoint | Sollwert | W | Wirkleistungs-Sollwert. Vorzeichenbehaftet. |
| battery_pcs_power_ac_setpoint_reactive | Sollwert | VAr | Blindleistungs-Sollwert. Vorzeichenbehaftet. |
| battery_pcs_power_factor_setpoint | Sollwert | - | Leistungsfaktor-Sollwert. |
Energiezähler
Veröffentlicht exakt so, wie die Lebensdauerzähler des Geräts sie melden — getrennte richtungsbezogene Zähler, sodass keine Vorzeichenentscheidung nötig ist.
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| battery_pcs_energy_ac_in_total | Energie | Wh | Über die Lebensdauer in die Batterie geladene AC-Energie. |
| battery_pcs_energy_ac_out_total | Energie | Wh | Über die Lebensdauer aus der Batterie entladene AC-Energie. |
Weitergereichter Batteriezustand & Wandlergrenzen
Das PCS reicht eine Zusammenfassung des Batteriemanagements weiter und meldet seine eigenen dynamischen Betriebsgrenzen. Wo das Batteriemanagementsystem direkt erfasst wird, ist battery_box_soc maßgeblich und der weitergereichte Wert redundant; an einem Standort, an dem nur das PCS erfasst wird, ist er der einzige verfügbare Ladezustand.
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| battery_pcs_soc | Ladezustand | % | Vom Batteriemanagementsystem weitergereichter Ladezustand (0–100). |
| battery_pcs_current_limit_charge | Grenzwert | A | Maximal erlaubter Ladestrom (dynamisch). |
| battery_pcs_current_limit_discharge | Grenzwert | A | Maximal erlaubter Entladestrom. |
| battery_pcs_power_limit_charge | Grenzwert | W | Maximal erlaubte Ladeleistung. |
| battery_pcs_power_limit_discharge | Grenzwert | W | Maximal erlaubte Entladeleistung. |
| battery_pcs_temperature | Temperatur | °C | Wandlertemperatur — der thermische Zustand des Wandlers, keine Batteriezellentemperatur. |
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 — sie sind nur vorhanden, wenn die AC↔DC-Wandlung physisch auf Storage-Ebene angesiedelt ist.
AC-seitiger Energiefluss
Dasselbe AC-Vokabular wie auf Box-Ebene, ohne Phasen- oder Sollwert-Varianten.
| Metrikname | Typ | Einheit |
|---|---|---|
| battery_storage_voltage_ac | Spannung | V |
| battery_storage_current_ac | Strom | A |
| battery_storage_frequency | Frequenz | Hz |
| battery_storage_power_ac | Leistung | W |
| battery_storage_power_ac_in | Leistung | W |
| battery_storage_power_ac_out | Leistung | W |
| battery_storage_power_ac_reactive | Blindleistung | VAr |
| battery_storage_energy_ac_in_total | Energie | Wh |
| battery_storage_energy_ac_out_total | Energie | Wh |
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 |
Alarmanlagen-Metriken
Die Familie alarm_* ist die Alarmmeldung des Standorts selbst. Nichts darin wird gemessen: Jeder Wert ist die Stellung eines Relaiskontakts, gelesen über die digitalen Eingänge einer Steuerung — die Relaisausgänge einer Einbruchmeldezentrale sowie die Überwachungskontakte des Kommunikationsschranks, über den die Zentrale verdrahtet ist.
Jede Serie ist ein 0/1-Messwert, normalisiert so, dass 1 immer „der Zustand liegt vor“ bedeutet (Tür offen, Alarm ausgelöst, USV im Batteriebetrieb, Automat gefallen) und 0 „normal“, unabhängig von der Polarität des Kontakts. Ein fehlender Wert ist nie eine 0: Ein Signal, das das Gerät in diesem Zyklus nicht geliefert hat, wird gar nicht veröffentlicht, und ein vom Betreiber als nicht verdrahtet erklärter Kontakt wird zurückgehalten, statt dauerhaft im Alarm zu stehen. Die Instanzkennung liegt im Label alarm — die Alarmanlage, zu der die Signale gehören — nie im Metriknamen.
Jedes Signal außer alarm_door_open öffnet außerdem für die Dauer seines Anliegens ein Parkereignis gleichen Namens; eine offene Tür ist Routine und bleibt reine Serie. Die Seite, die diese Serien speist, beschreibt Alarmanlage.
| Metrikname | Typ | Einheit | Beschreibung |
|---|---|---|---|
| alarm_door_open | Zustand | 0/1 | Die Zentrale meldet Tor oder Tür als offen. Nur Serie — nie ein Ereignis. |
| alarm_triggered | Zustand | 0/1 | Die Zentrale hat Alarm ausgelöst. |
| alarm_fault | Zustand | 0/1 | Die Zentrale meldet eine eigene Störung. |
| alarm_cabinet_ups_alarm | Zustand | 0/1 | Die USV des Kommunikationsschranks meldet eine Störung. |
| alarm_cabinet_ups_on_battery | Zustand | 0/1 | Netzversorgung ausgefallen — die USV trägt den Schrank. |
| alarm_cabinet_heating_breaker_tripped | Zustand | 0/1 | Der Leitungsschutzschalter der Schrankheizung ist gefallen. |
| alarm_cabinet_main_switch_off | Zustand | 0/1 | Der Hauptschalter des Schranks ist aus. |
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 |
SaaS-VPN
Konnektivität und Datenverkehr für den integrierten Agent-zu-Cloud-Tunnel, der den Fernzugriffs-Datenverkehr der Plattform zur Anlage transportiert.
| Metrikname | Typ | Einheit |
|---|---|---|
| agent_saas_vpn_connected | Status | bool |
| agent_saas_vpn_rx_bytes | Zähler | bytes |
| agent_saas_vpn_tx_bytes | Zähler | bytes |
VPN-Server
Wenn der Agent selbst als VPN-Server für eingehende Verbindungen agiert, melden diese Metriken den Serverzustand und jeden verbundenen Peer. Die Zeitreihen pro Peer tragen die Labels interface, peer_uid und peer_kind, sodass Dashboards Benutzerverbindungen und Standortkopplungen unterscheiden können.
| Metrikname | Typ | Einheit |
|---|---|---|
| agent_vpn_server_running | Status | bool |
| agent_vpn_server_peer_connected | Status | bool |
| agent_vpn_server_peer_rx_bytes | Zähler | bytes |
| agent_vpn_server_peer_tx_bytes | Zähler | bytes |
| agent_vpn_server_peer_last_handshake | Zeitstempel | s |
- agent_vpn_server_peer_last_handshake: Unix-Epochensekunden des letzten abgeschlossenen Handshakes des Peers;
0bedeutet, dass der Peer nie einen abgeschlossen hat. Für OpenVPN-Peers, die keinen Zeitstempel pro Handshake bereitstellen, wird der Zeitpunkt des Verbindungsaufbaus unter derselben Metrik veröffentlicht, sodass eine Abfrage beide Protokolle abdeckt.
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