Build your first dashboard

A dashboard is a board of cards. Each card is a widget bound to data. This page builds a small board for the device you connected: one card with the latest temperature and one chart of its history. It then shows how to pick the time window and who can see the board.

What you need

• A device that sends telemetry. See Connect your first device.
• Any member can create a personal dashboard that only they see. Sharing a dashboard with everyone in the organisation needs the Admin role or higher.

1. Create the board

1. Open Dashboards.
2. Select New dashboard.
3. Under Start from, keep An empty dashboard (“Add the cards yourself.”).
4. Enter a Title, for example Boiler room, and optionally a Description.
5. Leave Share with everyone in the workspace off for now. The board is then personal: only you see it.
6. Select Create.

The new board opens and says This dashboard is empty.

2. Add a value card

1. Select Customise to edit the board, then Add widget.
2. In the Add widget picker, open the Data category and pick Stat. You can also type in Search widgets….
3. In the card’s settings, choose the data source IoT telemetry and the query A value of a device (live).
4. Pick your device under Device and the key temperature under Value.
5. Give the card a title, for example Temperature, and select Save.

The card shows the latest value and updates live. When the device’s profile declares the key with a unit and decimals (on the profile’s Telemetry keys tab), the card uses them.

3. Add a chart

1. Select Add widget again.
2. Open the Charts category and pick Line chart.
3. Choose the data source IoT telemetry and the query Device readings over time (live).
4. Pick the same device. Under Keys, type temperature (or auto for the first numbers the device sends; up to 20 keys, comma-separated).
5. Keep the Aggregate as it is for now, and select Save.
6. Drag the card’s corner to make it wider.
7. Select Done to leave edit mode.

Long windows are drawn from minute, hour or day aggregates instead of every raw reading. See Aggregates and rollups.

4. Pick the time window

Charts follow the board’s time window. Change it in the board’s filter bar, for example to the last 7 days. The choice is kept in the page address, so a copied link (Copy link) opens the exact same view.

To give the board a starting window for everyone, open Settings (dashboard settings) and set the Default time window.

5. Share it (optional)

To let everyone in the organisation open the board, open its settings and, under Who sees it, use Share with the workspace. Only an admin can share. Members who are not admins can make a Personal copy of a shared board to change it for themselves.

Make it reusable

To show the same cards for any device, add a board parameter for devices and bind the cards to it instead of a fixed device. Viewers then pick the device in the filter bar (Dashboard filters). See Data sources and parameters.

You can also start a new board from a template instead of an empty one: under Start from, pick a template. The five ready solutions add their boards as templates. See Start from a ready solution.

If a card stays empty

Card says	What to do
This card is not finished: choose its … in its settings.	Open the card’s settings and pick the missing device or key.
No data for this period.	The device sent nothing in the window. Widen the window, or check the device’s Telemetry tab.
You may not see the data of this card.	Your role lacks the permission to read telemetry or the device. Ask an admin.
Widget not available	The widget’s module is off for your organisation, or you lost access to it.

See A dashboard shows no data for more.

Learn more

• Create and organise boards: pages, layout, duplicate and delete.
• Chart cards and Value cards: every setting.
• Sharing dashboards and Wall screens, full screen and zoom.

Next step

Set up your first alarm.