Telemetry end-to-end

A package showing telemetry data acquisition end-to-end: Microcontroller firmware to cloud side data processing, using Drogue IoT and Apache Kafka in the process.

Page logo

The installation of Eclipse Kura™ will require a Raspberry Pi 3+. Kura itself will run on other hardware too, and it should not be a problem to run this tutorial on an AMD64 device or another 32bit or 64bit ARM device. However, the following instructions are tested with a Raspberry Pi 3+ and commands maybe be different when you choose a different target.

What you do require however is a device with a Linux supported Bluetooth device attached, and support for running containers.

Network & IP addresses

Eclipse Kura, running on the Raspberry Pi, will need to connect to the MQTT endpoint running on your Minikube cluster. As this cluster is running on your local machine, inside a virtual machine, Kura cannot directly access the MQTT endpoint.

In order to establish a connection between Kura on the Raspberry Pi and the MQTT endpoint inside the Minikube cluster VM, you will need to:

  • Connect the Raspberry Pi to a network that can reach the machine your Minikube cluster runs on
  • Open a port forward from your machines network interface, to the MQTT endpoint service
  • Open this port on your machine’s firewall

The port forward can easily be created using kubectl on the host machine running the Minikube VM:

kubectl port-forward deployment/mqtt-endpoint --address 1883

Set up the device

Download a Debian “buster” based Raspberry OS image:


And write it so an SD card:

# replace XXX with your SD card drive that you want to erase (e.g. sdb)
xzcat 2021-05-07-raspios-buster-armhf-lite.img.xz | sudo dd of=/dev/XXX bs=1M status=progress oflag=sync

Before you boot for the first time, ensure that you enable SSH:

touch boot/ssh

Also, it is recommended to enable WiFi:

  • Create a new file

    vi boot/wpa_supplicant.conf
  • Edit configuration

    country=<XX> # use your ISO 3166 country code, e.g. DE for Germany
    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
      ssid="<your ssid>"
      psk="<our password>"

Boot and check access

Once you flashed the SD card, put it into your Raspberry Pi and ensure that you can log into the device remotely using ssh.

Also, ensure that Docker is installed. If you are missing docker, you can easily install this be executing the following command:

sudo apt-get install

Install Kura

Kura is not installed directly on the gateway, but run inside a container. We do this, as we plan to amend the tutorial in the future, using an edge orchestration solution to deploy the IoT workload. For now, we manually start the container.

Create the Kura container

Create and start the Kura container using:

docker run -dti -v /var/run/dbus/system_bus_socket:/var/run/dbus/system_bus_socket --name kura -p 443:443 -console -consoleLog

It will start in the background. Should the container should get stopped, you can restart it with the following command:

docker start kura

Login to the web console

Once it is fully started, you can also connect to using your web browser:


The default access credentials are:

  • Username: admin
  • Password: admin

Attaching to the container console

You can also attach to the console of Kura using:

docker attach --sig-proxy=false kura

Setup connection

Kura needs to be connected to the Drogue IoT cloud instance. The configuration must be done using the Web UI. The following steps will walk you through the process.

Connecting the gateway

  • Navigate to [System > Cloud Connections] and then select the tab labeled “MqttDataTransport”.

  • Set the following fields:



    The IP address is the IP the machine you are running kubectl port-forward on.
  • Afterwards click on Apply and confirm to store the settings.

  • Next, test the settings by manually connecting. Click on the button Connect/Disconnect once, and wait.

  • When the column status changes to “Connected” you can move on to the next step. Otherwise, check the connection settings.

Creating a cloud publisher

  • Navigate to [System > Cloud Connections] and click on the button New Pub/Sub.

  • In the dialog, select as a factory, and enter the new ID microbit.

  • Confirm using the Apply button.

Configuring the micro:bit demo

  • Navigate to [Services > micro:bit] and update the following settings:

    CloudPublisher Target Filter
    Select the target (
  • Afterwards click on Apply and confirm to store the settings.

What is next?

Go to the next page and set up the micro:bit.

When things go wrong

Unable to connect gateway to the cluster

If the gateway cannot connect to the cluster here are a few things to check.

Check if the connection reaches the port forward

If the connection reaches the port forward, you should see a corresponding message on the console:

$ kubectl port-forward deployment/mqtt-endpoint --address 1883
Forwarding from -> 1883
Handling connection for 1883

If you don’t see Handling connection for 1883, this means that the gateway cannot reach port 1883 on your local machine. Possible causes for this can be a firewall blocking access to the port or a wrong IP address or port number in the Kura configuration.

If you see the message, but see errors directly after it, this means that Kura was connecting to the correct address and port, but something fails with the port forward. The error message should provide additional information.