Building Dashboards

This guide shows you how to create a dashboard with multiple widget types, configure real-time updates, and share it with your team.

Prerequisites

At least one device sending telemetry data
ADMIN or ENGINEER role

Steps

Create a New Dashboard

Navigate to Dashboards and click Create Dashboard.

Name: e.g., "Factory Floor Monitoring"
Description: Optional summary of what this dashboard tracks

You'll land on an empty dashboard canvas with a 12-column grid layout.

Plan Your Layout

Before adding widgets, consider what information matters most:

Widget Type	Best For	Example
Value	Single key metric at a glance	Current temperature
Gauge	Values with thresholds	Battery level (0–100%)
Line Chart	Trends over time	Temperature over 24 hours
Table	Detailed recent data	Last 50 telemetry records
Toggle	Device control	Turn relay on/off
Timeseries Table	Tabular time-series with export	Field values by timestamp

Add Value Widgets for Key Metrics

Click Add Widget and select Value.

Title: e.g., "Temperature"
Device: Select the source device
Field: Choose the telemetry field (e.g., temperature)
Unit: Optional suffix (e.g., "°C")

Place 3–4 value widgets across the top row for an at-a-glance summary.

Click Add Widget → Gauge.

Field: e.g., humidity
Min / Max: Set the range (e.g., 0–100)
Thresholds: Configure color zones (green for normal, yellow for warning, red for critical)

Gauges are ideal for metrics that have clear operational ranges.

Add Line Charts for Trends

Click Add Widget → Line Chart.

Device: Select the device
Fields: Select one or more fields to plot together
Time Range: Default time window for the chart

Line charts span the full width of the dashboard for maximum readability. You can overlay multiple fields (e.g., temperature and humidity on the same chart).

If your device supports commands, add a Toggle widget.

Device: Select the target device
Command Field: The field name to send (e.g., relay)
On/Off Values: What values to send (e.g., 1 / 0)

When toggled, the platform publishes a command to the device's MQTT command topic.

Add a Timeseries Table

For detailed data inspection, add a Timeseries Table widget.

Device: Select the device
Fields: Choose which fields to display as columns
Rows: Number of recent entries to show

This widget also supports CSV export — useful for data analysis.

Assign to Users

To share the dashboard with crew members, go to dashboard settings and use User Assignment.

Select users with the USER role
Assigned users see this dashboard on their home screen
Users can view data but cannot edit the dashboard layout

See User Assignment for details.

Tips

Start simple: Begin with 3–5 widgets and add more as needed
Group related metrics: Place related widgets near each other
Use real-time mode: Enable live updates to see data as it arrives — see Real-Time Mode
Name widgets clearly: Good titles help crew users understand the dashboard without training