Metriken
Unter Metriken definiert Ihre Organisation ihre eigenen Metriken. Sie beschreiben in einem kurzen Ausdruck, was in einem einzelnen 15-Minuten-Intervall gemessen werden soll. Den Rest übernimmt die Plattform: Sie wendet Ihren Ausdruck auf jede Anlage an, über den Zeitraum, den ein Bericht abdeckt, und verdichtet die 15-Minuten-Werte zu der Zahl, die Sie sehen möchten.
Eine Metrik wird einmal für die gesamte Organisation definiert und steht anschließend auf jeder Anlage zur Verfügung — Sie schreiben eine Metrik nie „für eine Anlage".
Wo Sie die Funktion finden
Metriken gehören der Organisation und stehen deshalb in ihrem Glossar auf der Seite Daten-Export: Öffnen Sie Daten-Export in der Hauptnavigation und wechseln Sie auf den Tab Glossar. In Mirox öffnen — Daten-Export ▸ Glossar. Ein Link auf eine einzelne Metrik öffnet direkt ihren Editor: https://service.mirox.io/#/export?tab=glossary&metric=<uid>.
Die Seite Berichte hat keinen eigenen Tab für Metriken mehr; Kapitel nutzen Ihre Metriken weiterhin über die Datenauswahl. Ältere Links auf die Metriken der Seite Berichte funktionieren weiter und führen zum Glossar.
- Die Organisationsrollen Admin, Moderator, Asset Manager (Technisch) und Asset Manager (Kaufmännisch) erstellen, duplizieren, bearbeiten und löschen Metriken.
- Alle Mitglieder sehen die Metriken und können sie in Berichten verwenden.
- Eine als Privat markierte Metrik bearbeiten und löschen nur die Person, die sie angelegt hat, ein Admin oder ein Moderator. Alle sehen sie weiterhin und verwenden sie in Berichten und Alarmregeln, und wer Metriken anlegen darf, kann sie duplizieren. Siehe Privat.
Die Tabelle zeigt für jede Metrik ihre Anlagentypen und wo sie verwendet wird; ein Klick auf eine Zeile öffnet den Editor. Schritt-für-Schritt-Anleitungen finden Sie unter Mit Berichten arbeiten.
Eine Metrik definieren
Eine Metrik besteht aus einigen beschreibenden Feldern und einem bis vier Ausdrücken.
Mit Neue Metrik entsteht die Metrik sofort, und von da an wird jede Änderung beim Tippen gespeichert — eine Statusanzeige zeigt Wird gespeichert und anschließend Gespeichert; ein eigener Schritt zum Bestätigen entfällt. Solange ihr Ausdruck nicht gültig ist, ist die Metrik als Nicht validiert gekennzeichnet und wird in einem Bericht nie als Datenquelle angeboten. Sobald der Ausdruck gültig ist, verschwindet die Markierung und die Metrik ist überall verwendbar — siehe Validierung.
- Name, Beschreibung, Einheit — so erscheint die Metrik in der Datenauswahl des Berichts und im fertigen Bericht.
- Id — der Name, über den Vorlagen und Kapitel auf die Metrik verweisen; siehe Id einer Metrik.
- Ausdruck — was in einem 15-Minuten-Intervall gemessen wird. Geschrieben wird er in MetricsQL, der Abfragesprache des Zeitreihenspeichers der Plattform. Sie schreiben ausschließlich den Teil für ein Intervall: Anlage, Zeitfenster und Verdichtung ergänzt die Plattform. Nennen Sie im Ausdruck niemals eine Anlage oder eine Organisation — das wird abgelehnt, denn dieselbe Metrik muss auf jeder Anlage funktionieren.
- Verdichtung — wie aus den 15-Minuten-Werten eine Zahl wird:
- Mittelwert — der Durchschnitt der Intervallwerte
- Gewichteter Mittelwert — der Durchschnitt, in dem jedes Intervall mit dem Wert eines weiteren Ausdrucks zählt, Gewichtung je Intervall: Σ(Wert × Gewicht) ÷ Σ(Gewicht). Die Gewichtung antwortet für die ganze Anlage oder je derselben Komponente wie der Ausdruck.
- Summe — die Summe der Intervallwerte
- Verhältnis — der Anteil der erwarteten Intervalle, in denen der Ausdruck 1 war
- Letzter Wert — der Wert am Ende des Zeitraums
- Erwartet (Nenner) (optional, für die Verdichtung „Verhältnis“) — ein zweiter Ausdruck, der festlegt, welche Intervalle überhaupt zählen, zum Beispiel „es ist Tag". Ein Intervall ohne Erwartung zählt nicht; ein erwartetes Intervall ohne Messwert gilt als nicht verfügbar; ein Zeitraum ganz ohne erwartetes Intervall wird als Strich dargestellt.
- Gewichtung (optional) — ein fester Wert je Komponente, etwa deren Spitzenleistung, mit dem die Komponentenwerte zu einem Anlagenwert zusammengeführt werden. Ohne Gewichtung zählen alle Komponenten gleich.
- Ausgabe als — in welcher Form die Metrik antwortet. Anlagenwert liefert eine Zahl je Anlage; arbeitet der Ausdruck je Komponente, ist das der oben beschriebene gewichtete Anlagenwert. Je Komponente liefert eine Spalte je Wechselrichter, Generatoranschlusskasten, Strang oder Logger — zusätzlich zum Anlagenwert. Duplizieren Sie eine Metrik, wenn Sie dieselbe Größe in beiden Formen brauchen.
- Feinste Auflösung — der feinste Schritt, in dem ein Bericht die Metrik ausweisen darf: 15 Minuten, stündlich oder täglich. Gröbere Schritte stehen immer zur Verfügung; wählen Sie Tag für eine Größe, die nur je Tag sinnvoll ist.
Ein Bericht weist die Metrik in der Auflösung aus, die sein Block verlangt — 15 Minuten, stündlich, täglich, monatlich oder ein einzelner Wert für den gesamten Zeitraum —, und ein Export in der Schrittweite, die Sie wählen, aber nie feiner als die Feinste Auflösung.
Während Sie tippen, prüft der Editor laufend: Syntax, unbekannte Serien (mit Vorschlägen, was Sie vermutlich gemeint haben), die Regel zur Eigenbegrenzung, ob die Ausdrücke zur gewählten Verdichtung passen, und die Größe. Ein Testlauf wertet die Metrik anschließend auf der unter Auswerten auf gewählten Anlage aus, und eine Vorschau zeigt eine Tabelle und eine Grafik mit jeder Wechselrichter- bzw. Komponentenspur und dem daraus entstehenden Anlagenwert für einen von Ihnen gewählten Monat, ein Quartal oder ein Jahr — eine als Anlagenwert ausgewiesene Metrik zeigt allein diesen einen Wert. Prüf- und Testmeldungen nennen die Anlage beim Namen, gegen die geprüft wurde.
Validierung
Während Sie tippen, prüft der Editor die Metrik gegen die Anlage, die oben im Editor unter Auswerten auf gewählt ist: Syntax, unbekannte Serien (mit Vorschlägen), die Regel zur Eigenbegrenzung, ob die Ausdrücke zur Verdichtung passen, und die Größe. Das Urteil listet auf, was noch nicht stimmt, und zeigt den gestrigen Wert auf dieser Anlage so, wie ein Bericht ihn drucken würde.
Solange ein Problem besteht, ist die Metrik als Nicht validiert gekennzeichnet. Sie wird trotzdem gespeichert, aber kein Bericht, kein Kapitel und kein Export kann sie lesen, und die Datenauswahl bietet sie nicht an. Beheben Sie, was der Editor auflistet, und die Markierung verschwindet von selbst. Nicht validiert ist nicht dasselbe wie ein Entwurf bei Berichten — ein Berichtsentwurf ist ein fertiger Bericht, der darauf wartet, geprüft und veröffentlicht zu werden.
Warnungen — etwa eine Serie, die diese Anlage nicht geliefert hat, oder ein Wert, der unplausibel wirkt — blockieren die Metrik nicht; sie sagen Ihnen, was Sie prüfen sollten.
Eine Metrik, die Vorlagen bereits verwenden und die Sie in einen fehlerhaften Zustand bringen, fehlt in deren Berichten, bis sie wieder gültig ist — behalten Sie vor größeren Änderungen die Anzahl unter Verwendet in im Blick.
Auswerten auf bestimmt nur, wo Prüfung, gestrige Stichprobe, Vorschau, Bausteine und Assistent laufen. Die Metrik selbst gehört zu keiner Anlage: Jeder Bericht wertet sie auf der Anlage aus, für die er erstellt wird.
Id einer Metrik
Jede Metrik hat eine Id: Kleinbuchstaben, Ziffern und Unterstriche, mindestens drei Zeichen, nicht mit einer Ziffer beginnend und innerhalb Ihrer Organisation eindeutig. Vorlagen und Kapitel verweisen über diese Id auf eine Metrik.
Sie können die Id ändern, solange nichts die Metrik verwendet — ob validiert oder nicht. Sobald eine Vorlage oder ein Kapitel sie liest, ist die Id fest: Das Feld ist gesperrt, und die Zeile darunter zeigt, wo die Metrik verwendet wird. Brauchen Sie wirklich eine neue Id, nehmen Sie die Metrik zuerst aus diesen Vorlagen und Kapiteln heraus. Ist die eingegebene Id bereits vergeben, sagt der Editor das und bietet an, die gespeicherte Id wieder einzusetzen.
Die Bausteine
Die Seitenleiste des Editors führt alles auf, woraus Sie bauen können — Sie müssen sich also kaum Namen merken:
- Serien — dieselben Daten wie die Datenauswahl der Berichte: Einspeisung und Produktion der Anlage, Sollproduktion und Referenzserien, Vergütung und Abregelung, Wechselrichter, Generatoranschlusskästen, Stränge, Speicher, Wetter und Infrastruktur, jeweils mit den Labels und Schritten, die sie tragen. Sie können nach Namen suchen und nach Ebene filtern; eine Markierung zeigt, welche Serien die aktuelle Anlage noch nicht geliefert hat — die Metrik funktioniert trotzdem organisationsweit. Was ein Bericht berechnet statt liest (Performance Ratio, Ereigniszahlen, Abrechnungsgrößen), steht am Ende als nicht ausdrückbar, damit Sie es wissen, bevor Sie es schreiben.
- Konfigurierte Werte — Werte aus der Anlagenkonfiguration, keine Messwerte: DC-Spitzenleistung von Wechselrichter, Generatoranschlusskasten und Strang, Spitzenleistung der Anlage, Wechselrichterleistung der Anlage sowie Stückzahlen. Sie werden beim Ausführen für jede Anlage in die Abfrage eingesetzt, ein Ausdruck verwendet den Namen deshalb wie eine konstante Zeitreihe — etwa
park.inverter.peak_power, um je Wechselrichter zu gewichten oder eine Schwelle zu setzen. Bei einer Anlage, bei der keine Komponente den Wert konfiguriert hat, bleibt die Vorschau leer; die Metrik selbst funktioniert auf jeder Anlage, die sie hat. Zwei davon sind zeitabhängig statt konstant: der effektive anzulegende Wert der Anlage — der leistungsgewichtete anzulegende Wert der jeweils gültigen EEG-Bänder — und der Marktwert, gegen den die Anlage abgerechnet wird, monatlich oder jährlich je nach ihrer Marktkonfiguration, beide in EUR/MWh. Sie ändern sich über die Zeit, und die Plattform setzt in jedem 15-Minuten-Slot den dort gültigen Wert ein; ein eigenes Zeitfenster brauchen sie nicht. Eine daraus gebildete Marktprämie —clamp_min(park.eeg_value - park.marktwert, 0)— ist eine gemittelte Näherung für den Verlauf: Die Abrechnung rechnet jedes Band einzeln anteilig, der Wert ist also nie die abgerechnete Größe.
Konfigurierte Werte
Konfigurierte Werte sind Größen aus der Anlagenkonfiguration — Spitzenleistungen, die Wechselrichterleistung, Komponentenanzahlen und zwei Geldwerte —, die Sie in einer Metrik verwenden können. Ihre Namen beginnen mit park.; schon der Name zeigt also, dass der Wert aus der Anlagenkonfiguration stammt und nicht aus Messdaten.
| Name | Bedeutung | Einheit | Früherer Name |
|---|---|---|---|
park.inverter.peak_power | DC-Spitzenleistung je Wechselrichter | W | powerplant_inverter_peak_power |
park.gak.peak_power | DC-Spitzenleistung je Generatoranschlusskasten | W | powerplant_gak_peak_power |
park.string.peak_power | DC-Spitzenleistung je Strang | W | powerplant_string_peak_power |
park.peak_power | Spitzenleistung der Anlage | W | powerplant_park_peak_power |
park.inverter_limit | Wechselrichterleistung (Begrenzung) der Anlage | W | powerplant_park_limit_inverter |
park.inverter_count | Anzahl der Wechselrichter | Anzahl | powerplant_park_inverter_count |
park.string_count | Anzahl der Stränge | Anzahl | powerplant_park_string_count |
park.eeg_value | Effektiver anzulegender Wert nach EEG, zeitabhängig | EUR/MWh | powerplant_park_eeg_value |
park.marktwert | Marktwert, gegen den die Anlage abgerechnet wird, zeitabhängig | EUR/MWh | market_marktwert |
- Aus der Konfiguration gelesen, nicht gespeichert. Konfigurierte Werte werden nicht als Zeitreihe abgelegt. Jedes Mal, wenn eine Metrik berechnet wird, liest Mirox sie aus der Anlagenkonfiguration und setzt sie für diese Anlage in die Abfrage ein. Es gilt also immer der aktuell konfigurierte Wert: Korrigieren Sie eine Spitzenleistung, rechnet jeder danach berechnete Zeitraum — auch vergangene — mit dem korrigierten Wert.
- Von Mirox berechnet. Eine Metrik mit einem konfigurierten Wert steht in Berichten, im Daten-Export (Reiter Metriken, CSV und JSON) und über die Export-API zur Verfügung. Beim direkten Zugriff auf die Zeitreihendatenbank steht sie nicht zur Verfügung – etwa in eigenen Grafana-Dashboards oder jedem anderen Werkzeug, das die Datenbank selbst abfragt: Die
park.-Namen gibt es dort nicht. Dasselbe gilt für den Anlagenwert einer Metrik je Komponente, die mit einem konfigurierten Wert gewichtet wird — etwa Wechselrichter gewichtet nach ihrer Spitzenleistung —, denn diese Zusammenfassung berechnet Mirox erst nach dem Lesen der Komponentenwerte. Im Daten-Export tragen solche Metriken ein kleines config-Badge; fahren Sie mit der Maus darüber, erscheint eine kurze Erklärung. - Gewichtung nach Spitzenleistung. Mit einer Spitzenleistung als Gewichtung (etwa
park.inverter.peak_power) zählt jede Komponente im Verhältnis zu ihrer konfigurierten Spitzenleistung. Eine Komponente ohne eingetragene Spitzenleistung zählt kaum; hat keine Komponente eine, zählen alle gleich. Ausgeblendete Komponenten haben keinen konfigurierten Wert und zählen nicht. - Frühere Namen funktionieren weiter. Metriken, die mit den früheren Namen gespeichert wurden, funktionieren unverändert. Neue Metriken, die Bausteine des Editors und der Assistent verwenden die
park.-Namen. - Reihe per Anlageneinstellung gewählt. Manche Metriken lesen eine Reihe, die in der Zeitreihendatenbank liegt – welche, hängt aber von den Anlageneinstellungen ab: Die abgerechneten Abregelungsmetriken mit dem Zusatz (Verfahren der Anlage) lesen die Reihe des Abrechnungsverfahrens, das für die jeweilige Anlage eingestellt ist (Spitz, Spitz light oder Pauschal; bei einem Windpark die Windverfahren). Ihre Abfrage zeigt im Daten-Export
powerplant_<method>_…mit offenem Verfahren, und nach einer Vorschau nennt der Tooltip das Verfahren je Anlage. Bei mehreren Anlagen zählt jede mit ihrem eigenen Verfahren. Beim direkten Zugriff auf die Zeitreihendatenbank wählen Sie das Verfahren je Anlage selbst; soll unabhängig von der Einstellung ein bestimmtes Verfahren gelesen werden, wählen Sie dessen eigene Metrik. Auch diese Metriken tragen im Daten-Export das config-Badge.
Mitgelieferte Beispiele
In der Tabelle Metriken stehen bereits fünf Metriken, die Mirox jeder Organisation mitliefert: Erreichbarkeit, Logger-Verfügbarkeit, Wechselrichter-Verfügbarkeit bei Tageslicht, Sonnenstunden und Verfügbarkeit Einspeisedaten. Sie tragen ein Schloss und die Markierung Beispiel — sie gehören keiner Organisation und lassen sich daher weder bearbeiten noch löschen.
Was Sie damit tun können:
- Öffnen Sie ein Beispiel und lesen Sie seine Ausdrücke. Sie zeigen genau das, was oben beschrieben ist: den Tageslichtfilter, beide Formen der Verdichtung „Verhältnis“, die Zuordnung je Komponente und eine Skalierung der Einheit.
- Klicken Sie auf der Anlage, auf der Sie gerade sind, auf Vorschau berechnen, und sehen Sie die einzelnen Spuren und den Anlagenwert, der daraus entsteht.
- Duplizieren Sie ein Beispiel. Die Kopie gehört Ihrer Organisation, ist vollständig bearbeitbar und ist der übliche Ausgangspunkt für eine eigene Metrik.
Die Beispiele sind bewusst die einfache, nachvollziehbare Fassung der jeweiligen Frage; jede Beschreibung nennt, was sie nicht berücksichtigt. Die Verfügbarkeitswerte des Berichts selbst — die den konfigurierten Logger-Bestand der Anlage und ihre Abrechnungsverfahren verwenden — bleiben unverändert unter Verfügbarkeit in der Datenauswahl des Berichts. Deshalb erscheinen die Beispiele dort nicht selbst; ein Duplikat schon.
Ausdrücke schreiben (MetricsQL)
Ein Ausdruck wird in MetricsQL geschrieben, der Abfragesprache des Zeitreihenspeichers der Plattform — dieselbe Sprache, mit der auch die Rohmetriken hinter Grafana gelesen werden. Er wird auf 15-Minuten-Slots für jeweils eine Anlage ausgewertet: Die Plattform begrenzt jede Reihe auf die Anlage selbst, ein Ausdruck nennt also nie eine Anlage, ein Portfolio oder eine Organisation. Beginnen Sie mit den Bausteinen, die der Editor anbietet (die Reihen mit ihren Labels, die konfigurierten Werte der Anlage, die Muster), lassen Sie sich von der Live-Validierung sagen, was fehlt, und prüfen Sie den Ausdruck in der Vorschau gegen eine Anlage, bevor Sie speichern. MetricsQL ist der mächtigere der beiden Wege, eine Metrik zu definieren: Spuren je Komponente, Tageslicht-Begrenzung, Verhältnisse und Faltungen lassen sich hier ausdrücken — Metriken sind der Nachfolger der MiroxQL-Formeln, der berechneten Spalten des Legacy-Exports, die nicht mehr in der App bearbeitet werden. Die Sprachreferenz selbst ist die öffentliche MetricsQL-Dokumentation des Speicheranbieters; die Funktionen und Grenzen, die der Editor akzeptiert, stehen in seinen Bausteinen. Während Sie tippen, schlägt der Editor Seriennamen, Labels und Funktionen vor; Tab übernimmt den Vorschlag.
Auf anderen Metriken aufbauen
Ein Ausdruck kann eine andere Metrik verwenden, statt sie zu wiederholen:
metric("<metric id>")— eine andere Metrik Ihrer Organisation, über ihre Id;series("<series id>")— eine Plattform-Zeitreihe als ihr 15-Minuten-Wert für die Anlage, oderseries("<series id>", "inverter")für einen Wert pro Wechselrichter (ebensogak,string, …).
Eine Referenz steht für den 15-Minuten-Wert der anderen Metrik, vor der Verdichtung: metric("yield") / metric("expected_yield") teilt die beiden Werte jedes Intervalls, und danach wirkt die Verdichtung dieser Metrik. Eine referenzierte Metrik kann selbst Referenzen verwenden, bis zu acht Ebenen tief; eine Metrik, die sich am Ende auf sich selbst bezieht, wird abgelehnt. Ändert sich eine referenzierte Metrik, folgt jede darauf aufbauende Metrik.
Grenzen
- Ein Ausdruck darf bis zu 4 000 Zeichen lang sein; nachdem die Plattform die Anlage ergänzt hat, weist der Speicher alles über 16 KB zurück.
- Eine Metrik darf auf einer Anlage höchstens 500 Serien liefern.
- Der Testlauf über einen Tag muss innerhalb von 5 Sekunden abgeschlossen sein.
- Feiner als 15 Minuten lässt sich nichts messen.
Stößt eine Metrik an eine dieser Grenzen, weist der Editor bereits beim Tippen darauf hin, und die Metrik bleibt Nicht validiert, bis Sie es beheben.
Ein durchgerechnetes Beispiel
Wechselrichter-Verfügbarkeit (2 % der DC-Spitzenleistung) — der Anteil der Tageslichtintervalle, in denen ein Wechselrichter mindestens 2 % seiner DC-Spitzenleistung erzeugt hat, gewichtet nach Spitzenleistung, ausgewiesen in Prozent mit der Verdichtung Verhältnis.
Ausdruck:
max by (inverter_id) (max_over_time(powerplant_inverter_power_ac[900s])) > bool on(inverter_id) 0.02 * park.inverter.peak_power
Erwartung (welche Intervalle zählen — es ist genug Licht vorhanden):
(avg(avg_over_time(powerplant_pyranometer_radiation_power{segment_id!~".+"}[900s])) or avg(avg_over_time(powerplant_weather_radiation_power{segment_id!~".+"}[900s]))) > bool 100
Gewichtung (damit große Wechselrichter im Anlagenwert stärker zählen):
park.inverter.peak_power
Eine Metrik mit dem Assistenten erstellen
Sie müssen MetricsQL nicht selbst schreiben. Der Assistent sitzt im Metrik-Editor: Öffnen Sie Neue Metrik — oder eine Metrik, die Sie bearbeiten dürfen — und Sie finden ihn als Chat-Bereich oben rechts. Er bleibt stumm, bis Sie ihm schreiben; vorher wird nichts gesendet.
Beschreiben Sie die gewünschte Metrik in eigenen Worten. Der Assistent kennt bereits die unter Auswerten auf gewählte Anlage, die Felder, die Sie bisher ausgefüllt haben (Name, Ausdruck, Verdichtung, …), das Ergebnis der letzten Prüfung und die Serien, die diese Anlage tatsächlich schreibt — Rückfragen nach den Grundlagen erübrigen sich damit meist. Er schlägt Ausdruck, Name und Beschreibung vor, prüft sie, zeigt eine Vorschau auf der Anlage und weist Sie darauf hin, wenn die Plattform die angefragten Daten nicht vorhält oder die Abfrage zu aufwendig wäre.
Ein Vorschlag landet in dem Moment in den Feldern, in dem er eintrifft — der Assistent bearbeitet mit Ihnen, und jede Änderung wird dabei gespeichert. Möchten Sie lieber beim Bisherigen bleiben, setzt Rückgängig am Vorschlag im Chat die Felder auf den Stand davor zurück; der Vorschlag bleibt im Chat und lässt sich erneut übernehmen. Der Assistent bringt die Arbeit selbst zu Ende: Ein Vorschlag wird in dem Moment auf der Metrik gespeichert, in dem er entsteht — Sie können also Ihre Anfrage abschicken, die Seite schließen und finden die fertige Metrik später in der Liste. Danach ist alles eine gewöhnliche Bearbeitung: Sie ändern ein Feld, starten die Vorschau erneut oder fragen nach etwas anderem.
Das Gespräch gehört zur Metrik, nicht zum Browser-Tab. Schließen Sie den Editor und öffnen Sie die Metrik erneut oder laden Sie die Seite neu: Derselbe Chat steht wieder neben den Feldern, die er geschrieben hat.
Der Chat im Editor nimmt nur Text entgegen. Fotos und Dokumente — etwa die Formelseite aus einem Vertrag — bleiben eine Funktion der vollständigen Chat-Seite; mit Im Chat öffnen nehmen Sie das Gespräch dorthin mit.
Eine Metrik in einem Bericht verwenden
Wählen Sie im Berichtseditor oder im Kapiteleditor die Daten für einen Block: Ihre Metriken stehen in der Datenauswahl neben den Elementen der Plattform, gekennzeichnet als eigene Metrik, und verhalten sich genau wie diese — dieselben Auflösungen, dieselben Tabellen und Diagramme. Da eine Metrik organisationsweit gilt, funktioniert derselbe Block unverändert in einem Bericht für jede Anlage, die die Anlagentypen der Metrik hat. Eine als Nicht validiert gekennzeichnete Metrik wird nicht angeboten.
Eine Metrik in einer Alarmregel verwenden
Eine validierte Metrik kann von einer Alarmregel des Alarm Managers überwacht werden: Die Regel beurteilt ihren Wert alle fünf Minuten auf jeder Anlage und alarmiert, wenn er Ihren Schwellwert überschreitet. Ihre Metriken erscheinen im Regel-Editor unter Ihre Metriken.
Eine Metrik exportieren
Eine validierte Metrik ist Teil der Metriksammlung. Sie lässt sich als Zeitreihe exportieren wie jede Metrik, die Mirox mitliefert, für jede Anlage, die Sie lesen können, und über jeden Zeitraum.
In Mirox öffnen
Daten-Export ▸ Metriken — klicken Sie auf Metriken hinzufügen. Die Metriken Ihrer Organisation sind als Meine Metriken gruppiert.
Was Sie an der Metrik einstellen, bestimmt, wie sie exportiert wird:
| Einstellung der Metrik | Im Export |
|---|---|
| Feinste Auflösung | Die feinste Schrittweite. Eine Metrik mit 15 Minuten bietet 15 min, 1 h, Tag, Woche, Monat, Quartal und Jahr an; eine mit Tag beginnt beim Tag. Eine Metrik wird nie feiner als 15 Minuten exportiert. |
| Ausgabe als ▸ Anlagenwert | Eine Spalte je Anlage. |
| Ausgabe als ▸ Je Komponente | Eine Spalte je Komponente — Wechselrichter, Generatoranschlusskasten, String, Turbine, Batteriecontainer und so weiter — wie die Komponenten-Metriken, die Mirox mitliefert. |
| Verdichtung ▸ Summe mit einer Energieeinheit (Wh, kWh, MWh) | Eine Energie: exportiert Je Intervall oder als Laufende Summe. |
| Verdichtung ▸ Summe mit einer anderen Einheit | Eine gezählte Größe: exportiert Wie gemessen oder als Laufende Summe. |
| Verdichtung ▸ Mittelwert, Verhältnis, Gewichteter Mittelwert, Letzter Wert | Exportiert Wie gemessen. |
Werden mehrere Anlagen zu einer Spalte zusammengefasst, wird eine Summe über die Anlagen addiert, ein Mittelwert gemittelt (eine Leistung in W, var oder VA wird addiert) und ein Verhältnis oder ein Gewichteter Mittelwert aus den Summen der Anlagen neu berechnet. Ein Letzter Wert lässt sich nicht zusammenfassen und wird je Anlage gezeigt.
Drei Dinge sollten Sie wissen:
- Nicht validiert heißt nicht exportierbar. Die Auswahl zeigt die Metrik mit der Anmerkung Entwurf — zuerst unter Meine Metriken validieren, und ein Export-Link, der sie nennt, wird abgelehnt.
- Geld braucht die Buchhaltungsberechtigung. Eine Metrik, die den anzulegenden Wert nach EEG oder den Marktwert liest, ist eine Geld-Metrik. Ihre Spalte bleibt für Anlagen leer, auf denen Ihnen die Buchhaltungsberechtigung fehlt.
- Die ID in einem Link ist
organization., gefolgt von der Id der Metrik, zum Beispielorganization.inverter_availability_2pct.
Der Weg zurück funktioniert ebenfalls: Metrik erstellen auf dem Tab Metriken der Seite Daten-Export öffnet diesen Editor, ohne den Daten-Export zu verlassen, und Zurück zum Datenexport oben im Editor bringt Sie mit den Anlagen, Metriken und dem Zeitraum zurück, die Sie hatten. Aus dem Glossar geöffnet, heißt die Schaltfläche Zurück zum Glossar. Für eine Größe, die Sie einmal brauchen, ohne Namen und Einheit, nimmt die Exportseite auch eine rohe MetricsQL-Abfrage an; eine Metrik ist die richtige Wahl, sobald eine Größe wieder oder in einem Bericht verwendet wird.
Schritt-für-Schritt-Anleitungen stehen unter Metric Export; die Parameter der Links stehen in der Metric-Export-API.
Wo eine Metrik verwendet wird
Die Spalte Verwendet in der Metriktabelle zählt die Vorlagen und Kapitel, die eine Metrik lesen — zum Beispiel „2 Vorlagen · 1 Kapitel“. Ein Klick auf die Zahl zeigt sie mit Namen, jede mit einem Link Öffnen: Eine Vorlage öffnet sich im Berichtseditor, ein Kapitel im Kapiteleditor. Eine Vorlage zählt, ob sie die Metrik in einem eigenen Kapitel liest oder über ein Bibliothekskapitel. Exportvorlagen, die die Metrik als Spalte enthalten, zählen ebenfalls als Verwendung.
Solange eine Metrik verwendet wird:
- lässt sie sich nicht löschen — der Dialog zum Löschen nennt die Vorlagen und Kapitel, statt Löschen anzubieten; entfernen Sie die Metrik zuerst aus jedem von ihnen und aus den Exportvorlagen, die sie enthalten;
- lässt sich ihre Id nicht ändern — siehe Id einer Metrik;
- zeigt sich eine Änderung ihres Ausdrucks in jedem Bericht, der danach aus diesen Vorlagen erstellt wird. Früher erstellte Berichte behalten ihre Zahlen.
Eine Metrik, auf der eine andere Metrik aufbaut oder die eine Alarmregel überwacht, lässt sich ebenfalls nicht löschen; die Meldung nennt sie.
Eine Metrik, die niemand verwendet, lässt sich in der Tabelle oder im Editor löschen; früher erstellte Berichte behalten ihre Zahlen. Mitgelieferte Beispiele lassen sich nicht löschen.
Anlagentypen
Eine Metrik gilt für die Anlagentypen der Serien, die sie liest. Mirox leitet das ab — Sie legen es nie selbst fest:
- Turbinen- und andere Windserien → Wind
- Batterieserien → Batterie
- Wechselrichter-, Strang-, Generatoranschlusskasten- und andere PV-Serien → Solar
- Serien, die jede Anlage hat, etwa der Einspeisezähler, Wetter oder Marktpreise → Alle Anlagentypen
Eine Metrik, die Serien mehrerer Typen liest, gilt für jeden davon. Der Editor zeigt das Ergebnis neben dem Urteil (Gilt für), und die Metriktabelle hat eine Spalte Anlagentypen. Ein Kapitel, das die Metrik verwendet, übernimmt ihre Anlagentypen und erscheint deshalb nur in den Berichten von Anlagen, die einen davon haben — siehe Anlagentypen. Hat die unter Auswerten auf gewählte Anlage keinen der Typen der Metrik, sagt der Editor das: Die Metrik liefert dort nichts, wählen Sie also eine andere Anlage zum Prüfen.
Was sich nicht definieren lässt
Einige Größen berechnet die Plattform selbst; verwenden Sie dafür die vorhandenen Elemente, statt sie nachzubauen:
- Performance Ratio und Sollproduktion — nutzen Sie die von der Plattform berechneten Elemente, die auch als Bausteine zur Verfügung stehen.
- Abrechnung von Abregelungen — ergibt sich aus Ihrer Markt- und Tarifkonfiguration.
- AC-Nennleistung je Wechselrichter — wird nicht je Wechselrichter gespeichert und lässt sich daher nicht referenzieren.
Verwandte Seiten
- Berichte — wo Metriken verwendet werden
- Alarm Manager — Alarmregeln auf Ihren Metriken
- Mit Berichten arbeiten — Schritt-für-Schritt-Anleitung, auch zum Anlegen einer Metrik
- FAQ zu Berichten — warum sich eine Metrik nicht löschen oder umbenennen lässt, und mehr
- Metric Export — Metriken als Zeitreihe exportieren
- Metric-Export-API — die Parameter der Export-Links
- MiroxQL-Formeln — die berechneten Spalten des Legacy-Exports
- KI-Assistent & Wizards — der Assistent, der auch im Metrik-Editor arbeitet
- Mitgliederberechtigungen — wer Organisationsmetriken anlegen darf