Datenlogger konfigurieren

Datenlogger sind die Brücke zwischen der Ausrüstung an Ihrer Anlage und der Mirox-Plattform: Sobald ein Logger konfiguriert ist, beginnt der Mirox-Agent, dieses Gerät planmäßig abzufragen, jede Messung in ein einheitliches Metrik-Vokabular zu normalisieren und sie in die Plattform zu streamen. Diese Anleitung führt Sie durch das Hinzufügen eines Loggers, das Zuordnen eines erkannten Geräts zu einem Adapter, das Bestätigen seiner Antwort über eine Live-Sonde und das Anwenden Ihrer Änderungen – sowie durch die Grenzen dessen, was automatisch angebunden wird.

Bevor Sie beginnen

Ein Logger wird gegen ein Netzwerkgerät konfiguriert, das bereits im Anlagennetzwerk erkannt wurde. Wenn das gewünschte Gerät noch nicht vorhanden ist, führen Sie zuerst einen Erkennungsscan durch – siehe Netzwerkgeräte verwalten. Außerdem muss die sichere Verbindung zur Anlage bestehen; der Agent erreicht Geräte über den VPN-Tunnel.

Wo Datenlogger zu finden sind

Jede Anlage hat eine Datenfluss-Seite, auf der Sie ihre Logger verwalten und eingehende Daten beobachten.

In Mirox öffnen: Datenfluss – oder öffnen Sie Ihre Anlagen, wählen Sie eine Anlage aus und wechseln Sie zum Tab Datenfluss.

Der Seitenkopf zeigt Live-Kacheln für den Logger-Zustand (gesund vs. gesamt), die Agent-Verfügbarkeit und den Netzwerkverkehr, sodass Sie auf einen Blick erkennen, ob die Erfassung funktioniert. Im Tab Datenlogger fügen Sie Logger hinzu und verwalten sie; die Schaltfläche Änderungen anwenden oben rechts überträgt Ihre Konfiguration an den Agent.

Wie Datenlogger angebunden werden

Das Hinzufügen eines Loggers ist ein geführter Ablauf, der auf einer echten Kommunikation mit dem Gerät aufbaut. Die Plattform öffnet eine temporäre Nur-Lese-Verbindung – eine Sonde –, sodass Sie bestätigen können, dass das Gerät antwortet, und seine Live-Messwerte sehen, bevor Sie etwas festlegen. Es gibt zwei Wege in den Ablauf:

Mögliche Logger (automatisch erkannt) – wenn Hersteller und Typ eines erkannten Geräts zu einem bekannten Adapter passen, erscheint es in der Tabelle Mögliche Logger mit dem passenden, bereits vorausgefüllten Adapter. Das ist der schnelle Weg.
Logger hinzufügen (manuell) – wenn die Erkennung ein Gerät übersieht oder falsch klassifiziert, können Sie über die Schaltfläche Logger hinzufügen selbst ein beliebiges Netzwerkgerät und einen Adapter auswählen.

In beiden Fällen läuft derselbe Assistent ab und dieselbe Live-Sonde bestätigt das Gerät, bevor Sie speichern.

Einen automatisch erkannten Logger hinzufügen

In Mirox öffnen: Datenfluss (oder wählen Sie Ihre Anlage unter Ihre Anlagen und öffnen Sie den Tab Datenfluss).
Suchen Sie in der Tabelle Mögliche Logger das gewünschte Gerät. Jede Zeile zeigt den Gerätenamen, die IP, Hersteller/Typ und den Adapter, den die Plattform zugeordnet hat.
Klicken Sie auf die Schaltfläche + in der Zeile. Der Onboarding-Assistent öffnet sich mit bereits gebundenem Gerät und Adapter.
Folgen Sie den Assistentenschritten (unten) und speichern Sie den Logger.

Einen Logger manuell hinzufügen

Klicken Sie auf der Seite Datenfluss auf Logger hinzufügen.
Durchsuchen Sie im Schritt Gerät auswählen die Netzwerkgeräteliste nach Name, IP, Hersteller, Typ, Modell oder Beschreibung und wählen Sie das Gerät aus.
Wählen Sie den zu verwendenden Adapter aus und klicken Sie auf Weiter.
Folgen Sie den verbleibenden Assistentenschritten und speichern Sie den Logger.

Der Onboarding-Assistent, Schritt für Schritt

Der Assistent ist ein einzelner Dialog mit einer Seitenleiste mit Schritten und einem Live-Agent-Protokollstreifen am unteren Rand, sodass Sie die ganze Zeit beobachten können, wie der Agent mit dem Gerät kommuniziert. Ein Verbindungs-Badge neben dem Gerätenamen meldet den Sondenstatus (Verbinden, Sondieren, Inaktiv, Fehler, Fertig). Welche Schritte erscheinen, hängt vom Adapter ab:

Schritt	Wann er erscheint	Was Sie tun
Gerät auswählen	Nur beim manuellen Hinzufügen	Netzwerkgerät und Adapter auswählen
Identität	Geräte, die eine Konfiguration benötigen	Bestätigen, dass Gerät und Adapter korrekt sind
Anmeldedaten	Adapter, die eine Anmeldung erfordern	Benutzername und Passwort des Geräts eingeben
Sonde	Konfigurationsfreie Geräte	Die vom Gerät bereitgestellten Live-Messwerte beobachten
Werte zuordnen	Generische Logger	Jeden vom Gerät bereitgestellten Rohwert durchsuchen und jeden einer bekannten Metrik zuordnen
Probelauf	Generische Logger	Die genauen Metriken überprüfen, die Ihre Zuordnung erzeugen würde
Zusammenfassung	Geräte, die eine Konfiguration benötigen	Prüfen und speichern

Anmeldedaten und der Tresor

Wenn der Adapter sich beim Gerät anmelden muss, fragt der Schritt Anmeldedaten nach einem Benutzernamen und einem Passwort. Anmeldedaten, die Sie für dieses Gerät bereits im Anmeldedaten-Tresor hinterlegt haben, werden hier angeboten, damit Sie sie nicht erneut eintippen müssen, und Ihre Eingaben können später für den Proxy-Zugriff wiederverwendet werden.

Janitza benötigt keine Anmeldedaten

Janitza-Zähler werden ohne jegliche Anmeldedaten angebunden. Huawei SmartLogger- und Phoenix Contact-Controller benötigen eine Geräteanmeldung, daher erscheint der Schritt Anmeldedaten für sie, auch wenn sie ansonsten ohne Konfiguration auskommen.

Fronius kann einen Einspeisezähler ersetzen

Kleine Fronius-Parks haben oft keinen dedizierten Netz-Einspeisezähler. Aktivieren Sie beim Anbinden eines Fronius-Loggers die Option „Als Netzzähler verwenden", um die kombinierte Leistung des Gesamtgeräts und die Gesamtenergie als Haupt-Netzreihe des Parks zu veröffentlichen – ohne separaten Zähler.

SMA Power Manager listet seine Geräte selbst auf

SMA Power Manager (der SMA Data Manager / ennexOS-Anlagen-Controller) wird konfigurationsfrei angebunden: Melden Sie sich mit einem ennexOS-Benutzerkonto an, und der Manager meldet automatisch jedes ihm bekannte Gerät – Komponenten-ID, Name, Produkt, Seriennummer, IP-Adresse und Firmware –, sodass keine Geräteliste eingetippt werden muss. Drei Schalter steuern, was erfasst wird: Anlagen-Gesamtwerte erfassen (deaktivieren, wo bereits ein dedizierter Netzzähler misst), Wechselrichter-Reihen erfassen und Limit-Kanäle ausschließen. Ein Wechselrichter, den bereits ein anderer Logger direkt ausliest, wird automatisch zurückgehalten – der Power Manager meldet weiterhin dessen Drosselungsgrund, aber nicht seine Messwerte, sodass nichts doppelt veröffentlicht wird.

SMA Sunny Central behält seine Identität

SMA Sunny Central (die klassische Weboberfläche pro Wechselrichter) wird ebenfalls konfigurationsfrei angebunden. Ist an derselben Anlage auch ein SMA Power Manager konfiguriert, löst der Assistent die Identität des Sunny Central automatisch anhand der Geräteliste des Power Managers auf, sodass die Einheit dieselbe Komponente und Historie behält, die sie bereits hatte.

blue'Log-String-Überwachung ist ein Assistentenfeld

Ein blue'Log mit angeschlossener String-Überwachungshardware erhält einen Schritt String-Überwachung: Überwachung ein- oder ausschalten, den zugehörigen Wechselrichter auswählen und festlegen, wie oft die String-Ebene gelesen wird (jeder n-te Zyklus). Kennt der Logger seinen Wechselrichter bereits, wird dieser automatisch vorausgefüllt; andernfalls wählen Sie ihn aus den Wechselrichtern der Anlage aus.

Sungrow Logger wird konfigurationsfrei angebunden

Sungrow Logger meldet sich mit demselben Benutzernamen und Passwort an wie die Weboberfläche des Loggers selbst (SSL- und Ping-Verhalten sind optionale erweiterte Einstellungen). Neben den Messwerten seiner Wechselrichter erfasst er zusätzlich die aktive Fehlerliste des Loggers als Alarme und meldet automatisch Seriennummer, Modell, Firmware und Nennleistung jedes Wechselrichters.

INTILION-Batterien: Gerätetyp wählen und Kennung paaren

Eine INTILION-Anlage betreibt zwei verschiedene Steuerungen auf demselben Protokoll: eine Anlagensteuerung für den gesamten Standort und je Speichereinheit eine Batterieeinheit-Steuerung. Wählen Sie unter Gerätetyp, welche Sie anbinden – keine der beiden führt eine Seriennummer, dies ist also die einzige Angabe, die der Plattform sagt, was sie liest; eine falsche Wahl wird abgelehnt statt veröffentlicht.

Vergeben Sie für eine Batterieeinheit-Steuerung eine Kennung der Batterieeinheit und verwenden Sie genau dieselbe Kennung beim Schutzgerät des Mittelspannungsabgangs dieser Einheit. Das Schutzgerät misst die Netzseite, die Steuerung die Batterieseite; übereinstimmende Kennungen machen daraus eine Speichereinheit statt zweier halb gemessener.

Die Live-Sonde ausführen

Der Schritt Sonde öffnet einen kurzlebigen Probelauf gegen das Gerät. Der Agent liest, was das Gerät bereitstellt, und streamt Live-Stichproben zurück – sie werden jede Sekunde aktualisiert, und der untere Protokollstreifen zeigt den zugrunde liegenden Austausch.

Warten Sie, bis Stichproben erscheinen. Der Verbindungs-Badge wechselt zu Sondieren und stabilisiert sich, sobald Messwerte fließen.
Wenn nichts eintrifft, wiederholt der Assistent den Versuch einige Male automatisch. Kann das Gerät weiterhin nicht erreicht werden, erhalten Sie eine eindeutige Meldung und eine Schaltfläche Erneut verbinden, um es noch einmal zu versuchen.
Eine stockende Sonde bedeutet fast immer, dass das Gerät vom Agent aus nicht erreichbar ist – prüfen Sie, ob die Erkennung es noch sieht und ob der VPN-Tunnel besteht.

Die Sonde ist schreibgeschützt

Die Sonde verändert das Gerät niemals und speichert von sich aus nichts. Sie existiert, damit Sie bestätigen können, dass das Gerät antwortet, und seine echten Werte sehen, bevor Sie den Logger festlegen.

Die Werte eines generischen Loggers zuordnen

Manche Logger sind generisch – sie stellen eine lange Liste von Rohwerten bereit, die die Plattform nicht von sich aus interpretieren kann (ein Leistungszähler, ein Pyranometer und ein Dutzend weiterer Kanäle hinter einem Gerät, jeder in der geräteeigenen Bezeichnungsweise benannt). Für diese führt der Assistent statt einer Nur-Lese-Vorschau einen interaktiven Zuordnungsablauf aus:

Im Schritt Werte zuordnen zählt der Agent jeden vom Gerät bereitgestellten Rohwert auf und streamt sie mit ihrer Gruppe, ihrem Namen, ihrer Einheit und einer Live-Stichprobe zurück. Sie erhalten eine durchsuchbare Tabelle.
Wählen Sie für jeden relevanten Rohwert aus dem Dropdown die bekannte Metrik aus, die er repräsentiert. Lassen Sie den Rest unzugeordnet. Sie können bei Bedarf pro Wert das Vorzeichen invertieren; Einheitenpräfixe (kW, kWh, …) werden automatisch auf SI-Basiseinheiten umgerechnet.
Der Schritt Probelauf lässt das Gerät erneut durch Ihre Zuordnung laufen und zeigt die genauen Metriken an, die erzeugt würden – Ihr Kontrollpunkt zum Bestätigen oder Ablehnen.
Die Zusammenfassung bestätigt, was gespeichert wird.

Erweiterte Einstellungen pro Wert

Jeder zugeordnete Wert besitzt ein standardmäßig eingeklapptes Feld Erweiterte Einstellungen – die meisten Werte benötigen davon nichts. Öffnen Sie es, wenn das Gerät einen Wert liefert, der vor der Veröffentlichung umgeformt werden muss:

Faktor – den Messwert multiplizieren (z. B. ein Impulszähler, dessen einzelner Impuls 200 Wh entspricht). Wird zusätzlich zur automatischen Einheitenumrechnung angewendet.
Obergrenze / Untergrenze – Messwerte außerhalb dieses Bereichs verwerfen, statt sie zu veröffentlichen. Sinnvoll bei Geräten, die eine Ausreißerspitze senden, wenn ihr Eingang nicht gelesen wird.
Werte ignorieren – bestimmte Rohwerte vollständig verwerfen, kommagetrennt (z. B. 0 bei einem Zähler, der null meldet, solange sein Eingang getrennt ist).
Vorzeichen umkehren – die Richtung Bezug/Einspeisung tauschen.

Ein leer gelassenes Feld wird gar nicht angewendet. Alles, was Sie setzen, erscheint als kurzes Kürzel (×200 · ≥-10000) in der Wertezeile und erneut im Schritt Zusammenfassung, sodass Sie die gesamte Zuordnung vor dem Speichern prüfen können.

Es werden nur die von Ihnen zugeordneten Werte erfasst, und jeder Rohwert wird genau einer Metrik zugeordnet.

Messwerte zuordnen (manuelle Override-Adapter)

Bei nicht-generischen Adaptern, die dennoch einen Konfigurationsschritt bereitstellen, zeigt der Schritt Konfiguration jeden Messwert, den die Sonde gefunden hat, und lässt Sie auswählen, welche erfasst werden sollen, das Abfrageintervall festlegen und Korrekturen pro Messwert anwenden (zum Beispiel das Invertieren eines Vorzeichens). Wenn Sie fortfahren, sondiert die Plattform mit Ihrer Konfiguration erneut, sodass der Schritt Zusammenfassung die Werte genau so anzeigt, wie sie gespeichert werden.

Speichern

Klicken Sie im letzten Schritt – Zusammenfassung bei manuellen Adaptern oder dem Schritt Sonde selbst bei konfigurationsfreien Geräten – auf Logger speichern (oder Hinzufügen bei konfigurationsfreien Geräten). Der Logger wird als ausstehende Änderung gespeichert. Es erreicht noch nichts den Agent.

Ihre Änderungen anwenden

Neue Logger, Bearbeitungen und Entfernungen werden zwischengespeichert, bis Sie sie in einem Stapel an den Agent veröffentlichen.

Nehmen Sie alle gewünschten Logger-Änderungen vor.
Klicken Sie oben auf der Seite Datenfluss auf Änderungen anwenden (sie zeigt N ausstehende Änderung(en) anwenden, wenn Sie in dieser Sitzung welche in die Warteschlange gestellt haben).
Der Agent wird mit der neuen Konfiguration neu bereitgestellt und beginnt kurz darauf mit der Erfassung.

Anwenden ist immer sicher

Sie können Änderungen anwenden jederzeit drücken – wenn es nichts Neues zu veröffentlichen gibt, geschieht nichts. Nach einer Seitenaktualisierung wird der Zähler ausstehender Änderungen auf null zurückgesetzt, verwenden Sie also Änderungen anwenden, um sicherzugehen, dass die neueste Konfiguration aktiv ist.

Vorhandene Logger verwalten

Die Tabelle Datenlogger listet alles auf, was für die Anlage konfiguriert ist, mit Suche, Sortierung und Zustand pro Logger. Über das Aktionsmenü ⋮ in jeder Zeile können Sie:

Logger bearbeiten – die Konfiguration des Loggers anpassen.
Netzwerkgerät bearbeiten – zum Gerät auf der Netzwerkseite springen, um dessen IP, Anmeldedaten, SNMP oder Proxy-Einstellungen zu ändern (diese befinden sich an einem Ort und werden hier nicht dupliziert).
Pausieren / Fortsetzen – die Erfassung für ein gewähltes Zeitfenster (15 Minuten bis zu 24 Stunden) vorübergehend stoppen und wieder aufnehmen. Nützlich während Wartungsarbeiten, damit ein bekannter Ausfall keine Ereignisse auslöst.
Logger entfernen – einen Logger löschen, den Sie über den Assistenten hinzugefügt haben.

Das Entfernen oder Pausieren eines Loggers ist ebenfalls eine ausstehende Änderung – denken Sie daran, anschließend Änderungen anwenden auszuführen.

Was über den Assistenten angebunden werden kann

Drei Arten von Geräten werden über den Assistenten angebunden:

Konfigurationsfreie Familien – der Adapter kennt bereits den vollständigen Messwertsatz des Geräts, sodass Sie nur die Live-Sonde bestätigen und speichern. Heute gehören dazu Janitza-Zähler (keine Anmeldedaten nötig), Huawei SmartLogger, Phoenix Contact-Controller, SMA Sunny Central, SMA Power Manager und Sungrow Logger.
Generische Logger – Geräte, die beliebige Rohwerte bereitstellen, die die Plattform nicht von sich aus interpretieren kann. Diese werden über den oben beschriebenen interaktiven Ablauf Werte zuordnen → Probelauf angebunden, bei dem Sie jeden Rohwert einer bekannten Metrik zuordnen. QReader und blue'Log werden auf diese Weise angebunden.
Manuell hinzuzufügende Adapter – eine Familie, die die Plattform vollständig liest, bei der sie aber niemals raten darf. Heute ist das die WAGO PFC200 Alarm-SPS: Sie liest die Kontakte der Alarmanlage eines Standorts über rein lesenden Modbus TCP ohne Anmeldedaten — aber eine WAGO ist eine leere Steuerung, die jeder Integrator anders programmiert, und auf dem Draht steht nicht, welches Programm läuft. Deshalb wird sie nie unter Mögliche Logger angeboten: Nutzen Sie Logger hinzufügen, wählen Sie den Adapter und setzen Sie das Integrator-Profil (heute abo_uegs), optional eine Kennung der Alarmanlage und alle nicht verdrahteten Kontakte. Die Live-Sonde zeigt anschließend den Zustand jedes Kontakts, bevor Sie speichern.

Gerätefamilien außerhalb aller drei Gruppen funktionieren ebenfalls, sind heute aber nicht über den Assistenten anbindbar: Sie benötigen eine gerätespezifische Konfiguration, die Mirox vorbereitet und mit dem Agent ausliefert. Betrachten Sie die Onboarding-Automatisierung als gerätespezifisch, nicht als universell.

Ihr Gerät ist nicht aufgeführt?

Wenn Ihre Ausrüstung von keinem vorhandenen Adapter abgedeckt wird, baut Mirox einen – oft sogar für ältere Geräte oder undokumentierte Schnittstellen, solange das Gerät seine Daten irgendwie bereitstellt. Klicken Sie unterhalb der Tabelle Mögliche Logger auf Support für Datenlogger anfragen (die Adapterauswahl im Assistenten verlinkt auf dieselbe Anfrage); Anlagen- und Gerätedaten werden automatisch angehängt, und neue Geräte sind in der Regel innerhalb eines Tages angebunden.

Schritt für Schritt: Eine Integration anfragen.

Um zu verstehen, wie Adapter das Protokoll jedes Geräts sprechen, Einheiten normalisieren und Komponenten erkennen, lesen Sie die Architekturseite Data Scraper – diese Anleitung wiederholt das absichtlich nicht.

Eine handgeschriebene Konfiguration migrieren

Eine kleine Zahl von Anlagen, die vor Einführung des Assistenten angebunden wurden, läuft weiterhin mit einer handgeschriebenen Konfiguration (einem Legacy-Overlay) statt der Konfiguration, die die Plattform heute aus ihren Logger-Einträgen erzeugen würde. Für diese steht Mirox-Systemadministratoren im Tab Datenfluss → Agent-Konfiguration der Anlage eine Migrationsansicht zur Verfügung, die zeigt, wie ein Wechsel weg vom Overlay aussehen würde, bevor sich etwas ändert:

die Konfiguration, die die Plattform ohne das Legacy-Overlay erzeugen würde,
ein Diff gegenüber dem an der Anlage aktuell aktiven Overlay, und
pro Logger, ob der Generator bereits einen Eintrag dafür erzeugen kann und was noch fehlt (eine ungelöste Wechselrichter-Identität, eine fehlende String-Überwachungs-Zuordnung, ein noch nicht erfasstes Geräteinventar und Ähnliches).

Von dort aus kann ein Administrator einen einzelnen Logger erneut sondieren, um Fehlendes zu ergänzen, das Overlay löschen und die erzeugte Konfiguration bereitstellen – ohne dass eine Komponente umbenannt oder ihre Historie verloren wird. Dies ist ein internes Migrationswerkzeug, keine kundenseitige Einstellung: Es existiert, damit die letzten handgeschriebenen Anlagen auf dieselbe erzeugte Konfiguration wechseln können, die jede andere Anlage bereits verwendet.