Lesson 1.6 Dashboards

Dashboards are the first thing you see when you log in to the platform under the navigation bar menu "Dashboards". They are highly customizable, easy to edit, and update in real time. Dashboards help you quickly summarize the information you’re interested in-presented clearly and visually engaging.

In this lesson, we’ll go through the following topics:

• Explain when to use Views and when to use Dashboards
• Create a dashboard using some of the available widgets
• Use the floor plan widget to do nice visualizations
• Share a dashboard with other users

When to Use Views vs. Widget-Based Dashboards

Views-in the Device list and Map-are powerful and flexible tools for many use cases.
They are especially effective for:

• Monitoring large sets of devices
• Filtering data using FIWARE Q Queries, including deviation-based conditions
• Exploring data by drilling down into specific devices or conditions

Views are ideal when you want to analyze everything and then zoom in on what’s interesting.

Widget-based dashboards, on the other hand, provide benefits that views can't:

• Full control over layout, positioning, and design
• Ability to highlight specific KPIs and summarize data across systems
• Combine different types of widgets (charts, maps, floor plans, text, etc.) into one unified view

These dashboards are especially useful when:

• You need to present executive-level summaries or real-time KPIs
• Visual clarity and custom arrangement of data is important
• You want to mix multiple data sources or visual styles in the same view
• You're setting up screens for monitoring in control rooms or public areas
• You want to show a limited subset of devices or values with contextual overlays (e.g., on a floor plan)

In short:
Use views when you're exploring or working with large datasets.
Use dashboards when you're presenting, summarizing, or monitoring key metrics in a tailored layout.

Dashboard

Here’s how to create a dashboard:

1. Go to the Dashboard menu and press the cog icon.
2. Select New Dashboard.
3. Enter a name.
4. Press Create.
5. Press New Widget to start adding widgets.

Widgets

Data Table

The Data Table widget displays data from multiple devices and fields, updated in real time.

Add devices using Select Device and select fields with Select Fields. The Column Configurations section controls the appearance of each column, including display name, unit, column width, display mode (text or bar gauge), base color, and thresholds.

Device chart

Displays time series from a single device's field

Configuration

Parameter	Description
Device	The device containing the data you want to display.
Field	The specific data field you want to use.
Time period	How far back the data should stretch in time.
Resolution	The interval between data points (show every point or aggregated).
Calculation	Method for aggregating data points (e.g., mean). Disabled if set to "full".
Curve type	Display style: step, linear, or smooth curve.
Y-axis range	"Auto" for dynamic scale or "From zero" to start at zero.
Heading	Chart title; defaults to device name if left blank.
Subheading	Subtitle; defaults to data field name if left blank.
Thresholds	Color coding for value ranges (e.g., mark values up to a limit with specific colors).

For more about calculation types, see Calculation Types.

Multi-Device chart

A chart that supports multiple fields from multiple different devices.

Select a Device and Field, then press Add to Chart to add the combination. Repeat for each device-field pair; added combinations are listed under Selected Combinations and can be removed individually.

Most other settings (curve type, thresholds, axis, heading) are shared with the Device Chart widget. Additionally, Legend Mode (list or table) and Legend Placement (bottom or right) control the legend, and the tooltip shown on hover can be toggled on or off.

Text

A widget that displays text with customizable parameters.

Press New Widget and add a Text widget. Configure it to your liking. For colors, you can use the platform’s built-in options or specify any hex color code (e.g., #FF5733).

Device value

Press New Widget and add a Device Value widget. It shows the current value of a device field.

Here’s an example configuration for a gauge widget:

Parameter	Description
Device	The IoT node to pull data from.
Field	The specific data field you want to use.
Heading	Widget title; uses device name if empty.
Subheading	Subtitle; uses field name if empty.
Unit	Unit to display; can be custom or predefined. If custom, define or leave empty.
Display type	Text, circle, bar, or gauge.
Timestamp Format	None, relative (e.g. 2h ago), ISO 8601, local (date and time), date only, time only, or date and time.
Base color	Color for the value when no thresholds are active.
Thresholds	Color coding based on the current value.

Note: The Text display type also shows a sparkline-an overview of how the value has changed over the last 1h, 6h, 24h, or 7d.

Multi-Device value

Displays current values from multiple devices and fields in a configurable grid. Unlike the Device Value widget, the display is always text-based.

Add devices with Devices, and set the field to show with Field Name (the name must match exactly across devices; a missing field is shown as a dash). Color Mode applies color to the background or the text, and Global Thresholds color values within defined ranges-both can be overridden per device under Items. Layout controls the number of columns (1–6) and whether the device name, label, and last reported time are shown.

Map

Add a Map widget to display device locations and data based on existing map views. To use this widget, you first need to create map views that define:

• Which devices to show
• What data to display
• How to visualize the data

The Map widget supports both:

• Outdoor tracking using the standard map
• Indoor tracking by uploading a geocoded floor plan. Assets within the boundaries of the floor plan will get visualized.

Geofences can also be drawn directly on the map or on an overlay image. Each geofence can be linked to an IoT node that receives an event when a device enters, moves inside, or leaves it-useful for triggering rules based on device location.

Image

Add an Image widget via the widget menu.

The Image widget displays a static image on the dashboard. It is useful for adding logos or visual elements. Settings include size (25%, 50%, or 100%), horizontal alignment, vertical alignment, background, and shape.

Logs

Add a Logs widget to display device activity. Options include a custom title and timestamp format (relative, exact, or both).

Resource Count

Add a Resource Count widget. This shows counts of devices, locations, organizations, apps, or rules, and acts as shortcuts.

Navigation

Add a Navigation widget to create a direct, customizable link to another dashboard.

Command Buttons

Add a Command Buttons widget to trigger rules that have a button trigger. Each button can be given its own label, icon, and color.

Floor Plan Widget

The Floor Plan widget displays a static image with overlay icons and color-coded indicators. It's ideal for visualizing real-time data in context, such as:

• Office layouts – showing seat occupancy
• Public transport – visualizing seat usage
• Building HVAC systems – indicating valve positions, actuator status, temperatures, pressures, and more

Use this widget whenever you need to present color-coded values or status icons directly on top of an image.

1. Create a new dashboard and add a Floor Plan widget.

2. Add a background image for your floor plan.
   You can either select an existing image or upload a new one.

3. Add your devices:
   You can add them manually one by one, but there's a quicker method if you're adding many:

   • First, save the widget after adding the image.
   • Go to Devices in the navigation bar.
   • Use Select many to choose the devices you want.
   • Click Add to a Floor Plan widget.
   • Select the dashboard you created in step 1.
   • Choose the correct Floor Plan widget by its ID.

4. To edit or open the widget later, use the widget menu in the dashboard.

5. Press Start placing to position the selected devices on the floor plan, then save your changes.

6. If you’re unhappy with device placement, you can drag and drop devices while editing. Use Snap to Grid to align everything perfectly; Grid Cell Size sets how coarse or fine that grid is.

7. For each device, set Device Value to the field you want displayed (e.g. "temperature") and use Show Value to toggle whether it appears beside the icon. Device Marker Type sets the icon shape: circle, ring, or dot.

Layout and Management

1. Press the cog icon and select Edit Widgets to enter edit mode. Drag, drop, and resize widgets to organize the layout. Press Update to save, then exit edit mode.

2. To rename the dashboard or configure access rights, press the cog icon and select Manage Dashboard. Change the name if needed, then press Save and Done.

The dashboard is complete.

Sharing dashboards

Automatic Access Based on Organization

Dashboards are considered resources. If you're a member of an organization where resources are shared, other members with read access at your level in the hierarchy-or higher-will automatically gain access to your dashboards.

Manually Sharing a Dashboard

You can also manually share a dashboard with a specific user or user group:

1. Select your dashboard from the Dashboard drop-down menu.
2. Click Manage.
3. Under Access Rights, enter the account name of the user you want to share with and assign the appropriate access level.
4. To share with a user group, use the API (Swagger)-this is currently not possible through the UI.

Important: Sharing a dashboard does not automatically give access to the related IoT nodes.
To allow full visibility of data, you must also share the relevant IoT nodes separately via the Device list.

Q&A

Question

Why use dashboards, isnt device views and map views enough?

Answer

Views are ideal for working with large datasets and drilling down into specific details. Dashboards are better suited for summarizing key metrics in a customized layout, making it easier to quickly grasp the overall status. A good approach is to start with views to explore and filter your data-then use dashboards to highlight and present the most important insights.