Configuring device dashboards

You configure device dashboards from the dashboard editor or through a .json configuration file.

If you are configuring the dashboard through the UI, select a card from the card gallery to add it to the dashboard and configure its settings.

Configuring the dashboard through the UI

Add new card types from the card gallery. You can configure the settings for each card through the editor.

  • On a table card and line graph card, to show input data, omit the aggregator in the attribute definition in datasource.attributes. If the attribute is calculated by the The function pipeline, the calculated value is displayed. For example, if you use the mean built-in function to create a mean daily temperature batch data metric, the mean value is the input value. If you extend the time grain to monthly, the card continues to display the mean daily temperature input values but for an extended range.
  • If you apply an aggregator to a metric that runs a function on the data, such as mean daily temperature, the aggregator is applied to the metric that runs the function. For example, if you set the time grain to monthly and you apply the aggregator mean to the attribute, the dashboard calculates and displays the monthly mean temperature by aggregating the mean daily temperature.
  • After you create or update a device dashboard, you might have to wait up to 5 minutes for the device type pipeline to run before you see your updates. Also, the functions that are configured in the dashboard configuration run each time new device data is received for the device type. The pipeline might not start until new device data is generated.

Configuring the dashboard through JSON code

You can also configure a device dashboard by defining the dashboard configuration in a .json file. You might want to configure some advanced features that are not available through the dashboard editor.

You can start by exporting the .json configuration for a built-in device dashboard for a Creating sample device types. Import your .json file to create a new device dashboard.

Complete Tutorial: Customizing a device dashboard for hands-on experience of adding a device dashboard to a device type.