Nota:
- Este tutorial requiere acceso a Oracle Cloud. Para registrarse en una cuenta gratuita, consulte Introducción a Oracle Cloud Infrastructure Free Tier.
- Utiliza valores de ejemplo para las credenciales, el arrendamiento y los compartimentos de Oracle Cloud Infrastructure. Al finalizar el laboratorio, sustituya estos valores por otros específicos de su entorno en la nube.
Integrar ThingsBoard con OCI Streaming Services
Introducción
ThingsBoard es una plataforma IoT de código abierto para la recopilación, el procesamiento, la visualización y la gestión de dispositivos de datos. En este tutorial se muestran los pasos que debe seguir para integrar ThingsBoard con los servicios de transmisión de Oracle Cloud Infrastructure (OCI). De esta forma, puede almacenar los datos en una base de datos, realizar análisis, utilizar funciones para modificar y procesar esta información.
Objetivos
- Recopile la información necesaria de OCI.
- Configure un nodo de Kafka en una cadena de reglas ThingsBoard.
Requisitos
- Conocimientos básicos de OCI Streaming, Kafka.
- Descripción de la cadena de reglas ThingsBoard.
- Privilegios de usuario para poder crear y acceder a los recursos de Streaming.
- ThingsBoard instalado en una máquina. Puede encontrar los pasos de instalación de Community Edition aquí.
Tarea 1: Recopilación de los parámetros de asignación de OCI necesarios para la integración con un servidor de Kafka
-
Si aún no ha creado un flujo de OCI, puede seguir estos pasos para crear un nuevo flujo desde la consola.
-
En el caso de un flujo existente, tenga en cuenta la siguiente información:
-
Abra el menú de navegación y haga clic en Análisis y AI.
-
En Mensajería, haga clic en Flujo.
-
En el separador Flujos, abra el flujo existente y anote el nombre del flujo, por ejemplo: thingsboard_stream
-
Haga clic en el enlace Pool de flujos, por ejemplo: thingsboard_stream_pool
-
En el menú de la izquierda, vaya a Configuración de conexión de Kafka y copie la siguiente información:
-
Servidores de inicialización de datos: por ejemplo, cell-1.streaming.eu-frankfurt-1.oci.oraclecloud.com:9092
-
Cadenas de conexión SASL: por ejemplo, *org.apache.kafka.common.security.plain.PlainLoginModule required username="
/oracleidentitycloudservice/ / " password="AUTH_TOKEN";* -
Protocolo de seguridad: SASL_SSL
-
Mecanismo de seguridad: PLAIN
-
-
En la esquina superior derecha de la pantalla, haga clic en el icono de perfil. En Perfil de usuario, haga clic en Token de autenticación, genere un token y copie el valor: AUTH_TOKEN, por ejemplo: xmo?(cv<abcd..... También puede utilizar un token existente.
-
Tarea 2: Configuración del nodo de regla de Kafka
-
Arrastre un nodo de regla de Kafka desde el panel de acción. Utilizaremos la información indicada en la tarea 1 para configurar la regla de Kafka.
-
Nombre: por ejemplo: ThingsBoard2OCIStream
-
Patrón de tema: "StreamName", por ejemplo: thingsdemo-s0
-
Servidores de inicialización de datos: "Servidores de inicialización de datos", por ejemplo: cell-1.streaming.eu-frankfurt-1.oci.oraclecloud.com:9092
-
Otras propiedades: haga clic en Agregar y agregue los siguientes pares de claves:
-
security.protocol: "Protocolo de seguridad" SASL_SSL
-
sasl.mechanism: PLAIN "Mecanismo de seguridad"
-
ssl.endpoint.identification.algorithm: https
-
sasl.jaas.config: <SASL Connection Strings:>, por ejemplo: *org.apache.kafka.common.security.plain.PlainLoginModule required username="
/ / " password="AUTH_TOKEN";* (sustituya AUTH_TOKEN por el valor copiado en la tarea 1)
-
-
NOTA:
En caso de que la cadena sasl.jaas.config no funcione, puede que haya un problema con Oracle Identity Cloud Service en el arrendamiento, por lo que intente utilizarla de un usuario local.
Opcional: también puede comprobar el modo Depurar para la resolución de problemas.
Una vez que haya actualizado los valores necesarios, haga clic en el botón Marca de verificación para guardar la configuración.
Tarea 3: Configuración de la cadena de reglas
-
"Arrastre un enlace" entre los bloques horarios de ahorro y kafka, para que podamos reenviar los horarios guardados a nuestro flujo de OCI.
-
Introduzca Correcto para la etiqueta de enlace.
-
Haga clic en el botón Marca de verificación para guardar la configuración.
-
Conéctese a la consola de OCI y compruebe el flujo para confirmar que está recibiendo datos. Haga clic en Cargar mensajes.
Después de recibir la información en OCI Streaming, puede utilizar el servicio OCI Service Connector, por ejemplo, para transferirla a otros servicios como OCI Storage, OCI Functions, etc.
Enlaces relacionados
Agradecimientos
- Adina Nicolescu (Ingeniero Superior de Nube), Guido Alejandro Ferreyra (Arquitecto Principal de Nube)
Más recursos de aprendizaje
Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de Oracle Learning.
Para obtener documentación sobre los productos, visite Oracle Help Center.
Integrate ThingsBoard with OCI Streaming Services
F79939-01
April 2023
Copyright © 2023, Oracle and/or its affiliates.