Überblick

Konnektoren sind die Schnittstellen, über die niotix mit der Außenwelt verknüpft wird. Jeder Konnektor ist auf einer eigenen Seite dokumentiert, gegliedert nach eingehenden und ausgehenden Konnektoren; die drei MQTT-Konnektoren sind wegen ihres engen Zusammenhangs gemeinsam auf der Seite MQTT-Konnektoren beschrieben.

Eingehende Konnektoren binden externe Datenquellen und Plattformen an. Typisch sind LoRaWAN-Netzwerk-Server (z.B. Firefly, ChirpStack, Things Stack, Loriot), dazu generische Eingänge wie MQTT (Incoming) und Webhook (Incoming); je nach Setup kommen weitere Quellen (z.B. LwM2M Server) hinzu. Sie sind der Einstieg in niotix: Sie liefern Roh- oder Prozessdaten und halten – wo der Konnektor das vorsieht – Gerätebestände zwischen niotix und externen Plattformen konsistent, sodass Datenaufnahme und Lifecycle an einer Stelle zusammenlaufen können.

Funktionsprofile unterscheiden sich je nach Konnektor. Möglich sind u.a.:

• Gerätemanagement — Synchronisation von Anlegen, Lesen, Aktualisieren und Löschen mit dem externen System
• Datenquelle für Virtuelle Geräte und/oder Digitale Zwillinge
• Regeln/Kommandos (z.B. Downlinks an Endgeräte)
• reine Datenaufnahme ohne die obigen Profile

So lässt sich pro Schnittstelle klar definieren, ob niotix primär Daten empfängt, Geräte spiegelt oder beides kombiniert. Für unterstützte Netzwerk-Server und Protokolle vereinheitlicht niotix das Lifecycle-Management der Endgeräte: Statt Geräte und Metadaten parallel in mehreren Oberflächen zu pflegen, bleibt niotix die führende Stelle für Anlage, Import, Aktualisierung und Löschung in Richtung des jeweiligen Zielsystems – im Rahmen der jeweiligen Konnektor-Fähigkeiten.

Für Firefly als LoRaWAN-Netzwerkserver ergänzt die Dokumentation Firefly / LoRaWAN-System die Konnektor-Konfiguration um betriebliche Themen wie Organisation, Geräte, Gateways und Architektur.

Ausgehende Konnektoren übertragen Daten an nachgelagerte Systeme, u.a. über Webhook (Outgoing), MQTT (Outgoing), kafka, Websocket oder mqttbroker. Einsatz u.a. bei Alarmen, Zustandsänderungen, aggregierten Kennzahlen oder fortlaufender Datenweitergabe an Fachanwendungen und Integrationslandschaften (z.B. Data Lakes, OT‑Systeme, Benachrichtigungskanäle).

In Integrationsflows bilden die Schritte typischerweise eine Kette: Auslöser (z.B. neuer Messwert, Alarm) → Filter (nur für das Ziel relevante Events) → Transformationen (Struktur und Format) → ausgehender Konnektor zum Zielsystem. Filter und Transformationen reduzieren und strukturieren den Datenumfang vor der Ausleitung.

XAPI und ausgehende Konnektoren ergänzen sich: Ereignisse und aktuelle Zustände laufen in der Regel über Flows sowie Push- bzw. Streaming-Kanäle; historische Zeitreihen lassen sich bei Bedarf über die XAPI aus der Datenbank abfragen, ohne sie in denselben Echtzeit-Pfad zu legen.

Konnektorenübergreifende Funktionen

Die folgenden Funktionen stehen für alle Konnektoren gleichermaßen zur Verfügung:

Anlegen eines Konnektors

Um einen neuen Konnektor hinzuzufügen, wähle im Anlegen-Dialog den Typ des Konnektors aus. Der Pfeil neben dem Namen des Konnektors im Menü zeigt an, ob es sich um einen eingehenden Konnektor (Pfeil nach unten) zum Daten-Empfang in niotix oder einen ausgehenden Konnektor (Pfeil nach oben) zum Daten-Versand handelt. Im Anschluss an die Auswahl werden die benötigten Konnektoreinstellungen angezeigt.

Für alle Konnektoren gilt: Beim ersten Anlegen im Dialog lautet die Schaltfläche „Validieren & Speichern“; in der Konnektor-Detailansicht (nach dem Speichern) heißt sie „Sichern“ – jeweils wird zuerst validiert und bei erfolgreicher Prüfung gespeichert. Zum Löschen dient in der Konnektorliste das Papierkorb-Symbol; die Löschung erfolgt nach Bestätigung im Dialog.

Konnektor Logs

Nachdem ein Konnektor angelegt wurde, sind die Details über das Stift-Symbol in der Liste erreichbar und dort bearbeitbar. Im Tab Konnektor Logs werden die letzten 100 vom Konnektor verarbeiteten Datenpakete (eingehend und ausgehend) mit Zeitstempel und Payload angezeigt; die Liste lässt sich aktualisieren und durchsuchen. Die Suche umfasst sowohl Payload als auch Metadaten; der Suchbegriff wird in der URL gespeichert, sodass gefilterte Ansichten als Link geteilt werden können. Das unterstützt die Fehlersuche, wenn Daten nicht wie erwartet ankommen.

Status Logs

Im Tab Status Logs derselben Detailansicht ist ein Verbindungsprotokoll mit den letzten 100 Statusmeldungen (u.a. erfolgreiche und fehlgeschlagene Verbindungsversuche) zu finden, ebenfalls mit Aktualisieren und Suche. Auch das dient der Fehlersuche bei Verbindungsproblemen.

Konnektor-Überwachung

Für die meisten Konnektortypen steht in der Detailansicht zusätzlich der Tab Überwachung zur Verfügung. Dort werden Paketzahlen und Konnektorzustände als Zeitreihen erfasst und über Überwachungsregeln ausgewertet — etwa um ausbleibende Daten, dauerhafte Fehlerzustände oder fehlgeschlagene Auslieferungen zu melden. Meldungen entstehen als Eintrag im Alarmprotokoll und optional per E-Mail.

Details zu Regeltypen, Schwellenwerten, Standardwerten und Limits: Konnektor-Überwachung.

Übersicht der verfügbaren Konnektoren und der Funktionen

Die Tabellen sind nach eingehenden und ausgehenden Konnektoren getrennt — entsprechend der Einordnung in der Oberfläche (Pfeil nach unten bzw. nach oben im Menü).

Eingehende Konnektoren

Ausgehende Konnektoren

Beschreibung der Funktionen

• Gerätemanagement: Der Konnektor bietet eine Gerätesynchronisation mit dem externen System (Anlegen, Lesen, Aktualisieren, Löschen); je nach Konnektor können einzelne Operationen fehlen (z. B. ohne vollständiges Lesen aus dem Zielsystem).
• Datenpunkt Virtuelles Gerät: Der Konnektor kann als Quelle für Datenpunkte im Virtuellen Gerät verwendet werden
• Datenpunkt Digitaler Zwilling: Der Konnektor kann als Quelle für Datenpunkte im Digitalen Zwilling verwendet werden
• Regeln: Der Konnektor kann zum Senden von Kommandos verwendet werden
• Datenweiterleitung: Der Konnektor kann zur Weiterleitung von Datenpunkten verwendet werden (Integrationsflows)

• Eingehende Konnektoren
• Ausgehende Konnektoren
• MQTT-Konnektoren
• Konnektor-Überwachung