Blueprint of useful software for IoT development.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
files
.gitignore
LICENSE
README.md
Subutai.json
site.yml

README.md

IoT sandbox

Blueprint of useful IoT software for the Subutai Platform

How to use this product

IoT sandbox allows you to spin up an online environment with simple steps. It's just a matter of inserting your desired usernames and passwords, and then clicking "next next finish". Once the environment is up, everything is ready.

Data can then be sent from IoT devices via mqtt, a lightweight messaging protocol commonly supported by both DIY kits and professional equipment. Sensors, Raspberry Pis and other devices will be able to send data directly into the Subutai environment in which the BP is run. The data is gathered by Telegraf and automatically stored on InfluxDB. The user can then create dashboards for data visualization using Grafana. All the software needed comes already installed and preconfigured by the Blueprint.

1. Run the Blueprint on Subutai

Assuming you have already signed up to the Subutai Bazaar, hop to the Products page and click the IoT sandbox Blueprint.

Click IoT sandbox

Insert your desired variables: username, domain name and password for mqtt; name of the environment; password and domain name for grafana; and size of your container. It is ok to use the default values. Don't forget you need to use different domain names for mqtt and grafana.

Set your Blueprint variables

Select one Peer to host your Environment's container.

Select a Peer

Verify that the domain name was properly assigned.

Check the exposed port

Click Finish to start building your Environment.

Build the Environment

Wait for some minutes as the Environment is being built. Depending on the characteristics of the Peer you are using, it can take between 5 - 15 minutes.

Wait some minutes

Your environment is ready.

Your environment is ready!

Check the port mapping tab. You can click the domain name to access Grafana.

Port mapping tab

2. Check Grafana

Use your browser to acces the domain name you have chosen.

Access Grafana

Log in using the username "admin" and the password you defined for grafana before running the Blueprint.

Log in

Go to the list of dashboards.

Go to the list of dashboards

Iot sandbox provides a smaple dashboard, that will display any data that comes into the container. You will naturally be able to create your own dashboards, customize this one or add data filters (in case you are sending data from different sensors, for instance). Check Grafana's documentation to learn more about it.

Access the default dashboard

As there is no data coming in, at first the dashboard will be empty.

Empty panels

3. Start sending data!

Now you can start sending data from whatever MQTT-enabled device, equipment or software you use. If you want to send simulated data, please check this wiki page about how to use node-red to send random data.

Populated dashboard

5. Do more with IoT sandbox

As with any other BP environment, IoT sandbox can be extended using the power of its open source base: InfluxDB, Telegraf, Grafana - and virtually any other software you can run on its Debian Stretch operating system. You have full admin access to all of those, out of the box. Check some useful resources below: