Tutorial: Use device groups to analyze device telemetry (preview features)
You're currently viewing the IoT Central documentation for application templates that use preview features. To view the documentation for application templates that use generally available features, go to What is Azure IoT Central?.
This article describes how, as an operator, to use device groups to analyze device telemetry in your Azure IoT Central application.
A device group is a list of devices that are grouped together because they match some specified criteria. Device groups help you manage, visualize, and analyze devices at scale by grouping devices into smaller, logical groups. For example, you can create a device group to list all the air conditioner devices in Seattle to enable a technician to find the devices for which they're responsible.
In this tutorial, you learn how to:
- Create a device group
- USe a device group to analyze device telemetry
Before you begin, you should complete the Create an Azure IoT Central application and Add a simulated device to your IoT Central application quickstarts to create the Environment Sensor device template to work with.
Create simulated devices
Before you create a device group, add at least five simulated devices from the Environment Sensor device template to use in this tutorial:
For four of the environmental sensor devices, use the Environmental Sensor properties view to set the customer name to Contoso:
Create a device group
To create a device group:
Choose Device Groups on the left pane.
Select + New.
Give your device group a name such as Contoso devices. You can also add a description. A device group can only contain devices from a single device template. Choose the Environmental Sensor device template to use for this group.
Create the query to identify the devices belonging to Contoso for the device group by selecting the Customer Name property, the Equals comparison operator, and Contoso as the value. You can add multiple queries and devices that meet all the criteria are placed in the device group. The device group you create is accessible to anyone who has access to the application, so anyone can view, modify, or delete the device group.
The device group is a dynamic query. Every time you view the list of devices, there may be different devices in the list. The list depends on which devices currently meet the criteria of the query.
For Azure IoT Edge devices, select Azure IoT Edge templates to create a device group.
You can use Analytics with a device group to analyze the telemetry from the devices in the group. For example, you can plot the average temperature reported by all the Contoso environmental sensors.
To analyze the telemetry for a device group:
Choose Analytics on the left pane.
Select the Contoso devices device group you created. Then add both the Temperature and Humidity telemetry types:
Use the gear-wheel icons next to the telemetry types to select an aggregation type. The default is Average. Use Split by to change how the aggregate data is shown. For example, if you split by device ID you see a plot for each device when you select Analyze.
Select Analyze to view the average telemetry values:
You can customize the view, change the time period shown, and export the data.
Now that you've learned how to use device groups in your Azure IoT Central application, here is the suggested next step: