Basic features¶
The following screenshot shows the home dashboard illustrating the common controls.
![_images/home-dashboard.png](_images/home-dashboard.png)
Time range selection¶
The options here set the time range of the displayed data. You may specify a From - To period or select one of the predefined Quick ranges. Time range can also be adjusted by clicking on the graph and dragging horizontally over. The zoom out button (or a double click on the panel) is useful for switching to a wider time range.
Auto refresh interval¶
The data can be manually refreshed using the Refresh dashboard button. In addition, one can set auto refresh interval as shown below (data will be reloaded every 5 seconds).
Selecting data¶
You can choose the displayed data related to particular devices, sensors, and channels. The panels will then be dynamically created according to the selection. Furthermore, you can zoom the graph vertically and click once to reset to the original range.
Aggregate functions¶
Data aggregation (or data alignment) options define how raw data points are processed before being displayed. When you select a function in the Aggregate by field, the function is applied to raw data points grouped by the Aggregate interval period. Then new data points are shown for every group lying within the defined time range.
By default, the mean function is applied to the groups formed by the auto aggregation interval. The auto option dynamically sets the aggregation interval based on the selected time range for an optimal number of data points to be rendered. If the aggregation interval is set to too short for a long time range, a large number of data points may slow down the browser’s rendering process. Such a scenario can be seen at the end of the below clip.
Default dashboards¶
Sensors¶
Sensors and Sensors (large view) show all sensor data excluding the network related data. In these dashboards, each panel is dedicated to a group of identical sensors, e.g., the battery panel shows battery data (voltage) of all selected devices. They are suitable for viewing overall sensor data.
Sensors (mobile)¶
Sensors (mobile) is same as the Sensors dashboard except that each panel shows data from a specific device sensor, i.e., a panel displays only a single time series. Suitable for investigating individual sensor data when the screen size is small.
Network¶
Here, the network related information can be investigated. Using the aggregate functions such as count and sum, one can flexibly examine the dropped/missing data points.
Watchlist¶
This dashboard shows the last sensor value in a table. With a short refresh interval, it is useful for field deployment or sensor testing to check the last value in real time.
Map¶
Map panel can show device or sensor values on a map according to the defined location metadata (see Settings). The following clip shows defining location data for a device 269 in Global Settings. The meta data used for the example:
{
"3001": {
"latitude": 52,
"longitude": 10,
"name": "DL-IAM (3001)"
},
"9013": {
"latitude": 5,
"longitude": 18,
"name": "DL-PM (9013)"
}
}
Note
The map displays only devices of which the location coordinates have been defined and that have transmitted data within the defined time range.
Gateway/Gateways¶
If you have registered LoRaWAN gateways with us, you can check their status here. Currently, TTIG status cannot be shown in the dashboard.
Advanced features¶
User dashboard¶
One can build various kinds of custom dashboards in the personal, shared or public directory.
A good starting point is to copy the existing dashboards and modify them. The dashboards in Default folder cannot be modified in place. Instead, you can save a copy of the dashboard in the personal directory and modify according to your needs.
Global/Personal settings¶
Following settings can be changed either in the user profile or global organization:
Timezone
Home dashboard
Theme color
Metadata (only in the global organization settings)
etc.
The user settings take precedence if different values are set in both. The following video shows accessing global and user settings, and how the user setting takes precedence.
Note
Changing a global setting will affect the others including the public (not logged in) user experience.
User-defined names¶
The default names of devices or sensors can be overridden in the dashboards via the metadata setting. The metadata used in the example:
{
"3001": {
"name": "DL-IAM 3001"
},
"battery": {
"name": "Battery Voltage"
},
"battery [V]": {
"name": "Battery Voltage [V]"
}
}
Public dashboards¶
A folder titled Public has a special permission allowing the public users to access the dashboards inside this folder. Please keep in mind that the public dashboards must use the public datasource because the default datasource is not accessible to the public.
Note
By default, the public datasource contains no data. Please inform us for populating the public datasource with either full history or certain days of retention period.
The following clip copies the Network dashboard into the Public folder.
Furthermore, you can set the public dashboard as the landing page for your instance. The following clip sets the Network Copy dashboard as the