How to work with Dashboards

Introduction #

In Controllino Cloud, you can create dashboards with multiple widgets to visualize what is going on with your devices. Each dashboard contains widgets and displays data from devices, assets, etc. Here are the main aspects of a dashboard that you should familiarize before starting to create one yourself:

Add a Dasboard #

To add a new dashboard, please follow these steps:

Go to DASHBOARDS through the main menu on the left of the screen.

To add a new dashboard group, click the “+” sign in the upper right corner of the screen.

In the opened dialog, necessary to enter a dashboard title, description is optional. Click “Add”.

After that, enter your Dashboard group and click on the “+” sign again to add your dashboard.

After you gave it a name, click on “Add” – now you are ready to open up your dashboard!

Edit mode #

Use the “pencil” button in the bottom-right corner of the screen to enter dashboard edit mode. Once you switch to the edit mode, you can add new widgets and access controls in the dashboard toolbar. You can also use button “Apply changes” to save the dashboard or “Decline changes” to rollback all unsaved changes.

Title #

You can edit the dashboard title in the top-left corner of the dashboard. You can change and adjust a title in the settings of the dashboard as well. The title is used to give your dashboard a name.

Toolbar #

The dashboard toolbar on the top of the screen allows you to manage states, layouts, settings, aliases, filters, and configure time windows using the corresponding icons in the toolbar. Please note that some of these icons (stats, layout, settings) are visible only in “edit” mode.

Entity Aliases #

Entity Aliases determine which entities (devices, assets, etc) you would like to display on the dashboard. You can treat alias as a reference to one or more devices. These references can be static or dynamic.

An example of the static alias is the Single entity alias. An entity is configured once in the alias dialog box. All users see the same data if they have permission to access this device.

An example of a dynamic alias is the Device type alias, which displays all devices of a certain type (e.g. “Thermometer”). This alias is dynamic because the list of devices depends on the user using the dashboard. If you are logged in as a User, this alias will be resolved to all Thermometer devices. However, if you are logged in as a Customer user, this alias will be resolved to Thermometer devices that are assigned/owned by that Customer.

Entity Filters #

Entity filters allow you to specify a filter for the list of entities resolved by the entity alias.

Let’s look at an example:

Suppose you have thousands of “Thermometer” devices, and you would like to display thermometers of a specific model and with certain battery levels. Let’s also assume that thermometer model is stored as an attribute, and the battery level is stored as a time series telemetry data. We can then define a filter that checks if the model is “Temp Sensor A” and the battery level is less than 20 percent.

Filters are applied only to the “latest” value of the attribute or time series key. Don’t use this feature to “filter out” historical time series values.

You can combine different logical expressions over one key using “complex” filters. For example: “(A > 0 and A < 20) or (A > 50 and A < 100)”. Also, you can combine two expressions for different keys using the “and” relation. For example: “(A > 0 and A < 20) and (B > 50 and B < 100)”. It’s not possible to use “or” relation to combining different keys yet. For example: “(A > 0 and A < 20) or (B > 50 and B < 100)”.