InfluxDB Integrado (via TTS)

InfluxDB é um banco de dados de séries temporais de código aberto, com foco em leitura de alto desempenho, escrita de alto desempenho, armazenamento eficiente e análise em tempo real de grandes quantidades de dados de séries temporais. Além de protocolos nativos como HTTP e UDP, também é compatível com protocolos de comunicação de componentes como CollectD, Graphite, OpenTSDB e Prometheus. Amplamente utilizado em monitoramento DevOps, monitoramento de IoT, análise em tempo real e outros cenários.

O conteúdo deste capítulo orientará os usuários sobre como conectar o SenseCAP T1000 Tracker ao InfluxDB por meio do TTN.

Antes de iniciar a configuração, verifique Connect SenseCAP T1000 to TTS para conectar primeiro o seu SenseCAP T1000 Tracker ao TTS.

Preparação

Antes de configurar o InfluxDB, precisamos instalar o agente Telegraf (versão 1.9.2 ou superior).

Telegraf Configuration

Configurar o InfluxDB Cloud

Faça login no seu InfluxDB Cloud.

Criar Bucket

Na guia Buckets.

Clique no botão Create Bucket para criar um novo bucket.

Dê um nome ao seu bucket, escolha por quanto tempo os dados permanecerão no banco de dados e clique em Create.

Gerar Tokens

Navegue até a guia API TOKENS e clique no botão GENERATE API TOKEN para criar um token.

Configurar o Telegraf

Integração MQTT

Esta seção mostra como configurar seu agente Telegraf com o plugin MQTT Consumer usado para conectar ao servidor MQTT do TTS.

Navegue até a guia TELEGRAF e clique em CREATE CONFIGURATION

Selecione o bucket que criamos antes e selecione system.

Dê um nome à sua configuração, selecione Create and Verify e depois Finish.

Depois de ter baixado o arquivo de configuração do Telegraf conforme descrito na configuração do InfluxDB Cloud 2.0, atualize-o adicionando as seguintes linhas e modificando-as de acordo com as informações do seu servidor MQTT:

[[inputs.mqtt_consumer]]
#
#MQTT broker URLs to be used. The format is scheme://host:port, schema can be tcp, ssl, or ws.
  servers = ["tcp://localhost:1883"]
#
#Topics to subscribe to
  topics = ["#"]
#
#Username and password
  username = "example"
  password = "NNSXS.JNSBLIV34VXYXS7D4ZWV2IKPTGJM3DFRGO.........."
#
#Needed only if your payload type is string, since Telegraf does not forward data of this type by default
  json_string_fields = ["uplink_message_frm_payload"]
#
#Define the message format
  data_format = "json"

info

Você pode verificar as informações do TTS na aba a seguir.

Em seguida, você precisa copiar o token gerado anteriormente na aba Tokens e exportá-lo para uma variável de ambiente para ser usado pelo plugin de saída do InfluxDB, ou você pode simplesmente passá-lo diretamente como um valor de token no arquivo de configuração. Você pode definir a variável de ambiente usando o seguinte comando no seu terminal:

INFLUX_TOKEN="paste your token here"

Execute o agente Telegraf no seu terminal com o seguinte comando:

telegraf --config /path/to/custom/telegraf.conf

Integração HTTP

Esta seção mostra como configurar o agente Telegraf com o plugin HTTP Listener v2 e como criar uma integração Webhook correspondente no The Things Stack.

Atualize a configuração do Telegraf que você baixou anteriormente, conforme descrito na configuração do InfluxDB Cloud 2.0, adicionando as seguintes linhas e modificando-as de acordo com a sua configuração:

[[inputs.http_listener_v2]]
#
# Address and port to host HTTP listener on
  service_address = ":8080"
#
# Path to listen to
  path = "/telegraf"
#
# HTTP methods to accept
  methods = ["POST"]
#
# Needed only if your payload type is string, since Telegraf does not forward data of this type by default
  json_string_fields = ["uplink_message_frm_payload"]
#
# Define the message format
  data_format = "json"

Copie o token gerado na aba Tokens e use-o como valor de token para o plugin de saída no seu arquivo de configuração do Telegraf, ou exporte-o para uma variável de ambiente com o seguinte comando no seu terminal:

INFLUX_TOKEN="paste your token here"

Inicie o agente Telegraf executando o seguinte comando no terminal:

telegraf --config /path/to/custom/telegraf.conf

Data Explorer

Selecione o tipo de explorer, selecione _measurement no menu suspenso na janela Filter e marque a caixa mqtt_consumer. Em seguida, você pode escolher o tópico e o parâmetro que deseja monitorar.

Dados de Localização

FROM: Seu bucket
MEASUREMENT: matt_sonsumer
_field: uplink_message_decoded_payload
topic: v3/...

Você também pode clicar em SAVE AS no canto superior direito para salvar este explorer como uma célula de Dashboard.

Dashboards (Opcional)

Um dashboard é onde você visualiza e interage com os dados em tempo real. Você pode personalizar o dashboard de acordo com suas necessidades.

Navegue até a guia Dashboard e clique em Create Dashbaord.