Hinweis:
- Dieses Tutorial erfordert Zugriff auf Oracle Cloud. Informationen zum Anmelden für einen kostenlosen Account finden Sie unter Erste Schritte mit Oracle Cloud Infrastructure Free Tier.
- Es verwendet Beispielwerte für Oracle Cloud Infrastructure-Zugangsdaten, -Mandanten und -Compartments. Wenn Sie Ihre Übung abgeschlossen haben, ersetzen Sie diese Werte durch die Werte, die für Ihre Cloud-Umgebung spezifisch sind.
ThingsBoard mit OCI Streaming Services integrieren
Einführung
ThingsBoard ist eine Open Source IoT-Plattform für die Datenerfassung, Verarbeitung, Visualisierung und Geräteverwaltung. In diesem Tutorial werden die Schritte dargestellt, die Sie ausführen müssen, um ThingsBoard mit Oracle Cloud Infrastructure-(OCI-)Streaming-Services zu integrieren. Auf diese Weise können Sie die Daten in einer Datenbank speichern, Analysen durchführen und diese Informationen mit Funktionen ändern und verarbeiten.
Ziele
- Erfassen Sie die erforderlichen Informationen von OCI.
- Konfigurieren Sie einen Kafka-Knoten in einer ThingsBoard-Regelkette.
Voraussetzungen
- Grundlegende Kenntnisse von OCI Streaming, Kafka.
- Erläuterungen zur ThingsBoard-Regelkette.
- Benutzerberechtigungen zum Erstellen und Zugriff auf Streamingressourcen.
- ThingsBoard auf einem Rechner installiert. Die Schritte zur Installation von Community Edition finden Sie hier.
Aufgabe 1: Für die Integration mit einem Kafka-Server erforderliche OCI-Benennungsparameter erfassen
-
Wenn noch kein OCI-Stream erstellt wurde, können Sie diese Schritte ausführen, um einen neuen Stream über die Konsole zu erstellen.
-
Beachten Sie bei einem vorhandenen Stream die folgenden Informationen:
-
Öffnen Sie das Navigationsmenü, und klicken Sie auf Analysen und KI.
-
Klicken Sie unter Messaging auf Streaming.
-
Öffnen Sie auf der Registerkarte Streams den vorhandenen Stream, und notieren Sie den Streamnamen. Beispiel: thingsboard_stream
-
Klicken Sie auf den Link Streampool. Beispiel: thingsboard_stream_pool

-
Gehen Sie im linken Menü zu Kafka-Verbindungseinstellungen, und kopieren Sie die folgenden Informationen:
-
Bootstrap-Server: Beispiel: cell-1.streaming.eu-frankfurt-1.oci.oraclecloud.com:9092
-
SASL-Verbindungszeichenfolgen: Beispiel: *org.apache.kafka.common.security.plain.PlainLoginModule required username="
/oracleidentitycloudservice/ / " password="AUTH_TOKEN";* -
Sicherheitsprotokoll: SASL_SSL
-
Sicherheitsverfahren: PLAIN

-
-
Klicken Sie in der oberen rechten Ecke des Bildschirms auf das Profilsymbol. Klicken Sie unter Benutzerprofil auf Authentifizierungstoken, generieren Sie ein Token, und kopieren Sie den Wert: AUTH_TOKEN. Beispiel: xmo?(cv<abcd..... Sie können auch ein vorhandenes Token verwenden.
-
Aufgabe 2: Kafka-Regelknoten konfigurieren

-
Ziehen Sie einen Kafka-Regelknoten aus dem Aktionsbereich. Wir verwenden die in Aufgabe 1 angegebenen Informationen zur Konfiguration der Kafka-Regel.
-
Name: Beispiel: ThingsBoard2OCIStream
-
Themenmuster: "StreamName", Beispiel: thingsdemo-s0
-
Bootstrap-Server: "Bootstrap-Server", Beispiel: cell-1.streaming.eu-frankfurt-1.oci.oraclecloud.com:9092
-
Weitere Eigenschaften: Klicken Sie auf Hinzufügen, und fügen Sie die folgenden Schlüsselpaare hinzu:
-
security.protocol: "Sicherheitsprotokoll" SASL_SSL
-
sasl.mechanism: "Sicherheitsmechanismus" - PLAIN
-
ssl.endpoint.identification.algorithm: HTTPS
-
SASL.jaas.config: <SASL-Verbindungszeichenfolgen:>, z.B. - *org.apache.kafka.common.security.plain.PlainLoginModule required username="
/ / " password="AUTH_TOKEN";* (ersetzen Sie AUTH_TOKEN durch den in Aufgabe 1 kopierten Wert)
-
-
HINWEIS:
Falls die Zeichenfolge sasl.jaas.config nicht funktioniert, kann es im Mandanten zu einem Problem mit Oracle Identity Cloud Service kommen. Versuchen Sie daher, diese Zeichenfolge von einem lokalen Benutzer zu verwenden.
Optional: Sie können auch den Debug-Modus zur Fehlerbehebung prüfen.
Nachdem Sie die erforderlichen Werte aktualisiert haben, klicken Sie auf die Schaltfläche Checkmark, um die Konfiguration zu speichern.
Aufgabe 3: Regelkette konfigurieren

-
Ziehen Sie einen Link zwischen den Blöcken Zeitreihen speichern und kafka, damit wir die gespeicherten Zeitreihen an unseren OCI-Stream weiterleiten können.
-
Geben Sie Erfolgreich als Linklabel ein.
-
Klicken Sie auf das Häkchen, um die Konfiguration zu speichern.
-
Melden Sie sich bei Ihrer OCI-Konsole an, und prüfen Sie den Stream, um zu bestätigen, dass er Daten empfängt. Klicken Sie auf Nachrichten laden.

Nachdem die Informationen in OCI Streaming empfangen wurden, können Sie den OCI Service Connector-Service verwenden, um sie beispielsweise an andere Services wie OCI Storage, OCI Functions usw. zu übertragen.
Verwandte Links
Bestätigungen
- Adina Nicolescu (Senior Cloud Engineer), Guido Alejandro Ferreyra (Principal Cloud Architect)
Weitere Lernressourcen
Sehen Sie sich andere Übungen zu docs.oracle.com/learn an, oder greifen Sie auf weitere kostenlose Lerninhalte im Oracle Learning YouTube-Kanal zu. Besuchen Sie außerdem die Website education.oracle.com/learning-explorer, um Oracle Learning Explorer zu werden.
Produktdokumentation finden Sie im Oracle Help Center.
Integrate ThingsBoard with OCI Streaming Services
F79939-01
April 2023
Copyright © 2023, Oracle and/or its affiliates.