Überblick

Diese Seite beschreibt den Weg der Nachrichten vom Gateway bis in niotix – bis zu dem Punkt, an dem sie in den Konnektor Logs sichtbar sind. Einordnung, Anwendungsfälle und Voraussetzungen stehen auf der Übersichtsseite MQTT-Gateways; das Auslesen des Messgeräts in der Modbus-Konfiguration.

Die Anleitung geht vom Standard-Broker der niotix-SaaS (consumers.mq.iot-hub.com, Port 8883) aus. Für private SaaS-Instanzen und On-Premise-Installationen gelten abweichende Adressen – maßgeblich sind immer die Verbindungsdaten des eigenen mqttbroker-Konnektors.

Schritt 1: mqttbroker-Konnektor anlegen

1. Unter Integrationen → Konnektoren einen neuen Konnektor vom Typ mqttbroker anlegen, Instanz-Name und Beschreibung vergeben (z. B. „Ortsnetzstationen – Gateways").
2. „Validieren & Speichern" – niotix erzeugt automatisch Parent-Topic, Benutzername und Passwort.
3. In der Konnektor-Detailansicht im Tab Verbindungsdaten die vier Angaben ablesen, die das Gateway benötigt:

Schritt 2: Gateway als MQTT-Client konfigurieren

Die Bezeichnungen der Felder unterscheiden sich je Hersteller; die Werte sind für alle Gateways gleich:

Schritt 3: Topic-Struktur festlegen

Das Topic besteht aus einem statischen Teil, der je Station einmal konfiguriert wird, und einem variablen Teil:

<parent_topic>/<namespace>/<stations_name>/<device_serial_number>/<variable_topic>

Regeln: Segmente mit genau einem / verbinden, kein / am Ende, keine Leerzeichen; nur Buchstaben, Ziffern, _ und -; die Zeichen +, # und $ sind innerhalb eines Segments nicht zulässig.

Entscheidend für den variablen Teil ist, ob das Gateway mehrere Messwerte in einer Nachricht zusammenfassen kann:

Eine Messgruppe fasst die Werte eines Messorts zusammen – beim UMG 801 das Basisgerät (basic_device: Spannungen, Geräteinformationen) und je ein Abgang (basic_device_meas_group_01, …_02, current_module_meas_group_01 …).

Variante 1: eine Nachricht je Messgruppe (T1/M1)

consumers/<uuid>/digiONS/Station_001/12345678/basic_device
consumers/<uuid>/digiONS/Station_001/12345678/basic_device_meas_group_01

Variante 2: eine Nachricht je Messwert (T2/M2)

consumers/<uuid>/digiONS/Station_001/12345678/basic_device__phaseVoltageL1Avg
consumers/<uuid>/digiONS/Station_001/12345678/basic_device_meas_group_01__currentL1Avg

Das letzte Segment ist der Extended Variable Name: Messgruppe und Variablenname, getrennt durch einen doppelten Unterstrich. So bleibt das Topic auch bei 20 Abgängen mit jeweils einem currentL1Avg eindeutig.

Schritt 4: Nachrichtenformat

Für den ersten Durchstich genügen wenige Register (siehe Minimal-Testset). Beispiel UMG 801 (1-Minuten-Mittelwerte):

{
  "ts": "2026-09-21T09:12:00Z",
  "currentL1Avg": 12.3,
  "totalActivePowerAvg": 8450.0
}

{
  "ts": "2026-09-21T09:12:00Z",
  "value": 230.4
}

• M1: ein Zeitstempel für alle Werte der Messgruppe; die Schlüssel sind die Variablennamen der Registerliste, flach – keine Verschachtelung, keine Arrays. Die Messgruppe basic_device sendet Spannungen und Geräteinformationen auf dieselbe Weise auf ihr eigenes Topic.
• M2: je Messwert eine Nachricht; value ist ein einzelner Skalar im Datentyp der Registerliste (Fließkommazahl mit Dezimalpunkt, Zähler als Integer, Meldungen als Boolean).

Für beide Varianten gilt:

• ts – ISO-8601-String in UTC, Format YYYY-MM-DDThh:mm:ssZ, z. B. "2026-09-21T09:12:00Z"; Millisekunden (…:00.123Z) und die Schreibweise +00:00 sind zulässig, lokale Zeit ohne Zonenangabe oder Unix-Zeitstempel nicht. Der Zeitstempel ist der Zeitpunkt der Modbus-Abfrage und wird vom Gateway gesetzt.
• Werte als JSON-Number (kein String), Einheiten wie vom Messgerät geliefert (V, A, W, var). Umrechnungen wie W → kW erfolgen zentral in niotix, nicht im Gateway.
• Gültiges JSON: Der Zeitstempel steht in Anführungszeichen. Ungültiges JSON wird von niotix als Rohstring weitergereicht und lässt sich nicht weiterverarbeiten.

Schritt 5: MQTT (Incoming)-Konnektor anlegen

Unter Integrationen → Konnektoren einen Konnektor vom Typ MQTT (Incoming) anlegen und mit den Verbindungsdaten des mqttbroker aus Schritt 1 füllen:

Mit „Validieren & Speichern" baut niotix die Verbindung zum Broker auf und abonniert das Topic. Alle Einstellungen im Detail: MQTT (Incoming).

Verbindung prüfen

In dieser Reihenfolge, damit jede Ebene einzeln geprüft wird:

1. Status Logs des MQTT (Incoming)-Konnektors (Stift-Symbol in der Konnektorliste → Tab Status Logs): Die Verbindung von niotix zum Broker steht – erfolgreiche Verbindungsversuche erscheinen als Statusmeldung.
2. Das Gateway publiziert das kleine Test-Set aus Schritt 4.
3. Konnektor Logs (Tab Konnektor Logs derselben Detailansicht): Jede empfangene Nachricht erscheint als Paket mit dem Topic und dem geparsten Payload unter value (Beispiel unten).
4. Für den Dauerbetrieb eine Konnektor-Überwachung einrichten, damit ausbleibende Nachrichten einer Station gemeldet werden.

So sieht ein Paket der Variante 1 in den Konnektor Logs aus:

{
  "ts": "2026-09-21T09:12:00Z",
  "currentL1Avg": 12.3,
  "totalActivePowerAvg": 8450.0,
  "topic": "consumers/<uuid>/digiONS/Station_001/12345678/basic_device_meas_group_01",
  "value": {
    "ts": "2026-09-21T09:12:00Z",
    "currentL1Avg": 12.3,
    "totalActivePowerAvg": 8450.0
  }
}

Die Suche in den Konnektor Logs umfasst Payload und Metadaten – nach Seriennummer, Stationsname oder Variablenname filtern. Der Suchbegriff wird in der URL gespeichert, sodass eine gefilterte Ansicht als Link weitergegeben werden kann. Details: Konnektor Logs.

Fehlerbehebung

Nächste Schritte

Sobald die Nachrichten in den Konnektor Logs sichtbar sind, folgt die Zuordnung zu Datenpunkten. Dafür wird im Feld Template des MQTT (Incoming)-Konnektors eine JavaScript-Transformation hinterlegt, die jede Nachricht in das niotix-Standardformat überführt. Je nach Anwendungsfall gehen die Daten direkt an einen Digitalen Zwilling oder zunächst an ein Virtuelles Gerät:

Format und Beispiele: Datenformat für eingehende Daten; Template-Editor: Eingehende Konnektoren; Referenz-Id und Datenpunkte am Zwilling: Dynamisches Datenrouting; Parsen und Mappen am Virtuellen Gerät: Gerätetreiber.

Verwandte Themen

• MQTT-Gateways – Überblick und Voraussetzungen
• Modbus-Konfiguration
• MQTT-Konnektoren – mqttbroker, MQTT (Incoming), TLS und Zertifikate
• Konnektoren – Konnektor Logs und Status Logs
• Konnektor-Überwachung
• Firewall-Whitelist
• Datenformat für eingehende Daten