Configure the application dashboard

The Dashboard is the first page you see when you connect to an IoT Central application. If you create your application from one of the industry-focused application templates, your application has a pre-defined dashboard to start. If you create your application from a custom application template, your dashboard shows some tips to get started.

Tip

Users can create multiple dashboards in addition to the default application dashboard. These dashboards can be personal to the user only, or shared across all users of the application.

Add tiles

The following screenshot shows the dashboard in an application created from the Custom application template. To customize the current dashboard, select Edit, to add a custom personal or shared dashboard, select New:

Dashboard for applications based on the custom application template

After you select Edit or New, the dashboard is in edit mode. You can use the tools in the Edit dashboard panel to add tiles to the dashboard, and customize and remove tiles on the dashboard itself. For example, to add a Telemetry tile to show current temperature reported by one or more devices:

  1. In the Edit dashboard panel, select a Device group.
  2. Select one or more devices in the Devices dropdown to show on the tile. You now see the available telemetry, properties, and commands from the devices.
  3. Select Temperature in the telemetry section, and then select Add tile. The tile now shows on the dashboard where you can change the visualization, resize the tile, and configure it:

Add a temperature telemetry tile to the dashboard

When you've finished adding and customizing tiles on the dashboard, select Save.

Customize tiles

To customize a tile on the dashboard, the dashboard must be in edit mode. The available customization options depend on the tile type:

  • The ruler icon on a tile lets you change the visualization. Visualizations include line charts, last known values, and heat maps.

  • The square icon lets you resize the tile.

  • The gear icon lets you configure the visualization. For example, for a line chart visualization you can choose to show the legend and axes, and choose the time range to plot.

Tile types

The following table describes the different types of tile you can add to a dashboard:

Tile Description
Markdown Markdown tiles are clickable tiles that display a heading and description text formatted using markdown. The URL can be a relative link to another page in the application, or an absolute link to an external site.
Image Image tiles display a custom image and can be clickable. The URL can be a relative link to another page in the application, or an absolute link to an external site.
Label Label tiles display custom text on a dashboard. You can choose the size of the text. Use a label tile to add relevant information to the dashboard such descriptions, contact details, or help.
Count Count tiles display the number of devices in a device group.
Map Map tiles display the location of one or more devices on a map. You can also display up to 100 points of a device's location history. For example, you can display sampled route of where a device has been on the past week.
KPI KPI tiles display aggregate telemetry values for one or more devices over a time period. For example, you can use it to show the maximum temperature and pressure reached for one or more devices during the last hour.
Line chart Line chart tiles plot one or more aggregate telemetry values for one or more devices for a time period. For example, you can display a line chart to plot the average temperature and pressure of one or more devices for the last hour.
Bar chart Bar chart tiles plot one or more aggregate telemetry values for one or more devices for a time period. For example, you can display a bar chart to show the average temperature and pressure of one or more devices over the last hour.
Pie chart Pie chart tiles display one or more aggregate telemetry values for one or more devices for a time period.
Heat map Heat map tiles display information about one or more devices, represented as colors.
Last Known Value Last known value tiles display the latest telemetry values for one or more devices. For example, you can use this tile to display the most recent temperature, pressure, and humidity values for one or more devices.
Event History Event History tiles display the events for a device over a time period. For example, you can use it to show all the valve open and close events for one or more devices during the last hour.
Property Property tiles display the current value for properties and cloud properties of one or more devices. For example, you can use this tile to display device properties such as the manufacturer or firmware version for a device.

Currently, you can add up to 10 devices to tiles that support multiple devices.

Customizing visualizations

For tiles that display aggregate values, select the gear icon next to the telemetry type in the Configure chart panel to choose the aggregation. You can choose from average, sum, maximum, minimum, and count.

For line charts, bar charts, and pie charts, you can customize the color of the different telemetry values. Select the palette icon next to the telemetry you want to customize:

Change the color of a telemetry value

For tiles that show string properties or telemetry values, you can choose how to display the text. For example, if the device stores a URL in a string property, you can display it as a clickable link. If the URL references an image, you can render the image in a last known value or property tile. To change how a string displays, in the tile configuration select the gear icon next to the telemetry type or property:

Chane how a string displays on a tile

Next steps

Now that you've learned how to configure your Azure IoT Central default application dashboard, you can Learn how to create a personal dashboard.