Observação:
- Este tutorial requer acesso ao Oracle Cloud. Para se inscrever e obter uma conta gratuita, consulte Conceitos Básicos do Oracle Cloud Infrastructure Free Tier.
- Ele usa valores de exemplo para credenciais, tenancy e compartimentos do Oracle Cloud Infrastructure. Ao concluir seu laboratório, substitua esses valores por valores específicos do seu ambiente de nuvem.
Integre o ThingsBoard com o OCI Streaming Services
Introdução
ThingsBoard é uma plataforma IoT de código-fonte aberto para coleta de dados, processamento, visualização e gerenciamento de dispositivos. Este tutorial mostrará as etapas que você precisa seguir para integrar o ThingsBoard aos serviços de Streaming do Oracle Cloud Infrastructure (OCI). Dessa forma, você pode armazenar os dados em um banco de dados, fazer análises, usar funções para modificar e processar essas informações.
Objetivos
- Colete as informações necessárias da OCI.
- Configure um nó Kafka em uma cadeia de regras ThingsBoard.
Pré-requisitos
- Conhecimento básico do OCI Streaming, Kafka.
- Entendimento da cadeia de regras ThingsBoard.
- Privilégios de usuário para poder criar e acessar recursos do Streaming.
- ThingsBoard instalado em uma máquina. Você pode encontrar as etapas de instalação da Community Edition aqui.
Tarefa 1: Coletar parâmetros de vaporização do OCI necessários para integração com um servidor Kafka
-
Se você ainda não tiver criado um Fluxo do OCI, poderá seguir estas etapas para criar um novo Fluxo na console.
-
No caso de um Fluxo existente, observe as seguintes informações:
-
Abra o menu de navegação e clique em Análise e IA.
-
Em Mensagens, clique em Streaming.
-
Na guia Streams, abra seu fluxo existente e anote o Nome do Fluxo, por exemplo: thingsboard_stream
-
Clique no link Pool de Streams, por exemplo: thingsboard_stream_pool
-
No menu esquerdo, vá para Definições de Conexão do Kafka e copie as seguintes informações:
-
Servidores Bootstrap: por exemplo, cell-1.streaming.eu-frankfurt-1.oci.oraclecloud.com:9092
-
Strings de Conexão do SASL: por exemplo, *org.apache.kafka.common.security.plain.PlainLoginModule required username="
/oracleidentitycloudservice/ / " password="AUTH_TOKEN";* -
Protocolo de Segurança: SASL_SSL
-
Mecanismo de Segurança: PLAIN
-
-
No canto superior direito da tela, clique no ícone de perfil. EmPerfil do Usuário, clique em Token de Autenticação, gere um token e copie o valor: AUTH_TOKEN, por exemplo: xmo?(cv<abcd..... Você também pode usar um token existente.
-
Tarefa 2: Configurar o Nó de Regra Kafka
-
Arraste um Nó de Regra Kafka do painel de ação. Usaremos as informações anotadas na Tarefa 1 para configurar a regra Kafka.
-
Nome: por exemplo - ThingsBoard2OCIStream
-
Padrão de tópico: "StreamName", por exemplo - thingsdemo-s0
-
Servidores de inicialização: "Servidores de inicialização", por exemplo - cell-1.streaming.eu-frankfurt-1.oci.oraclecloud.com:9092
-
Outras propriedades: Clique em Adicionar e adicione os seguintes pares de chaves:
-
security.protocol: "Protocolo de Segurança" SASL_SSL
-
sasl.mechanism: PLAIN do "Mecanismo de Segurança"
-
ssl.endpoint.identification.algorithm: https
-
sasl.jaas.config: <SASL Connection Strings:>, por exemplo - *org.apache.kafka.common.security.plain.PlainLoginModule required username="
/ / " password="AUTH_TOKEN";* (substitua AUTH_TOKEN pelo valor copiado na Tarefa 1)
-
-
OBSERVAÇÃO:
Caso a string sasl.jaas.config não funcione, pode haver um problema com o Oracle Identity Cloud Service na tenancy; portanto, tente usá-la de um usuário local.
Opcional: Você também pode verificar o modo Depurar para solucionar problemas.
Depois de atualizar os valores necessários, clique no botão Marca de seleção para salvar a configuração.
Tarefa 3: Configurar a Cadeia de Regras
-
"Arraste um link" entre os blocos salvar séries de tempo e kafka, para que possamos encaminhar as séries de tempo salvas para nosso OCI Stream.
-
Informe Êxito para o label do link.
-
Clique no botão Checkmark para salvar a configuração.
-
Faça log-in na Console do OCI e verifique o Stream para confirmar se ele está recebendo dados. Clique em Carregar Mensagens.
Depois que as informações forem recebidas no OCI Streaming, você poderá usar o serviço Conector de Serviço do OCI, por exemplo, para transferi-las para outros serviços, como Armazenamento do OCI, Funções do OCI etc.
Links Relacionados
Confirmações
- Adina Nicolescu (Engenheiro de Nuvem Sênior), Guido Alejandro Ferreyra (Arquiteto de Nuvem Principal)
Mais Recursos de Aprendizagem
Explore outros laboratórios no site docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal YouTube do Oracle Learning. Além disso, visite education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.
Para obter a documentação do produto, visite o Oracle Help Center.
Integrate ThingsBoard with OCI Streaming Services
F79939-01
April 2023
Copyright © 2023, Oracle and/or its affiliates.