Data reports

Data tags

This article assumes you’ve already set up a data source (including variables) and defined data tags.

Data reports show your historical data. A data report supports five types of widgets to give you clear insight in your historical data. You don’t need to set up a VPN connection to view data reports.

Visualization in a data report does not affect your Cloud Logging credit (data points per hour). However, the configuration of your data tags, i.e. the effectively logged data, does.

This article shows how to:

Additionally, all widget formulas will be explained at the bottom of this page.

Add a data report

Multiple data reports can be created for a single device, where each data report can suit a different purpose, depending on the information you need. The next steps show you how to create a data report.

You can choose to:

Manually add a new dashboard

You can create a fresh new dashboard in the Cloud Logging app.

  • Go to [Devices] in the main menu, select the concerning device, open its [Apps] tab, and [Open] the Cloud Logging app.
  • Go to the [Dashboards] page, press [Add new dashboard], and select [Add new dashboard].
  • Select your dashboard type: [Data report].
  • Name the data report and press [Add].

Once a data report is created, you can find it in the [Info] tab below the VPN section.

Import a dashboard from a file (or device)

You can easily and effortlessly copy dashboards from one device to another by exporting the concerning dashboard and then importing it in your new device.

Non-existing variables

If a widget contains variables that do not exist in the new device, the corresponding “variable” field of that widget will be left empty.

First you’ll have to export your dashboard. You can do this from inside the dashboard or the Cloud Logging app.

  • Go to [Devices] in the main menu, select the concerning device, open its [Apps] tab, and [Open] the Cloud Logging app.

Press […] at the concerning dashboard and select [Export to file].

Now that you’ve exported a dashboard, you can import that dashboard in another device. Go to the other device and open the Cloud Logging app. From there:

  • Go to the [Dashboards] page, press [Add new dashboard], and select [Import from file].
  • Select the dashboard file and press [Open].

Once a dashboard is created, you can find it in the [Info] tab below the VPN section.

Edit layout

In a new dashboard you first set a layout for the data, which you can later change or expand. Once the layout is set, you can start adding widgets to the dashboard.

You have the option to create a new layout or select a preset layout. In this example we will create a new layout.

You will see an empty data report in which you will be able to customize the layout in multiple ways. The [+] will add a new field. The location of the new field depends on the current orientation, which you can change by pressing the [Change layout] button. If it shows as [=], a new column will be added. If it shows [lll] instead, a new row will be added.

You can divide a single field into multiple fields. This enables you to configure custom layouts, i.e. 2 smaller fields on the left and 1 large field on the right. You can do this by selecting [Layout] in the concerning field. You can add multiple fields by pressing the [+] button as many times as you like. Additionally, you can use the [Change layout] button, like before, to change the orientation from rows to columns, or vice versa.

Add widgets

Once the layout is set, you can start adding the various widgets to visualize the data. For data reports six types of widgets are available. In this chapter we will show you the functions of every single type of widget. The next steps show how to add a widget.

  • Press [Widget] and select a widget type.
  • Once the widget is created you will be able to view the widget by pressing [View].

All six widgets are explained in detail below.

Value widget

Shows the value of a single data tag that is configurable by factor and formula.

This widget’s settings are explained below.

Status widget

Shows a status bar of a single data tag. It’s most applicable for a state or status, like a machine state, with the data type boolean (true/false) or integer with limited states (i.e. 1-6). The colors and texts, like “Running”, are freely configurable.

This widget’s settings are explained below.

Gauge widget

Shows the value of a single data tag displayed in a gauge or liquid tank style. The colors and size of the areas are configurable.

This widget’s settings are explained below.

Period widget

The period widget is a configurable advanced bar chart in which the data over each period (hours, days, weeks) is processed and a formula is applied (i.e. max, sum). The outcome of this is displayed in stacked or seperate bars.

This widget’s settings are explained below.

Table widget

Shows historical data of one or more data tags in a table form.

This widget’s settings are explained below.

Graph widget

Shows historical data of one or more data tags in a graph form. You can toggle the visibility per data tag by pressing the concerning tag in the legend below the graph.

This widget’s settings are explained below.

Formula descriptions

The list below contains descriptions of all formulas that you can apply to a data tag in the various widgets.

Min:Shows the minimum logged value in the displayed time period.
Average:Shows the average of all the logged values in the displayed time period.
Max:Shows the maximum logged value in the displayed time period.
First:Shows the first logged value in the displayed time period.
Median:Shows the middle logged value in the displayed time period.
Last:Shows the last logged value in the displayed time period.
Mode:Shows the most common value in the displayed time period.
Range:Shows the difference between the minimum and the maximum logged value in the displayed time period.
Sum:Shows the sum of all the logged values in the displayed time period.