Login

Select MQTT to InfluxDB Data Injection from the app selector:

The default user is admin with password changeme.

Enter your License Key

The first login to the app requires entering a license key. If you don’t have one yet, you can purchase it right here:

Setup Wizard

After entering the license key, the default dashboard is displayed which shows the total throughput of all configured Data Injections:

Because you did not define any Data Injections yet, activate the Setup Wizard from the toolbar:

It will guide you through the configuration. You can activate the wizard for reconfiguration anytime later from the toolbar.

The Setup Wizard displays two options while both are disabled initially:

Click Enable this feature to configure it.

Create a SwiftMQ to InfluxDB Data Injection

A Data Injection is created between the SwiftMQ router embedded in Flow Director and InfluxDB. The embedded SwiftMQ router or any SwiftMQ router connected to Flow Director can be used as SwiftMQ provides a full-fledged MQTT broker.

This example assumes that MQTT clients send to topic MQTTIn. The data is stored in a local InfluxDB instance.

  • Define a unique Data Injection name that is used in dashboards.

  • Define the topic name as the source; in our case it is MQTTIn. Note that you need to use SwiftMQ topic name conventions and not the standard MQTT topic names because we receive the data from a SwiftMQ topic. For example, MQTT/+ translates to MQTT.% in SwiftMQ.

  • Specify the so-called influx 2 properties to connect to your InfluxDB instance. This can be an on-premise or an InfluxDB Cloud instance via TLS.

  • The messages received from the topic must contain a JSON of any structure. Specify the Conversion Properties to transform the JSON fields into InfluxDB fields. See here about the format.

You can create more Data Injections by clicking the + button:

Create an MQTT Broker to InfluxDB Data Injection

A Data Injection is created between an MQTT broker and an InfluxDB instance. Both can be on-premise or in the cloud or mixed. This example creates a Data Injection between HiveMQ Cloud and InfluxDB Cloud.

  • Specify the MQTT broker properties and the topic name you want to connect to. In this example, it is a HiveMQ Cloud instance.

  • Specify the so-called influx 2 properties to connect to your InfluxDB instance. This can be an on-premise or an InfluxDB Cloud instance via TLS. In this example, it is an InfluxDB Cloud instance.

  • The messages received from the topic must contain a JSON of any structure. Specify the Conversion Properties to transform the JSON fields into InfluxDB fields. See here about the format.

You can create more Data Injections by clicking the + button:

Remove a Data Injection

Click on

to remove a Data Injection.

Start the App

After finishing your setup, you can start the app by pressing START APP:

It displays the Total Throughput dashboard and you might already see your Data Injections in action:

Starting and Stopping the App

The app is started after the initial configuration. This can be seen at this button in the toolbar which displays green:

Press it to stop the app:

To start it, press it again.

Reconfiguration

To change your configuration, press this button:

It launches the wizard and you can apply your changes. Then press UPDATE APP:

It restarts the app with the new settings.

Change your Password

You can change your password here:

You are being logged out after a change and have to login again.