Grafana als externe Read-Plattform nutzen
Mirox stellt ein einsatzbereites Grafana für Ihre Daten bereit und verbindet es für Sie, sodass Sie für jede Anlage mit einem Klick einen vollständigen Visualisierungs-Arbeitsbereich öffnen können — ohne separaten Grafana-Login, Installation oder Datenquellen-Einrichtung. Diese Anleitung führt Sie durch den Zugriff auf Grafana und das Auslesen Ihrer Daten; was die Einbettung im Hintergrund leistet, erfahren Sie unter Diagramm-Visualisierung.
Wann Grafana zu verwenden ist
Verwenden Sie Grafana, wenn Sie die Rohmesswerte hinter den Kennzahlen untersuchen möchten — Leistungskurven, Energiezähler, Wettereingangsdaten und Signale auf Komponentenebene — in dem Zeitbereich und der Auflösung Ihrer Wahl.
- Für berechnete Performance-Aggregate (Produktion, Verluste, Verfügbarkeit, spezifischer Ertrag) nutzen Sie stattdessen die KPI-Ansichten innerhalb der Plattform — Grafana stellt die rohen Zeitreihen dar, nicht vorab aggregierte KPIs.
- Um Daten als CSV oder JSON für Tabellenkalkulationen und Berichte zu exportieren, verwenden Sie die Metrik-Export-API.
- Um eigene berechnete Zeitreihen programmatisch abzufragen oder zu erstellen, verwenden Sie MiroxQL oder die Export-API.
Liest die Rohmetriken
Das bereitgestellte Grafana läuft auf denselben roh erfassten Metriken, die die Plattform von Ihren Anlagen aufzeichnet — hochfrequente, mehrdimensionale Zeitreihen — nicht auf den bereinigten, täglich aggregierten Export-Metriken. Genau deshalb ist es das richtige Werkzeug, um ein Signal im Detail zu untersuchen.
Namen sind keine Labels
Die Zeitreihen tragen Komponentenkennungen (inverter_id, gak_id, string_number), nie die in Mirox vergebenen Namen — eine Umbenennung in Mirox ändert in Grafana deshalb nichts, weder rückwirkend noch für neue Daten. Die aktuellen Namen kommen über die Info-Reihen (powerplant_inverter_info …) in die Legende; das Muster steht unter Aktuelle Komponentennamen anzeigen.
Wo Grafana bereitgestellt wird
Grafana wird je Portfolio bereitgestellt. Wenn Sie ein Portfolio anlegen, werden dessen Dashboards automatisch eingerichtet und sind sofort erreichbar — Sie müssen weder auf eine Hintergrund-Synchronisierung warten noch eine Datenquelle konfigurieren.
Jede Anlage, auf die Sie Zugriff haben, ist über das Dashboard ihres Portfolios erreichbar, eingegrenzt auf diese Anlage. Sie sehen stets nur Diagramme für die Anlagen, die Ihnen Ihre Rolle gewährt; die Sichtbarkeit folgt denselben Berechtigungsregeln wie der Rest der Plattform.
In Produktion verfügbar
Der Grafana-Link ist in der Produktionsumgebung aktiv. Wenn Sie in einer Nicht-Produktionsumgebung arbeiten, wird der Link angezeigt, ist jedoch deaktiviert.
Grafana für eine Anlage öffnen
Grafana wird aus der Navigation der Anlage geöffnet, eingegrenzt auf die von Ihnen ausgewählte Anlage.
- Öffnen Sie die Anlage, die Sie darstellen möchten.
In Mirox öffnen: service.mirox.io/#/monitor/solar/0/production - Klicken Sie im Abschnitt Site der Seitenleiste auf Grafana.
- Grafana öffnet sich in einem neuen Browser-Tab, bereits über Ihre Mirox-Sitzung angemeldet und mit dem Übersichts-Dashboard der Anlage.
Kein zweiter Login
Ihre Mirox-Sitzung wird an Grafana weitergereicht — es gibt keinen separaten Benutzernamen, kein Passwort, keine Server-URL und kein Token einzugeben, bevor Sie eine Anlage darstellen können.
Ihre Daten auslesen
Das Dashboard öffnet sich in der Übersichts-Ansicht der Anlage und bietet Ihnen das Standard-Grafana-Werkzeugset, angewendet auf Ihre Anlagenmetriken:
- Zeitbereich wählen — wählen Sie ein beliebiges Fenster und zoomen und verschieben Sie dann zum interessierenden Moment.
- Auflösung anpassen — betrachten Sie feinkörnige Rohdaten für eine Leistungskurve oder gröbere Aggregate für langfristige Trends.
- Exakte Werte ablesen — fahren Sie über eine Zeitreihe oder klicken Sie sie an, um den Wert zu einem bestimmten Zeitpunkt abzulesen.
- Signale vergleichen — stellen Sie Metriken mit unterschiedlichen Einheiten (zum Beispiel Leistung gegen Einstrahlung) gemeinsam dar.
Das Dashboard ist bereits auf die Anlage eingegrenzt, für die Sie es geöffnet haben, sodass die Produktion und die wichtigsten Signale dieser Anlage bereits sichtbar sind.
Eigene Dashboards erstellen — das bereitgestellte nie bearbeiten
Portfolio Overview - <Portfolio> wird von Mirox verwaltet und bei jedem Rollout einer neuen Vorlagenversion ersetzt — jedes Panel, das Sie dort hinzufügen, und jede Abfrage, die Sie ändern, geht verloren. Zum Anpassen speichern Sie eine Kopie (Edit → Save as copy) oder legen ein neues Dashboard in der Grafana-Organisation des Portfolios an; Kopien und eigene Dashboards werden nie angefasst. Wie Grafana je Portfolio strukturiert ist, wer bearbeiten darf und wie die Reihen der Plattform gelesen werden müssen, damit die Zahlen stimmen, steht in Eigene Grafana-Dashboards erstellen. Die bereitgestellten Dashboards selbst sind in Diagramm-Visualisierung beschrieben.
Abgrenzung zu verwandten Oberflächen
Es ist leicht, die Stellen zu verwechseln, an denen Metrikdaten in Mirox erscheinen. Jede dient einem anderen Bedarf:
| Oberfläche | Was sie zeigt | Wann sie zu verwenden ist |
|---|---|---|
| Bereitgestelltes Grafana | Rohe und aggregierte Zeitreihen in interaktiven Diagrammen, vorab mit Ihren Anlagen verbunden | Untersuchung eines Signals im Detail innerhalb von Mirox, ohne Einrichtungsaufwand |
| MiroxQL | Dieselben Rohmetriken, abgefragt und zu Ihren eigenen berechneten Zeitreihen kombiniert | Programmatische oder benutzerdefinierte Abfragen auf Ihre Daten |
| Metrik-Export-API | Bereinigte, täglich aggregierte Metriken als CSV oder JSON | Export von Daten für Tabellenkalkulationen, Berichte oder externe Werkzeuge |
Verwandte Dokumentation
- Eigene Grafana-Dashboards erstellen — Portfoliostruktur, Editor-Rechte, die Regel „kopieren statt bearbeiten“ und wie die Reihen korrekt gelesen werden
- Diagramm-Visualisierung — wie die eingebettete Grafana-Oberfläche funktioniert und welche Dashboards bereitgestellt werden
- Metrik-Export-API — export-fertige, aggregierte Metriken für die Berichterstellung
- MiroxQL-Abfragesprache — fragen Sie Ihre Rohdaten ab und definieren Sie eigene berechnete Metriken