Eigene Grafana-Dashboards erstellen

Das bereitgestellte Grafana ist nicht nur lesend. Jedes Portfolio hat seinen eigenen Grafana-Arbeitsbereich, in dem Sie Dashboards auf denselben rohen Zeitreihen bauen können, die die Plattform aufzeichnet — solange Sie eine Regel einhalten: Das von Mirox bereitgestellte Übersichts-Dashboard ist verwaltet und wird bei jedem Versions-Rollout ersetzt. Eigene Dashboards entstehen daher als Kopien, nie durch Bearbeiten des Originals. Diese Anleitung erklärt, wie Grafana strukturiert ist, was Sie ändern dürfen und wie die Zeitreihen der Plattform gelesen werden müssen, damit die Zahlen stimmen.

Wenn Sie nur das bereitgestellte Dashboard öffnen möchten, lesen Sie Grafana als externe Read-Plattform nutzen. Den Metrikkatalog finden Sie unter Metrikerfassung.

Wie Grafana strukturiert ist

Eine Grafana-Organisation je Portfolio

Mirox stellt eine Grafana-Organisation je Portfolio bereit, benannt <Organisation> - <Portfolio>. Alles darin teilen sich die Mitglieder des Portfolios:

• Eine Datenquelle (<Organisation> - <Portfolio>), beschränkt auf die Anlagen dieses Portfolios. Jede Abfrage, die Sie schreiben, läuft gegen diese Datenquelle und sieht ausschließlich die Anlagen des Portfolios — nichts zu konfigurieren, nichts kann nach außen dringen.
• Ein verwaltetes Dashboard, Portfolio Overview - <Portfolio>, bereitgestellt von Mirox (siehe unten).
• Ihre eigenen Dashboards und Ordner, sichtbar für alle, die das Portfolio sehen können.

Weil das Portfolio die Einheit der Ressourcenfreigabe ist, ist eine Anlage, die zu mehreren Portfolios gehört, aus jeder ihrer Grafana-Organisationen erreichbar, und ein Dashboard, das Sie in einem Portfolio bauen, erscheint nicht in einem anderen. Legen Sie ein Dashboard dort an, wo die Personen Mitglied sind, die es brauchen.

Wer sehen und wer bearbeiten darf

Die Grafana-Mitgliedschaft folgt den Berechtigungen der Plattform und wird bei jeder Änderung automatisch aktualisiert — es gibt keine separate Grafana-Benutzerverwaltung:

Mitgliedschaften und Rollen werden synchronisiert, sobald eine Berechtigung erteilt oder entzogen wird; eine offene Grafana-Sitzung wird aufgefrischt, sodass sich ein frisch ernannter Editor nicht ab- und wieder anmelden muss.

Das verwaltete Übersichts-Dashboard

Portfolio Overview - <Portfolio> wird von Mirox aus einer veröffentlichten Vorlagenversion gerendert. Die Tags des Dashboards tragen die Version (mirox-template-v<N>), die Beschreibung nennt den exakt veröffentlichten Inhalt. Mirox-Administratoren rollen neue Versionen aus dem Admin-Bereich der Plattform aus, und ein Rollout löscht das Dashboard und legt es neu an — genau das hält jedes Portfolio auf einer bekannten, getesteten Vorlage.

Stattdessen:

1. Öffnen Sie das verwaltete Dashboard und nutzen Sie Edit → Save as copy (oder Export → Export as JSON und Import), um eine eigene Kopie unter neuem Namen anzulegen. Legen Sie sie in einem eigenen Ordner ab.
2. Bauen Sie auf der Kopie auf: Panels hinzufügen, Abfragen ändern, Variablen ergänzen. Die Kopie gehört Ihnen — kein Rollout fasst sie an.
3. Nach dem Rollout einer neuen Vorlagenversion öffnen Sie das verwaltete Dashboard einmal, um zu sehen, ob es Panels bekommen hat, die Sie in Ihre Kopie übernehmen möchten.

Dasselbe gilt für jedes Dashboard, das Sie von Grund auf neu anlegen: Alles, was nicht die verwaltete Übersicht ist, lässt die Plattform unangetastet.

Die Zeitreihen korrekt lesen

Grafana zeigt, was eine Abfrage liefert — eine falsche Lesart sieht genauso aus wie eine richtige. Die folgenden Regeln sind die, denen die Plattform selbst in ihren Berichten folgt; ein eigenes Dashboard, das sie einhält, zeigt dieselben Zahlen wie die Berichtsseiten.

Labels: was eine Reihe ist

Jede Reihe ist durch ihren Metriknamen plus ihre Labels identifiziert. Die Labels, nach denen Sie filtern und gruppieren werden:

Zwei Dinge sind bewusst keine Labels: Komponenten-Namen (siehe nächster Abschnitt) und Einheiten — jeder Wert wird in SI-Basiseinheiten gespeichert: W, Wh, V, A, Hz, °C, W/m², Wh/m². Stellen Sie die Grafana-Einheit auf watt / watt-hour und lassen Sie Grafana auf kW / MWh skalieren; nie in der Abfrage dividieren.

Aktuelle Komponentennamen anzeigen

Telemetrie trägt Komponentenkennungen, keine Namen: Eine Umbenennung in Mirox darf eine Reihe nicht in „vorher“ und „nachher“ aufspalten. Die aktuellen Namen werden als eigene Info-Reihen veröffentlicht — powerplant_inverter_info, powerplant_gak_info, powerplant_string_info, powerplant_feedin_info, powerplant_turbine_info — genau wie die Telemetrie geschlüsselt und mit dem Namen als Label (inverter_name, gak_name, string_name, meter_name, turbine_name). Fügen Sie sie mit folgendem Muster an die Telemetrie an (so macht es das verwaltete Dashboard):

sum by (inverter_id, inverter_name) (
  (
    powerplant_inverter_power_ac{park="${park}"}
    * on (park, inverter_id) group_left(inverter_name)
    sgn(topk_last(1, last_over_time(powerplant_inverter_info{park="${park}"}[7d] @ (now()))) by (park, inverter_id))
  )
  or on (park, inverter_id) powerplant_inverter_power_ac{park="${park}"}
)

So funktioniert es: last_over_time(...[7d] @ (now())) wählt je Komponente den neuesten Info-Punkt zum jetzigen Zeitpunkt, sodass eine Umbenennung in jedem Zeitbereich sichtbar ist; sgn() macht daraus eine 1, die die Multiplikation erhält; group_left(inverter_name) kopiert den Namen auf die Telemetrie; und der Zweig or on (...) hält eine Komponente (über ihre Kennung) sichtbar, wenn sie noch keine Info-Reihe hat. Für einen Generatoranschlusskasten joinen Sie über (park, inverter_id, gak_id) mit gak_name; für einen String über (park, inverter_id, gak_id, string_number) — die Info-Reihe trägt gak_id nur, wenn der String hinter einem Generatoranschlusskasten sitzt, genau wie die Telemetrie. Eine Info-Reihe selbst nie plotten, summieren oder alarmieren.

Die vier Formen einer Reihe

Die Berichts-Engine liest jede Reihe auf eine von vier Arten. Mit derselben Lesart stimmt Ihr Dashboard mit den Berichtsseiten überein.

Anlagensummen versus Komponenten

Quellenabgeleitete Analysereihen (Modelle, erwartete Leistung, Performance-Ratio, Abregelung) existieren auf Anlagenebene und einmal je Segment. Wählen Sie die Anlagenreihe mit segment_id!~".+", sonst liest eine segmentierte Anlage N + 1-fach. Dasselbe gilt für die Onshore-Wind-Abrechnung: Punkte je Turbine tragen turbine_id, die Parksumme nicht — nutzen Sie turbine_id!~".+" für die Parkreihe.

Für Panels je Komponente gruppieren Sie nach den Identitäts-Labels und joinen, wo Sie Namen möchten, die Info-Reihen wie oben gezeigt. Modellierte Leistung und PR je Komponente (powerplant_<source>_inverter_power, powerplant_<source>_inverter_pr und die Zwillinge für gak / string) existieren für die Quellen pyranometer und weather.

Statuscodes und Zustände

powerplant_inverter_vendor_status, powerplant_turbine_vendor_status, battery_*_vendor_status sind die herstellereigenen Codes: Eine Lücke bedeutet „nicht gelesen“, und der Wert ist ein Code, nie eine Größe — nicht summieren oder mitteln. powerplant_inverter_operating_state und powerplant_turbine_operating_state sind die Standardzustände der Plattform (0 unbekannt … 8 Fehler), so nummeriert, dass max by (inverter_id) als „schlechtester Zustand im Bucket“ gelesen wird. Zeigen Sie sie mit einem Grafana-Value mapping statt als Linie.

Häufige Fallstricke

• last_over_time(...[30y]), um „den neuesten Wert“ zu holen, durchsucht bei jeder Aktualisierung die gesamte Aufbewahrung. Nutzen Sie ein Fenster, das zur Kadenz der Reihe passt — [1h] für einen Minuten-Messwert, [1d] für einen Tageswert, [7d] für die Info-Reihen.
• Filtern auf Namen (inverter_name="WR 01") funktioniert nach einer Umbenennung nicht mehr. Filtern Sie auf inverter_id und zeigen Sie den Namen über den Info-Reihen-Join.
• Lanes mischen: powerplant_pyranometer_power ohne clipping- / pr-Pins liefert mehrere Lanes derselben Größe. Pinnen Sie die gemeinte Lane — die Tabelle unten nennt die Pins, die die Berichte verwenden.
• Anlagen mit mehreren Zählern: powerplant_power_grid ist eine Reihe je Zähler. sum(...) darüber, oder powerplant_grid_power lesen, das bereits die summierte, minutengenaue Anlagenreihe ist.
• Zeitzone: Reihen werden in UTC gespeichert, Grafana zeigt sie in der Zeitzone des Browsers. Tageswerte (konfigurierte Fakten, tägliche Urteile) sind auf die lokale Mitternacht der Anlage gestempelt — stellen Sie die Dashboard-Zeitzone auf die der Anlage, wenn Sie Tage vergleichen.

Der Berichts-Reihenkatalog

Die Berichts- und Exportseiten der Plattform bauen auf einem festen Katalog von Reihen auf, jede mit einer definierten Lesart. Die Tabelle nennt jedes Element mit der gelesenen Metrik, der Form, in der sie gelesen wird (siehe oben), den Label-Pins, die die Berichte anwenden, und der Ebene (Anlage, je Wechselrichter, je Generatoranschlusskasten, je String, je Segment). Mit Solar markierte Elemente werden nur für Solaranlagen emittiert; die Berichtseinheit ist die Einheit, die die Berichtsseiten anzeigen — die gespeicherte Reihe ist immer in Basiseinheiten (Wh, W, Wh/m²). Ein Pin period="<YYYY-MM>" wählt den Liefermonat einer abgerechneten Lane.

Zähler und Erzeugungszähler

Anlagenleistung

Einstrahlung in Modulebene

Modellierte, erwartete und Clearsky-Erzeugung

Performance-Ratio

Sensoren vor Ort

Leistungsbegrenzungen

Abgerechnete Abregelung

Wechselrichter

Generatoranschlusskästen

Strings

Batterie

Wetter

Marktpreise

Infrastruktur

Verwandte Dokumentation

• Grafana als externe Read-Plattform nutzen — das bereitgestellte Grafana und das verwaltete Dashboard erreichen
• Metrikerfassung — der vollständige Metrikkatalog mit Einheiten und Labels
• MiroxQL Query Language — dieselben Reihen, aus der Plattform abgefragt und zu eigenen Metriken für Berichte gemacht
• Metrik-Export-API — bereinigte, aggregierte Metriken als CSV oder JSON