Soracom Lagoon

Create a Sample Dashboard

In this example we will create a new dashboard that shows humidity and temperature for a device on a Panel using the Demo sample data source provided by Soracom. This data source can be used to verify Lagoon's operation when device data is not yet available.

To follow along with this example, you must have completed the Configuration of Soracom Lagoon.

There is no cost associated with using the Demo sample data. There is also no data export fee for activating Harvest Data's extended data retention option.

https://g-v3.lagoon.soracom.io

Create a Sample Dashboard header image

Create a new Dashboard and Panel

  1. Log into the Lagoon console and click Dashboards, then New, then New Dashboard.

    https://g-v3.lagoon.soracom.io

    Create a dashboard through the Lagoon Console

    A Dashboard named New dashboard is created.

  2. Click Add panel, followed by Add a new panel.

    https://g-v3.lagoon.soracom.io

    Add a panel to a dashboard

    The Edit Panel screen appears.

    https://g-v3.lagoon.soracom.io

    Edit panel screen

Display Humidity and Temperature on the Panel

In the next steps we will visualize the following sample data of Device-1 in a Time series panel.

The Demo sample data source also includes the following data:

  • battery
  • elevation
  • latitude
  • longitude

Time series is selected as the standard Panel type. However, latitude and longitude of a device could also be visualized on a map using the Soracom Map Panel.

  1. Click the Query tab and select Harvest (default) as the Data source.

    https://g-v3.lagoon.soracom.io

    Select Harvest data source

  2. Set Query A as follows

    https://g-v3.lagoon.soracom.io

    Configure query A for humidity

    A graph of humidity is displayed.

  3. Next, click on the Query button and set Query B as follows

    https://g-v3.lagoon.soracom.io

    Configure query B for temperature

    A graph of temperature is added.

Set the Panel Title

By default, Panel Title is displayed as the title of a panel. To change this, follow the steps below:

  1. Click All, followed by expanding Panel options.

    https://g-v3.lagoon.soracom.io

    Set panel Title

  2. Enter Humidity and Temperature in Title field.

Configure Display Name and Unit Overrides

We can use Overrides to change how the data is identified and presented on the Time series panel. In this case we will adjust the Display name of the data as well as the Units being used to represent it.

  1. Click Overrides, then Add field override, and complete the fields for Override 1 as follows

    https://g-v3.lagoon.soracom.io

    Set humidity display name and unit override

    The humidity graph changes to a % display.

  2. Next, click Add field override again and complete the fields for Override 2 as follows

    https://g-v3.lagoon.soracom.io

    Set temperature display name and unit override

    The temperature graph changes to display °C.

Since the units are different for both axes, the graph is automatically changed to a dual-axis graph.

Save the Dashboard

  1. Click the Apply button on the Edit Panel screen.

    https://g-v3.lagoon.soracom.io

    Apply the changes made to a panel

    The Panel is saved and you are returned to the Dashboard screen.

  2. Click Save dashboard, enter Sample Dashboard as the Dashboard name and click the Save button.

    https://g-v3.lagoon.soracom.io

    Save the Lagoon Dashboard

    The Dashboard is saved and you are returned to the Sample Dashboard screen.

    https://g-v3.lagoon.soracom.io

    Create a Sample Dashboard header image

This concludes the creation of our sample dashboard. You can view and modify this dashboard at any time from the Dashboards page when logging into the Lagoon Console.

https://g-v3.lagoon.soracom.io

Sample dashboard on the Dashboards page