MiroxMirox
  • Plattform

    • Philosophie
    • Plattform-Übersicht
    • Plattform-Ressourcen
  • Mirox-Cloud

    • Cloud-Übersicht
    • Verbundene Microservices
  • Mirox-Agent

    • Agent-Übersicht
    • Bereitstellungsoptionen
    • Data Scraper
    • Digital Twin
  • Technische Details

    • Metriksammlung
  • Information

    • Unterstützte Anlagen
  • Anlagentypen

    • Solaranlagen
    • Windanlagen
    • Batteriespeicher
    • Alarmanlage
  • Überwachung & Visualisierung

    • Echtzeit-Monitoring
    • Digitaler Zwilling
    • Komponentenzustände
    • Wechselrichter-Statuscodes
    • Wechselrichter-Ereignisse
    • Verlusterkennung
    • Leistungsgrenzen & Abregelung
    • Effizienzerkennung
    • KPI-Dashboard
  • Datenverwaltung

    • Ereignisse
    • Tickets
    • Prognosen
    • Berichte
    • Metriken
  • Integration & Freigabe

    • Kooperationen
    • API-Tokens
    • VPN
    • VPN-Adresskonflikte
    • Proxy
  • KI

    • KI-Assistent & Wizards
    • Agentischer Zugriff (MCP)
  • Abrechnung

    • Markt & Tarife
    • Buchhaltung & Abrechnung
  • Kollaboration

    • Einladungen
  • Sicherheit

    • Authentifizierung
    • Kontosperre
    • Berechtigungssystem
    • Netzsegmentierung
    • Kooperationsbeschränkungen
    • Zugriffs-Audit-Logging
    • Aktivität & Audit-Trail
  • Knoten

    • mrxnode
  • Anwendung

    • Türsteuerung
    • Generisches Relais
  • Edge-Cluster

    • Orchestrierung
  • Erste Schritte

    • Onboarding
    • Einrichtung
  • Persönlich

    • VPN verwenden
    • Proxy verwenden
    • Zwei-Faktor-Authentifizierung
    • Sitzungen
    • API-Tokens
    • Benachrichtigungen
    • Microsoft Teams verbinden
  • Pro Anlage

    • Kontakte
    • Netzwerkgeräte
    • Datenlogger
    • Komponenten
    • Direktes VPN (pro Agent)
    • Datenvolumen
    • Historie importieren
  • Organisation

    • Mitgliederberechtigungen
    • Kooperationen
    • Dateispeicher
    • VPN-Dienste
    • Mit Berichten arbeiten
  • Datenexport

    • Metric Export
    • Metric-Export-API
    • Umstieg auf den Metric Export
    • Legacy-Export-API
    • Externe Berichterstellung
    • Grafana
    • Grafana-Dashboards
    • API-Überblick
    • MiroxQL-Formeln (API)
  • Unterstützung

    • Eine Integration anfragen
  • mrxnode

    • Übersicht
    • Anleitungen
    • Container-Bereitstellung
    • Befehlsreferenz
    • Fehlerbehebung
  • Berichterstellung

    • Externer Berichtgenerator
    • Metric Export für Excel
  • Fernzugriff
  • KI in Mirox
  • Historie importieren
  • Berichte
  • Daten-Export
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Plattform

    • Philosophie
    • Plattform-Übersicht
    • Plattform-Ressourcen
  • Mirox-Cloud

    • Cloud-Übersicht
    • Verbundene Microservices
  • Mirox-Agent

    • Agent-Übersicht
    • Bereitstellungsoptionen
    • Data Scraper
    • Digital Twin
  • Technische Details

    • Metriksammlung
  • Information

    • Unterstützte Anlagen
  • Anlagentypen

    • Solaranlagen
    • Windanlagen
    • Batteriespeicher
    • Alarmanlage
  • Überwachung & Visualisierung

    • Echtzeit-Monitoring
    • Digitaler Zwilling
    • Komponentenzustände
    • Wechselrichter-Statuscodes
    • Wechselrichter-Ereignisse
    • Verlusterkennung
    • Leistungsgrenzen & Abregelung
    • Effizienzerkennung
    • KPI-Dashboard
  • Datenverwaltung

    • Ereignisse
    • Tickets
    • Prognosen
    • Berichte
    • Metriken
  • Integration & Freigabe

    • Kooperationen
    • API-Tokens
    • VPN
    • VPN-Adresskonflikte
    • Proxy
  • KI

    • KI-Assistent & Wizards
    • Agentischer Zugriff (MCP)
  • Abrechnung

    • Markt & Tarife
    • Buchhaltung & Abrechnung
  • Kollaboration

    • Einladungen
  • Sicherheit

    • Authentifizierung
    • Kontosperre
    • Berechtigungssystem
    • Netzsegmentierung
    • Kooperationsbeschränkungen
    • Zugriffs-Audit-Logging
    • Aktivität & Audit-Trail
  • Knoten

    • mrxnode
  • Anwendung

    • Türsteuerung
    • Generisches Relais
  • Edge-Cluster

    • Orchestrierung
  • Erste Schritte

    • Onboarding
    • Einrichtung
  • Persönlich

    • VPN verwenden
    • Proxy verwenden
    • Zwei-Faktor-Authentifizierung
    • Sitzungen
    • API-Tokens
    • Benachrichtigungen
    • Microsoft Teams verbinden
  • Pro Anlage

    • Kontakte
    • Netzwerkgeräte
    • Datenlogger
    • Komponenten
    • Direktes VPN (pro Agent)
    • Datenvolumen
    • Historie importieren
  • Organisation

    • Mitgliederberechtigungen
    • Kooperationen
    • Dateispeicher
    • VPN-Dienste
    • Mit Berichten arbeiten
  • Datenexport

    • Metric Export
    • Metric-Export-API
    • Umstieg auf den Metric Export
    • Legacy-Export-API
    • Externe Berichterstellung
    • Grafana
    • Grafana-Dashboards
    • API-Überblick
    • MiroxQL-Formeln (API)
  • Unterstützung

    • Eine Integration anfragen
  • mrxnode

    • Übersicht
    • Anleitungen
    • Container-Bereitstellung
    • Befehlsreferenz
    • Fehlerbehebung
  • Berichterstellung

    • Externer Berichtgenerator
    • Metric Export für Excel
  • Fernzugriff
  • KI in Mirox
  • Historie importieren
  • Berichte
  • Daten-Export
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Erste Schritte

    • Onboarding
    • Einrichtung
  • Persönlich

    • Das VPN nutzen
    • Proxy nutzen
    • Zwei-Faktor-Authentifizierung einrichten
    • Ihre Sitzungen verwalten
    • API-Tokens
    • Benachrichtigungen
    • Microsoft Teams verbinden
  • Pro Anlage

    • Anlagenkontakte verwalten
    • Netzwerkgeräte verwalten
    • Datenlogger konfigurieren
    • Komponenten konfigurieren
    • VPN-Server pro Agent konfigurieren (Direkt-VPN)
    • Datenvolumen pro Anlage
    • Historie einer Anlage importieren
  • Organisation

    • Mitgliederberechtigungen verwalten
    • Kooperationen erstellen
    • Die Datei-Ablage nutzen
    • Organisations-VPN-Dienste
    • Mit Berichten arbeiten
  • Datenexport

    • Metric Export
    • Metric-Export-API
    • Umstieg auf den Metric Export
    • Legacy-Export-API
    • Externe Berichtserstellung
    • Grafana als externe Read-Plattform nutzen
    • Eigene Grafana-Dashboards erstellen
    • API-Übersicht
    • MiroxQL-Formeln (API-Referenz)
  • Unterstützung

    • Eine Integration anfragen
  • mrxnode

    • mrxnode Übersicht
    • mrxnode Anleitung
    • Container-Bereitstellung
    • mrxnode Befehls-Spickzettel
    • Fehlerbehebung

Metric Export

Die Seite Daten-Export exportiert jede Metrik Ihrer Anlagen als Zeitreihe: von der Einspeisung eines ganzen Portfolios bis zu einem einzelnen Einstrahlungssensor, einer Turbine oder einer Batteriezelle. Sie wählen die Anlagen, die Metriken, den Zeitraum und die Schrittweite, prüfen die Vorschau und laden eine CSV-Datei herunter. Jeder Export ist zugleich ein Link, den Sie an Excel oder ein Skript übergeben können.

In Mirox öffnen

Daten-Export ▸ Metriken — öffnen Sie Daten-Export in der Hauptnavigation. Die Seite öffnet auf dem Tab Metriken.

Diese Anleitung behandelt die Seite selbst. Die Parameter hinter jedem Export-Link beschreibt die Metric-Export-API.

Eine Metriksammlung

Der Export und die Berichte lesen dieselbe Metriksammlung. Eine Metrik hat einen Namen, eine Einheit und eine Definition, wo immer Sie ihr begegnen: in der Datenauswahl des Berichts, im fertigen Bericht und in einer exportierten Datei.

Die Sammlung enthält:

  • die Metriken, die Mirox mitliefert, geordnet nach Ebene — Anlage, Wechselrichter, Generatoranschlusskasten, String, Batterie, Windturbine, Sensor, Zähler, Wetter, Markt und weitere. Die Ebenen sind unter Verfügbare Metriken aufgeführt;
  • die Metriken, die Ihre Organisation unter Metriken selbst definiert hat. In der Auswahl sind sie als Meine Metriken gruppiert.

Eine Metrik, die unter Meine Metriken als Nicht validiert gekennzeichnet ist, lässt sich erst exportieren, wenn ihr Ausdruck die Prüfung besteht.

Die drei Tabs

TabWas Sie dort tun
MetrikenAnlagen, Metriken, Zeitraum und Schrittweite wählen, die Vorschau ansehen und die Datei herunterladen.
VorlagenEine Auswahl von Metriken als Vorlage aufbewahren, die von Mirox mitgelieferten Vorlagen nutzen und ältere Vorlagen umwandeln.
API-BuilderEine Vorlage und Anlagen wählen und den Link für Excel, ein Skript oder ein anderes Werkzeug erhalten.

Metriken exportieren

1. Anlagen wählen

Öffnen Sie unter Anlagen die Anlagenliste und haken Sie eine oder mehrere Anlagen an; die Portfolioliste daneben fügt ganze Portfolios hinzu. Die Listen sind dieselben wie in der Navigation links: Jede Zeile trägt den Typ der Anlage — Solar, Wind oder Batterie —, und Ihre Auswahl erscheint als Chips im Feld. Anlagen und Portfolios lassen sich mischen; eine Anlage, die auch in einem gewählten Portfolio liegt, wird einmal exportiert. In einer Datei exportieren Sie höchstens 50 Anlagen. Bei mehr als einer Anlage wählen Sie außerdem, ob die Anlagen zu einer Spalte je Metrik zusammengefasst oder nebeneinander gezeigt werden — siehe Mehrere Anlagen. Anlagen in verschiedenen Zeitzonen stellen die Datei auf UTC — siehe Ortszeit der Anlage und UTC.

2. Metriken hinzufügen

Tippen Sie unter Metriken in das Suchfeld, was Sie suchen — einen Namen, ein Wort der Beschreibung, eine Komponente oder eine Einheit, zum Beispiel Wechselrichter DC. Jedes getippte Wort muss irgendwo in einer Metrik vorkommen: im Namen, in der ID, in den IDs des bisherigen Exports, in der Einheit, der Ebene oder der Beschreibung. Die besten Treffer stehen oben: eine Metrik, deren Name mit Ihren Wörtern beginnt, vor einer, die sie nur in der Beschreibung erwähnt. Enter fügt den ersten Treffer hinzu, die Pfeiltasten bewegen die Auswahl, und Alle Metriken anzeigen öffnet die ganze Sammlung nach Ebene, mit derselben Suche. energy_grid_daily findet Netzeinspeisung, eine ID aus einem alten Link funktioniert also ebenfalls. (Die App nennt Kennzahlen durchgehend Metriken.)

Jede Zeile sagt, was die Metrik misst und in welchen Schrittweiten sie gelesen werden kann. Eine Zeile, die Sie nicht wählen können, nennt den Grund:

Angezeigter GrundBedeutung
Noch nicht gemessenMirox hat die Metrik geplant, liefert sie aber noch nicht.
Entwurf — zuerst unter Meine Metriken validierenDie Metrik Ihrer Organisation ist als Nicht validiert gekennzeichnet.
Braucht Zugriff auf die BuchhaltungDie Metrik ist ein Geldwert, und Ihnen fehlt die Buchhaltungsberechtigung auf den gewählten Anlagen.
An den gewählten Anlagen nicht gemessenKeine der gewählten Anlagen hat die Ausstattung, zum Beispiel eine Batterie-Metrik an einer Anlage ohne Batterie.
In der gewählten Schrittweite nicht verfügbarSie haben eine Schrittweite festgelegt, die die Metrik nicht bedient. Wählen Sie eine andere Schrittweite oder stellen Sie die Schrittweite zurück auf automatisch.

Ein Export enthält höchstens 20 Metriken. Die gewählten Metriken stehen unter der Suche in der Reihenfolge der Spalten; ziehen Sie eine Zeile, um sie zu ändern. Erklärungen über der Liste öffnet eine Beschreibung jeder gewählten Metrik: Einheit, wie oft sie gemessen wird, welche Schrittweiten und Werte sie anbietet und wie mehrere Anlagen zusammengefasst werden. Glossar herunterladen (CSV) gibt Ihnen dort die ganze Sammlung als Datei.

Hat die Sammlung keine Metrik für das, was Sie brauchen, öffnet Metrik erstellen den Metrik-Editor der Seite Berichte; Zurück zum Datenexport oben im Editor bringt Sie mit den Anlagen, Metriken und dem Zeitraum zurück, die Sie hatten. Für eine einmalige Abfrage der Zeitreihendatenbank fügen Sie stattdessen eine MetricsQL-Abfrage hinzu.

3. Komponenten wählen

Eine Metrik einer Komponentenebene — Wechselrichter, Generatoranschlusskasten, String, Windturbine, Sensor, Zähler, Batteriecontainer, Rack, Modul, Zelle oder Umrichter — exportiert eine Spalte je Komponente. Ohne Auswahl erhalten Sie alle Komponenten der Anlage, 50 je Seite. Um den Export einzuschränken, öffnen Sie die Komponenten-Schaltfläche an der Metrik und wählen die benötigten Komponenten, bis zu 100.

So exportieren Sie jeden Einstrahlungssensor einzeln, ohne Mittelung: Fügen Sie Einstrahlung je Sensor hinzu und lassen Sie die Komponentenauswahl leer.

Ausgeblendete Komponenten werden ausgelassen. Ausgeblendete zeigen im Komponentendialog listet sie auf, sodass Sie eine davon gezielt wählen können.

4. Zeitraum festlegen

Wählen Sie unter Zeitraum und Schrittweite eine Voreinstellung oder legen Sie Beginn und Ende selbst fest. Die Voreinstellungen sind Heute, Gestern, Letzte 7 Tage, Letzte 30 Tage, Diese Woche, Vorwoche, Dieser Monat, Vormonat, Dieses Quartal, Vorquartal, Dieses Jahr und Vorjahr. Ohne Auswahl umfasst der Export den Vormonat.

Ein Zeitraum darf frühestens 2020 beginnen und höchstens fünf Jahre umfassen. Ein Zeitraum, der in die Zukunft reicht, endet jetzt.

5. Schrittweite wählen

Die Schrittweite ist die Länge einer Zeile: 1 min, 5 min, 15 min, 1 h, Tag, Woche, Monat, Quartal oder Jahr. Bleibt sie auf automatisch, wählt Mirox eine Schrittweite, die jede gewählte Metrik bedient und die zum Zeitraum passt: 15 Minuten bis zu zwei Tagen, eine Stunde bis zu zwei Monaten, ein Tag bis zu drei Jahren, darüber ein Monat.

Nicht jede Metrik lässt sich in jeder Schrittweite lesen — siehe Schrittweiten und ihre Grenzen. Eine Metrik, die die gewählte Schrittweite nicht bedient, wird trotzdem exportiert, in ihrer eigenen Schrittweite — siehe Metriken mit verschiedenen Schrittweiten. Nur eine Schrittweite, in der eine Metrik gar keine Zeile haben könnte, ist ausgegraut und nennt diese Metrik.

6. Werte wählen

Für eine Energie oder eine andere gezählte Größe wählen Sie unter Werte, ob jede Zeile die Menge Je Intervall oder die Laufende Summe seit Beginn des Zeitraums zeigt. Alle anderen Metriken werden Wie gemessen exportiert, und die Liste sagt, wie jede Zeile gebildet wird — siehe Werte.

7. Zeitzone wählen

Ortszeit der Anlage ist die Voreinstellung; UTC ist die Alternative. Siehe Ortszeit der Anlage und UTC.

8. Vorschau prüfen und herunterladen

Die Vorschau zeigt den Export als Diagramm oder als Tabelle. Unter dem Zeitraum nennt eine Zeile die Größe: Zeilen, Spalten, die ungefähre Dateigröße und Dauer. Hinweise unter der Vorschau sagen Ihnen, was Mirox von sich aus getan hat, zum Beispiel dass ein Zeitraum auf ganze Tage erweitert wurde.

Im Diagramm:

  • Das Auge am Anfang jeder Metrik- und Abfragezeile blendet ihre Serie in Diagramm und Tabelle aus und wieder ein. Eine ausgeblendete Serie bleibt im Download und im Link; die Einstellung ist Teil der Seitenadresse, ein geteilter Link zeigt also dieselbe Ansicht.
  • Ein Klick auf einen Namen in der Legende tut dasselbe; Umschalt-Klick zeigt nur diese Serie. Legende und Augen stimmen immer überein.
  • Ziehen Sie über das Diagramm, um in einen Bereich hineinzuzoomen; ein Doppelklick zoomt wieder heraus. Der Zoom ändert nur die Ansicht.
  • Der Tooltip listet bis zu zehn Serien, der größte Wert zuerst, und sagt, wie viele weitere es gibt.
  • Ein langer Zeitraum in feiner Schrittweite hat mehr Punkte, als ein Browser zeichnen kann. Das Diagramm zeigt dann eine gröbere Auflösung und sagt das in einem orangen Hinweis — Das Diagramm zeigt die Auflösung 1 h, damit es lesbar bleibt; Tabelle und Export behalten 1 min — oder fasst, wo keine gröbere Schrittweite angeboten wird, mehrere Zeilen zu einem Punkt zusammen. Tabelle, Download und Link behalten immer die gewählte Schrittweite.

Wählen Sie unter Exportoptionen das CSV-Trennzeichen, das Dezimaltrennzeichen, das Zeitstempelformat, die Sprache der Spaltennamen und die Spaltenköpfe: Namen (für Menschen) oder IDs (für Skripte). Das Zeitstempelformat ändert auch die Daten in der Tabelle, die Vorschau zeigt also, was die Datei enthalten wird. Danach:

  • CSV herunterladen speichert die Datei.
  • API-URL kopieren kopiert denselben Export als Link. Ausprobieren bereitet ein API-Token vor und gibt fertige Befehle für das Terminal und für Python.
  • Als Vorlage speichern bewahrt die Auswahl als Vorlage auf.

MetricsQL-Abfragen

Neben den Metriken der Sammlung nimmt der Tab Metriken rohe Abfragen in MetricsQL an, der Abfragesprache der Zeitreihendatenbank der Plattform — der Sprache, die auch die Metriken Ihrer Organisation und Grafana verwenden. Eine Abfrage ist für das gedacht, wofür die Sammlung keine Metrik hat: eine Serie, die die Datenbank führt, eine Kombination von Serien, eine Funktion darauf.

  1. Klicken Sie unter den Metriken auf MetricsQL, um das Abfragefeld zu öffnen.
  2. Tippen Sie die Abfrage, zum Beispiel sum by (inverter_id) (powerplant_inverter_power_ac). Während Sie tippen, schlägt das Feld Seriennamen, Labels und Funktionen vor; Tab übernimmt den Vorschlag. Enter führt die Abfrage aus und fügt sie als Zeile hinzu; Umschalt+Enter beginnt eine neue Zeile innerhalb der Abfrage.
  3. Die Zeile zeigt den Abfragetext auf einem Code-Hintergrund und den Chip MetricsQL dort, wo eine Metrik ihre Einheit zeigt. Die Spalten der Zeile sind eine je Serie, die die Abfrage liefert, wie gemessen. Der Stift macht den Text an Ort und Stelle bearbeitbar: Enter speichert, Esc bricht ab. Sonst ändert sich an der Zeile nichts.

Was eine Abfrage tut und was nicht:

  • Mirox fügt die gewählte Anlage in jeden Selektor der Abfrage ein, die Abfrage nennt also nie eine Anlage, einen Park oder eine Organisation. Eine Abfrage mit einem solchen Label wird abgelehnt, und das Label wird genannt.
  • Eine Abfrage wird in der gewählten Schrittweite gelesen — jede Schrittweite von 1 min bis Jahr —, so wie ein Dashboard sie lesen würde: Rohwerte in dieser Schrittweite, kein Wertemodus, keine Zusammenfassung. Je Intervall und Laufende Summe gelten für sie nicht.
  • Bei mehreren Anlagen erhält jede Anlage ihre eigenen Spalten. Abfragen werden nie über Anlagen zusammengefasst.
  • Eine Abfrage darf an einer Anlage höchstens 500 Serien liefern; fassen Sie sie zusammen, etwa mit sum by (…), wenn es mehr sind. Ein Export enthält höchstens 5 Abfragen mit je bis zu 4 000 Zeichen, und die gelieferten Serien zählen wie jede andere Spalte gegen die Größengrenzen.
  • In der Datei trägt die Spalte den Kopf MetricsQL, gefolgt von der Abfrage und, wenn die Abfrage mehrere Serien liefert, von den Labels jeder Serie: MetricsQL sum by (inverter_id) (powerplant_inverter_power_ac) {inverter_id="INV1"}. Mit IDs (für Skripte) lautet der Kopf expr1, expr2, … mit denselben Labels. Eine Datei mit Abfragen ist also an ihrer ersten Zeile von einem gewöhnlichen Export zu unterscheiden.
  • Eine Abfrage wird nicht in einer Vorlage gespeichert. Entfernen Sie die Abfragen, um die Metriken als Vorlage zu speichern, oder definieren Sie die Größe einmal als Metrik Ihrer Organisation: Dann ist sie validiert, hat Namen und Einheit und steht auch den Berichten zur Verfügung.

Schrittweiten und ihre Grenzen

Welche Schrittweiten eine Metrik anbietet, hängt davon ab, was sie ist und wie oft sie gemessen wird:

Art der MetrikSchrittweitenAnmerkung
Energie aus einem Zähler, der jede Minute zählt — Einspeisung, Wechselrichter-Erzeugung, Batterieenergie1 min bis Jahr
Energie, die seltener gezählt wird — Windturbinen, abgerechnete Abregelung15 min bis Jahr
Leistung — W, var, VA, W/m²1 min, 5 min und 15 minBei einer Stunde oder länger nicht angeboten. Nutzen Sie für Tages- oder Monatswerte die passende Energie-Metrik.
Spannung, Strom, Frequenz, Leistungsfaktor1 min, 5 min und 15 min
Temperatur, Ladezustand, Windgeschwindigkeit, Luftfeuchtigkeitvom Messintervall bis JahrEine längere Schrittweite zeigt den Mittelwert.
Betriebszustand, Statuscode15 minDer Wert zu Beginn jedes Intervalls.
Performance RatioTag, Woche, Monat, Quartal, Jahr
Verfügbarkeit15 min, 1 h, Tag, Woche, Monat, Quartal, Jahr
Metriken Ihrer Organisationvon ihrer Feinsten Auflösung bis JahrNie feiner als 15 Minuten.

Eine Metrik wird nie feiner angeboten, als sie gemessen wird: Eine Windturbine, die alle 10 Minuten meldet, hat keine 1-Minuten-Werte.

Die Schrittweite begrenzt auch den Zeitraum, denn eine Spalte enthält höchstens 180 000 Werte:

SchrittweiteLängster Zeitraum
1 min125 Tage
5 min625 Tage
15 min und länger5 Jahre

Schrittweiten von einem Tag oder länger umfassen immer ganze Tage, Wochen, Monate, Quartale oder Jahre. Ein Zeitraum, der innerhalb eines solchen Intervalls beginnt oder endet, wird auf das ganze Intervall erweitert, und ein Hinweis sagt das. Wochen beginnen am Montag.

Metriken mit verschiedenen Schrittweiten

Nicht jede Metrik bedient jede Schrittweite, und manche bedienen nur grobe: Die Performance Ratio beginnt beim Tag, ein Marktwert gibt es einmal je Monat. Der Tab Metriken bringt sie trotzdem in eine Datei:

  • Eine Metrik mit einer gröberen Schrittweite als die Datei behält ihre eigene Schrittweite. Ihr Wert steht in der ersten Zeile jedes ihrer Intervalle — der Wert eines Tages in der Zeile seiner Mitternacht, der eines Monats in der Zeile seines ersten Tages —, und die Zeilen dazwischen bleiben leer. Das Diagramm zeigt eine solche Metrik als Punkte. Ein oranger Hinweis über der Vorschau nennt diese Metriken mit ihren Schrittweiten und bietet Getrennt exportieren an: ein Link je Schrittweite, jede Metrik in ihrer eigenen Auflösung.
  • Eine Metrik, die nur feinere Schrittweiten bedient, wird in der gröbsten davon gelesen und nach der Regel ihrer Größe auf die Schrittweite der Datei zusammengefasst: Eine Energie wird addiert, ein Messwert gemittelt, ein Verhältnis aus seinen Hälften neu berechnet, ein Zustand behält seinen letzten Code. Ein Hinweis unter der Vorschau sagt das.
  • Zwei Fälle bleiben abgelehnt: Ein Wert je Monat, Quartal oder Jahr hat in einer Wochen-Datei keine Zeile, und ein Monatswert wie der Marktwert wird nie zu einem Quartal oder Jahr addiert oder gemittelt, weil das nicht dieser Wert wäre. Eine solche Schrittweite bleibt ausgegraut und nennt die Metrik.

Eine Vorlage entscheidet mit Metriken mit anderem Schritt selbst: Tolerant verhält sich wie der Tab Metriken, Strikt lehnt einen Link ab, der eine Schrittweite nennt, die eine ihrer Spalten nicht bedient. Eine vom Tab Metriken gespeicherte oder neu erstellte Vorlage ist tolerant; Vorlagen aus der Zeit vor dieser Einstellung sind strikt. Ein von Hand geschriebener Export-Link ist strikt, sofern er nichts anderes sagt — siehe den Parameter mismatch.

Werte: Je Intervall, Laufende Summe, Wie gemessen

WerteWas eine Zeile zeigtAngeboten für
Je IntervallDie Menge innerhalb des Intervalls, zum Beispiel die in jeweils 15 Minuten erzeugte Energie.Nur Energie
Laufende SummeDie Summe seit Beginn des Zeitraums. Eine Zeile ohne Daten bleibt leer, und die Summe läuft weiter.Energie und andere gezählte Größen wie Sonnenstunden, Niederschlag oder Geld
Wie gemessenDer Wert, wie die Metrik ihn liefert: je nach Metrik der Mittelwert, der letzte Wert oder der Anteil am Intervall.Alles

Je Intervall wird nur für Energie angeboten. Eine Leistung, eine Temperatur oder ein Verhältnis hat keine „Menge je Intervall“, deshalb werden diese immer wie gemessen exportiert.

Die Warnung unter 15 Minuten

Ein Zähler zählt Energie in ganzen Schritten, oft 1 kWh. Innerhalb einer Minute erzeugt eine Anlage selten einen ganzen Schritt, daher springt eine Energie je Intervall bei 1 oder 5 Minuten zwischen null und einem Schritt, statt eine Kurve zu zeichnen. Mirox warnt, wenn Sie beides kombinieren, und bietet drei Auswege:

  • Zu … wechseln — zur passenden Leistungs-Metrik, sofern die Sammlung eine hat. Leistung ist die richtige Größe für eine feine Kurve.
  • 15 min verwenden, die feinste Schrittweite, in der sich eine Energie je Intervall gut liest.
  • Beibehalten, wenn Sie genau die Zählerschritte sehen möchten.

Ortszeit der Anlage und UTC

Zeilen folgen der Ortszeit der Anlage, einschließlich der Sommerzeit. Ein Tag ist ein lokaler Tag, er hat bei der Zeitumstellung also 23 oder 25 Stunden, und ein Monat ist ein lokaler Monat.

  • Bei Schrittweiten unter einem Tag steht neben der Zeit eine Spalte UTC-Versatz. Am Tag, an dem die Uhren zurückgestellt werden, erscheint die Stunde zwischen 02:00 und 03:00 zweimal; der Versatz unterscheidet die beiden.
  • UTC als Zeitzone legt alle Zeilen auf den UTC-Kalender. Nutzen Sie das, wenn die Datei in ein System geht, das UTC erwartet.
  • Anlagen in verschiedenen Zeitzonen teilen sich eine Zeitspalte, daher ist ein solcher Export immer in UTC. Die Wahl der Zeitzone ist dann gesperrt und nennt den Grund.

Mehrere Anlagen: zusammengefasst oder je Anlage

Bei mehr als einer Anlage wählen Sie zwischen einer Spalte je Metrik für alle Anlagen gemeinsam und einer Spalte je Anlage.

Zusammengefasst folgt jede Metrik ihrer eigenen Regel:

MetrikZusammengefasster Wert
Energie, gezählte Größen, Leistungüber die Anlagen addiert
Einstrahlung, Temperatur, Ladezustand und andere gemessene Pegelüber die Anlagen gemittelt
Verhältnisse wie die Performance Ratio oder die Verfügbarkeitaus den Summen der Anlagen neu berechnet, nie ein Mittelwert von Prozentwerten
Preiseder gemeinsame Wert, wenn alle Anlagen in derselben Marktzone liegen
Zustände und Statuscodesje Anlage gezeigt, weil sie sich nicht zusammenfassen lassen

Komponenten-Metriken werden immer je Anlage gezeigt. Ein Hinweis unter der Vorschau nennt jede Metrik, die je Anlage statt zusammengefasst gezeigt wurde.

Vorlagen

Eine Vorlage ist eine gespeicherte Liste von Metriken mit eigenen Voreinstellungen: Schrittweite, Zeitraum, Werte, Zeitzone, zusammengefasst oder je Anlage, und Spaltenköpfe. Jede Spalte kann einen eigenen Spaltennamen tragen, sodass die Datei ihre Spaltenköpfe behält, auch wenn eine Metrik später umbenannt wird.

In Mirox öffnen

Daten-Export ▸ Vorlagen

Systemvorlagen

Mirox liefert acht Vorlagen mit, gekennzeichnet mit System. Sie lassen sich weder ändern noch löschen.

VorlageInhaltSchrittweite
Standard-ExportNetzeinspeisung, Abregelungsverluste, Einstrahlung vom Pyranometer und aus dem Wettermodell, Logger-Verfügbarkeit, SonnenstundenTag
Erweiterter ExportDieselben Spalten wie der Standard-ExportTag
Erweiterter Export (Wechselrichter-Verfügbarkeit)Standard-Export und zusätzlich die Wechselrichter-VerfügbarkeitTag
Export EnergieverfügbarkeitStandard-Export und zusätzlich die Wechselrichter-VerfügbarkeitTag
Technischer BerichtEinspeisung, Einstrahlung, Verfügbarkeit, Abregelungsverluste, erwartete Erzeugung, Performance Ratio und spezifischer ErtragTag
WindturbinenEnergie, Windgeschwindigkeit und Laufzeit je Turbine, die Turbinensumme und die abgerechnete NetzabregelungTag
BatteriespeicherGeladene und entladene Energie, Ladezustand, Gesundheitszustand und ZyklenzahlTag
EinstrahlungssensorenEinstrahlung und Einstrahlungsenergie jedes Sensors und die Pyranometer-Einstrahlung der Anlage, über den gestrigen Tag15 min

Die ersten fünf lösen die Vorlagen des bisherigen Exports ab. Ihre IDs und Spalten stehen im Leitfaden zum Umstieg.

Ihre eigenen Vorlagen

Als Vorlage speichern auf dem Tab Metriken oder Vorlage erstellen auf dem Tab Vorlagen speichert Ihre Auswahl für die ganze Organisation. Eine Vorlage enthält bis zu 40 Metriken und keine MetricsQL-Abfragen. In Metriken öffnen lädt eine Vorlage in den Tab Metriken. Metriken mit anderem Schritt entscheidet, was ein Link der Vorlage mit einer Spalte tut, die die angeforderte Schrittweite nicht bedient — siehe Metriken mit verschiedenen Schrittweiten.

Vorlagen werden von der Organisationsrolle Admin erstellt, geändert, umgewandelt und gelöscht. Jeder in der Organisation kann sie nutzen.

Eine Metrik Ihrer Organisation, die eine Vorlage verwendet, kann weder gelöscht werden noch eine neue ID erhalten. Ist eine Metrik einer Vorlage nicht mehr verfügbar — etwa weil sie auf Nicht validiert zurückgefallen ist —, bleibt ihre Spalte leer in der Datei, sodass sich die Positionen der übrigen Spalten nicht verschieben.

Legacy-Vorlagen und Umwandlung

Eine Vorlage, die vor dem Metric Export erstellt wurde, ist mit Legacy gekennzeichnet. Sie basiert auf dem bisherigen Metriksatz, und ihr Link funktioniert unverändert weiter. Neue Vorlagen basieren immer auf der Metriksammlung.

In neue Vorlage umwandeln erstellt aus einer Legacy-Vorlage eine neue Vorlage. Die Legacy-Vorlage wird nie verändert, Dateien und Links, die sie verwenden, bleiben also, wie sie sind.

  1. Mirox zeigt, welche Spalten eine Entsprechung haben, ob die Zahlen dieselben sind (Exakt) oder dieselbe Größe auf bessere Weise gelesen wird (Annähernd), und welche Spalten keine Entsprechung haben.
  2. Sie geben der neuen Vorlage einen Namen und bestätigen.
  3. Beide Links werden angezeigt. Excel nutzt weiter den alten Link, bis Sie ihn ersetzen.

Eine umgewandelte Vorlage exportiert Tage, wie ihre Quelle. Eine Spalte, deren Metrik keinen Tageswert hat — zum Beispiel Frequenz oder Leistungsfaktor —, wird nicht übernommen; der Dialog nennt die Metrik, damit Sie sie auf dem Tab Metriken exportieren können.

API-Builder

In Mirox öffnen

Daten-Export ▸ API-Builder

Wählen Sie eine Vorlage und die Anlagen und passen Sie Zeitraum, Schrittweite und Dateiformat an, falls die Voreinstellungen der Vorlage nicht passen. Die Seite zeigt den Link und eine Vorschau der Daten. Ausprobieren bereitet ein API-Token und fertige Befehle für diesen Link vor. Bei einer Legacy-Vorlage zeigt der Builder den bisherigen Link und bietet die Umwandlung an.

Ein Link mit einer Voreinstellung wie Vormonat liefert immer den jüngsten vollständigen Zeitraum — genau das, was eine Arbeitsmappe braucht, die sich selbst aktualisiert. Siehe Excel mit Power Query.

Wenn ein Export zu groß ist

Mirox prüft die Größe eines Exports, bevor Daten gelesen werden. Ist der Export zu groß, wird nichts exportiert, und die Meldung bietet an, was passen würde: eine gröbere Schrittweite oder einen kürzeren Zeitraum mit der Zahl der Tage.

GrenzeWert
Anlagen50
Metriken20 auf dem Tab Metriken, 40 in einer Vorlage
MetricsQL-Abfragen5, jede mit höchstens 500 Serien je Anlage
Komponenten je Metrik und Seite50, höchstens 100
Spalten400
Werte je Spalte180 000
Werte insgesamt1 800 000

Um mehr zu exportieren, teilen Sie den Export auf:

  • nach Zeit — eine Datei je Monat oder je Quartal statt einer je Jahr;
  • nach Anlage — eine Datei je Anlage oder je Portfolio;
  • nach Metrik — Komponenten-Metriken in einer eigenen Datei, getrennt von den Anlagen-Metriken;
  • nach Seite — bei einer Anlage mit vielen Komponenten exportieren Sie die Komponenten Seite für Seite.

Metriken, die Mirox aus mehreren Quellen ermitteln muss, wie Produktion (aufgelöst), kosten mehr als ein einfacher Zählerstand. Eine Vorlage, die eine solche Metrik enthält, erreicht weniger Anlagen und Monate je Datei. Die Größenzeile unter dem Zeitraum sagt es Ihnen, bevor Sie herunterladen.

Wer was exportieren kann

  • Sie exportieren die Anlagen, deren Messwerte Sie lesen dürfen: die Funktionsrollen Betreiber, Technische Betriebsführung, Kaufmännische Betriebsführung und Betrachter. Eine Anlage, die Sie nicht lesen können, wird ausgelassen, und ein Hinweis nennt sie.
  • Geld-Metriken brauchen zusätzlich die Buchhaltungsberechtigung, die die Funktionsrollen Betreiber und Kaufmännische Betriebsführung haben. Ohne sie bleibt die Spalte für diese Anlage leer.
  • Die Metriken Ihrer Organisation werden auf jeder Anlage exportiert, die Sie lesen können, einschließlich der Anlagen, die über eine Kooperation mit Ihnen geteilt werden. Sie stehen jeder Organisationsrolle außer Extern zur Verfügung.
  • Außerhalb des Browsers liest ein API-Token der Gruppe Metric Export jeden Export. Es kann nichts ändern.

Alte Links und Lesezeichen

Links auf den bisherigen Tab Rohdaten und auf den bisherigen Tab Metriken funktionieren weiter: Sie öffnen den Tab Metriken mit denselben Anlagen, Metriken, demselben Zeitraum und derselben Schrittweite. Hat eine Metrik keine Entsprechung, sagt das ein Banner und bietet Ursprüngliche API-URL kopieren an, die sie weiterhin liefert. Ein Link auf eine der fünf früheren Systemvorlagen öffnet deren Nachfolger.

Formeln werden nicht mehr in der App bearbeitet. Siehe MiroxQL-Formeln.

Verwandte Funktionen

  • Metric-Export-API — jeder Parameter, jeder Fehler und jede Grenze der Export-Links
  • Umstieg auf den Metric Export — alte IDs und ihre neuen Metriken, und was sich ändert
  • Legacy-Export-API — die bisherigen Export-Links, die weiter funktionieren
  • Metric Export für Excel — Rezepte und Power Query
  • FAQ zum Daten-Export — kurze Antworten auf häufige Fragen
  • Metriken — die eigenen Metriken Ihrer Organisation
  • API-Tokens — das Token Metric Export
Next
Metric-Export-API
© 2026 Mirox Verwaltungs GmbH. Alle Rechte vorbehalten. | Datenschutz