Skip to content

Messdatenweiterleitung

Konnektoren konfigurieren - Integration mit externen Diensten

Jedes in die Evrlast-Plattform integrierte Gerät kann sogenannte Konnektoren bedienen.

In der Geräte-Ansicht im Reiter Konfiguration können im Abschnitt Konnektoren mehrere sog. Konnektoren über den Button „Hinzufügen“ angelegt werden und später auch aktiviert werden.

Die Konnektoren ermöglichen es, die empfangenen Messwerte an beliebige Dienste weiterzuleiten.

Externer MQTT-Konnektor

Ein MQTT-Konnektor kann die empfangenen Sensordaten an aus dem Internet erreichbare MQTT-Broker weiterreichen. Hierzu werden die Verbindungsdaten und das gewünschte Topic, unter dem die Nachrichten publiziert werden sollen, festgelegt.

Eine Beispiel-Konfiguration zum Publizieren auf einem der Test-Broker (unverschlüsselt, mit Authentifizierung) von mosquitto.org kann wie folgt aussehen:

Konnektoren_erstellen

Unterstützt werden MQTT (unverschlüsselte Übertragung) und MQTTS (verschlüsselte Übertragung) MQTT-Broker, mit und ohne Authentifizierung am Broker über Benutzernamen und Passwort.

Verbindung im Konnektor direkt testen

Neben dem Button „Speichern" steht der Button „Verbindung testen" zur Verfügung. Damit lässt sich prüfen, ob die eingetragene Konfiguration funktioniert. MQTT Verbindung testen

So testen Sie die Verbindung:

  1. Klicken Sie auf „Verbindung testen". Es öffnet sich das Fenster „MQTT Verbindung testen".

  2. Das Fenster enthält eine vorausgefüllte Testnachricht im JSON-Format: in der gleichen Struktur wie reguläre Messwerte. Sie können die Nachricht bei Bedarf direkt im Fenster bearbeiten.

  3. Über „Senden" wird die Testnachricht mit den aktuell im Formular eingetragenen Verbindungseinstellungen (Broker-Adresse, Port, Topic, Authentifizierung) auf dem angegebenen Topic veröffentlicht.

  4. Eine Snackbar meldet anschließend zurück, ob die Veröffentlichung erfolgreich war oder fehlgeschlagen ist.

Kein vorheriges Speichern nötig

Der Test verwendet immer die aktuell im Formular eingetragenen Parameter. Geänderte Werte müssen dafür nicht zuerst gespeichert werden. So können Sie verschiedene Einstellungen schnell ausprobieren, bevor Sie den Konnektor endgültig speichern.

Evrlast MQTT Broker

Der Evrlast MQTT Broker ist ein von uns betriebener MQTT-Broker, über den Sie die Messdaten Ihrer Geräte direkt aus der Evrlast Cloud per MQTT abonnieren können. Anders als beim externen MQTT-Konnektor müssen Sie keinen eigenen Broker bereitstellen - die Verbindungsdaten werden automatisch erzeugt, sobald Sie den internen Konnektor an einem Gerät aktivieren.

Pro aktiviertem Gerät stellt der Evrlast MQTT Broker ein eindeutiges Topic bereit, auf dem alle neuen Messwerte des Geräts in Echtzeit publiziert werden. Sie verbinden sich mit Ihrem API Key (Erstellen eines API-Keys) als Zugangsdaten und können die Nachrichten in beliebigen MQTT-Clients (z. B. MQTT Explorer, MQTTX, mosquitto_sub, Node-RED, Home Assistant) weiterverarbeiten.

Evrlast MQTT Broker an einem Gerät aktivieren

  1. Öffnen Sie in der Evrlast Plattform die Geräte-Ansicht und wechseln Sie in den Reiter Konfiguration.

  2. Scrollen Sie zum Abschnitt Konnektoren und legen Sie über den Button „Hinzufügen" einen neuen Konnektor vom Typ Evrlast MQTT Broker an.

  3. Aktivieren Sie den Konnektor über den Schalter Aktiv. Direkt nach dem Speichern erzeugt das System die Verbindungsdaten und zeigt sie unterhalb des Schalters an:

    • Broker Adresse - die vollständige URL des Evrlast Brokers
    • Protokoll - immer SSL (verschlüsselte Verbindung über Port 8883)
    • URL - der Host des Brokers
    • Port - 8883
    • Topic - das gerätespezifische Topic, auf dem die Messwerte publiziert werden

  4. Über die Kopieren-Buttons rechts neben jedem Feld übernehmen Sie die Werte direkt in Ihren MQTT-Client.

Zugangsdaten

Als Benutzername und Passwort für den Broker verwenden Sie Ihren persönlichen API Key sowie das zugehörige API Key Secret aus Ihrem Benutzerprofil. Sie sehen Ihre vorhandenen Keys oder erstellen einen neuen Key über die Anleitung Erstellen eines API-Keys.

Nachrichtenformat

Pro Messwert publiziert der Evrlast Broker eine JSON-Nachricht auf dem gerätespezifischen Topic. Das Format entspricht dem des externen MQTT-Konnektors:

{
    "date": "2024-09-01T15:11:44.000+00:00",
    "deviceId": "6543892042e2b408a20d76ab",
    "deviceName": "MeineStation",
    "sensorId": "66471f347e91111285eef3fc",
    "sensorName": "MeinSensor",
    "value": 9385.0,
    "unit": "mm"
}

Verbindung testen

Am einfachsten testen Sie die Verbindung mit einem grafischen MQTT-Client. Bewährt haben sich:

Beide sind kostenlos, für Windows verfügbar und benötigen keine zusätzliche Konfiguration. Tragen Sie in der Verbindungsmaske die Werte aus dem Konnektor-Panel ein:

Feld im MQTT-Client Wert
Protocol / Scheme mqtts (TLS)
Host / URL URL aus dem Konnektor
Port 8883
Username Ihr API Key
Password Ihr API Key Secret

Nach erfolgreichem Verbindungsaufbau abonnieren Sie das Topic aus dem Konnektor-Panel und erhalten ab dem nächsten Messwert die Nachrichten in Echtzeit.

Hinweis MQTT Explorer / GUI-Clients

In der Topic-Übersicht der meisten GUI-Clients wird nur der zuletzt empfangene Wert angezeigt. Die vollständige Nachrichten-Historie der aktuellen Sitzung finden Sie üblicherweise in einem separaten History- oder Messages-Panel des jeweiligen Clients.

Wann der Evrlast MQTT Broker, wann ein externer Broker?

Beide Konnektor-Arten lassen sich pro Gerät parallel aktivieren. Welche Variante für Sie passt, hängt davon ab, wo die Daten weiterverarbeitet werden:

Anwendungsfall Empfehlung
Sie möchten Messwerte mit eigenen Tools, Skripten oder Drittsystemen weiterverarbeiten und betreiben keinen eigenen MQTT-Broker. Evrlast MQTT Broker
Sie betreiben bereits einen MQTT-Broker (z. B. im Firmennetz, in einer Smart-Home-Zentrale, in einem Industriegateway) und möchten die Evrlast-Messwerte dort einspeisen. Externer MQTT-Konnektor
Sie möchten Messwerte an einen Dienst weiterleiten, der bereits eine MQTT-Anbindung hat (Node-RED, Home Assistant, Grafana via MQTT-Datasource etc.). Evrlast MQTT Broker
Sie integrieren mehrere Datenquellen aus unterschiedlichen Systemen und wollen alle Nachrichten in einem zentralen, von Ihnen verwalteten Broker bündeln. Externer MQTT-Konnektor
Sie sind sich unsicher und möchten möglichst schnell auf die Daten zugreifen. Evrlast MQTT Broker

Kurz zusammengefasst:

  • Evrlast MQTT Broker = nichts selbst betreiben, sofort verbinden, Authentifizierung per API Key.
  • Externer MQTT-Konnektor = volle Kontrolle über den Broker, eigene ACLs/Topics, Integration in eine bestehende MQTT-Landschaft.