Integración con InfluxDB (vía TTS)

InfluxDB es una base de datos de series temporales de código abierto, enfocada en lectura de alto rendimiento, escritura de alto rendimiento, almacenamiento eficiente y análisis en tiempo real de datos masivos de series temporales. Además de protocolos nativos como HTTP y UDP, también es compatible con protocolos de comunicación de componentes como CollectD, Graphite, OpenTSDB y Prometheus. Ampliamente utilizada en monitoreo DevOps, monitoreo IoT, análisis en tiempo real y otros escenarios.

El contenido de este capítulo guiará a los usuarios sobre cómo conectar el SenseCAP T1000 Tracker a InfluxDB a través de TTN.

Antes de comenzar la configuración, por favor consulte Conectar SenseCAP T1000 a TTS para conectar primero su SenseCAP T1000 Tracker a TTS.

Preparación

Antes de configurar InfluxDB, necesitamos instalar el agente Telegraf (versión 1.9.2 o superior).

Configuración de Telegraf

Configurar InfluxDB Cloud

Inicie sesión en su InfluxDB Cloud.

Crear Bucket

En la pestaña Buckets.

Haga clic en el botón Create Bucket para crear un nuevo bucket.

Nombre su bucket, elija cuánto tiempo permanecerán los datos en la base de datos y luego haga clic en Create.

Generar Tokens

Navegue a la pestaña API TOKENS y haga clic en el botón GENERATE API TOKEN para crear un token.

Configurar Telegraf

Integración MQTT

Esta sección le muestra cómo configurar su agente Telegraf con el plugin MQTT Consumer utilizado para conectarse al servidor MQTT de TTS.

Navegue a la pestaña TELEGRAF y haga clic en CREATE CONFIGURATION

Seleccione su bucket que creamos anteriormente, y seleccione system.

Nombre su configuración, seleccione Create and Verify y luego Finish.

Una vez que haya descargado el archivo de configuración de Telegraf como se describe en la configuración de InfluxDB Cloud 2.0, actualícelo agregando las siguientes líneas y modificándolas según la información de su 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

Puedes verificar la información de TTS en la siguiente pestaña.

A continuación, necesitas copiar el token generado previamente desde la pestaña Tokens y exportarlo a una variable de entorno para ser utilizado por el plugin de salida de InfluxDB, o puedes simplemente pasarlo directamente como valor de token en el archivo de configuración. Puedes establecer la variable de entorno usando el siguiente comando en tu terminal:

INFLUX_TOKEN="paste your token here"

Ejecuta el agente Telegraf en tu terminal con el siguiente comando:

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

Integración HTTP

Esta sección te muestra cómo configurar el agente Telegraf con el plugin HTTP Listener v2 y cómo crear una integración Webhook correspondiente en The Things Stack.

Actualiza la configuración de Telegraf que descargaste previamente como se describe en la Configuración de InfluxDB Cloud 2.0 agregando las siguientes líneas y modificándolas según tu configuración:

[[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"

Copia el token generado desde la pestaña Tokens y úsalo como valor de token para el plugin de salida en tu archivo de configuración de Telegraf, o expórtalo a una variable de entorno con el siguiente comando en tu terminal:

INFLUX_TOKEN="paste your token here"

Inicia el agente Telegraf ejecutando el siguiente comando en la terminal:

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

Explorador de Datos

Selecciona tu tipo de explorador, selecciona _measurement en el menú desplegable en la ventana de Filtro y marca la casilla mqtt_consumer. Luego puedes elegir el tema y parámetro que deseas monitorear.

Datos de Ubicación

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

También puedes hacer clic en SAVE AS en la esquina superior derecha para guardar este explorador como una celda de Dashboard.

Dashboards (Opcional)

Un dashboard es donde visualizas e interactúas con datos en tiempo real. Puedes personalizar el dashboard según tus necesidades.

Navega a la pestaña Dashboard y haz clic en Create Dashbaord.