Data tags
This article assumes you've already set up a data source (including variables) and defined data tags. Please click the links for more information if you haven't yet.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] tabbelow 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.
Switch to live monitor
You can easily change a live monitor dashboard to a data report by replacing the word "monitor" to "report" in the CSV-file before importing a dashboard.
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 data report is created, you can find it in the [Info] tabbelow the VPN section
.
Edit layout
In a new dashboard you first set a layout for the data report, which you can later change or expand. Once the layout is set, you can start adding widgets to the data report.
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 five 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 five 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. |