Visualize IoT device readings
To help you understand the current state of a device, its repair history, and the effect of performed work orders, Connected Field Service displays near real-time device readings and historical sensor measurements in a chart alongside the service history.
The device readings chart is available on the IoT alert, work order, case, device, and asset forms. It supports Azure IoT Hub and custom IoT providers.
To enable the device readings chart, deploy Azure Time Series Insights to your Azure subscription. Administrators can deploy the required services with an ARM template using the IoT Deployment app for Connected Field Service with Azure IoT Hub. Make sure you select Deploy Time Series Insights when choosing which services to deploy.
Time Series Insights (TSI) will be deprecated after March 2025. We'll transition Connected Field Service to a new platform and announce it when the deprecation takes place. More information: Migrate to Azure Data Explorer.
Enable the device readings chart
After successfully deploying Time Series Insights, the Device Readings tab shows on the IoT alert, work order, case, device, and asset forms.
To view device readings, ensure the following data is in place:
|IoT Device||Device ID has a value.|
|IoT alert||The alert has a related IoT device.|
|Work order||The work order has a related IoT alert and the IoT alert has a related IoT device.|
|Case||The case has a related IoT alert and the IoT alert has a related IoT device.|
|Asset||The device readings chart is for the device ID set in Connected Device Attributes section of the asset form.|
Use the device readings chart
Open the Device Readings tab on IoT alert, work order, case, device, or asset form. If the device sends device measurements to Time Series Insights, and the device measurement data exists for the selected time period, the chart loads.
If you select a Custom time period, limit your time range to no more than 90 days.
Select the eye icon next to a measurement to show or hide the measurement on the chart.
Hover over a line in the chart to see a tooltip with measurement details.
The service history (cases and work orders) related to the IoT alert show as pins on the device readings chart. Select a pin to open service history with a link directly to the work order or case. If there's no related service history in the selected time period, this information won't show.
View device readings on the mobile app
Device readings and summary tiles work on the Dynamics 365 Field Service mobile app when connected to the internet. For more information, see Connected Field Service on the mobile app
Azure Active Directory is now Microsoft Entra ID. Learn more.
Use the following table to troubleshoot error codes related to device readings.
|Error code||Possible root cause||Suggested corrective action|
|5000101||Local Config Store isn't available||Contact Microsoft Support to investigate|
|4001002||Value for the Search Span parameter passed to the custom action msdyn_IoTHubQueryDeviceReadings is Null||Verify that the system passes valid values for all the required arguments to the custom action msdyn_IoTHubQueryDeviceReadings|
|4000103||Value for the From or To date argument passed to the custom action msdyn_IoTHubQueryDeviceReadings isn't a valid DateTime||Verify that the system passes valid values for all the required arguments to the custom action msdyn_IoTHubQueryDeviceReadings|
|4000104||Value for the Interval argument passed to the custom action msdyn_IoTHubQueryDeviceReadings isn't a valid Duration||Verify that the system passes valid values for all the required arguments to the custom action msdyn_IoTHubQueryDeviceReadings. For interval, the format should be in the ISO 8601 Duration Format. For example: PT1H|
|4000201||Value for the IotDeviceId argument passed to the custom action msdyn_IoTHubQueryDeviceReadings isn't a valid Guid||Verify that the system passes valid values for all the required arguments to the custom action msdyn_IoTHubQueryDeviceReadings. For IotDeviceId, the value should be the msdyn_iotdeviceid, which is a global unique identifier (GUID).|
|4010202||The user doesn't have permission to query Device Entity (msdyn_iotdevice)||Ensure the user can query Device entity (msdyn_iotdevice)|
|5000203||Unable to get msdyn_DeviceId for the given msdyn_iotdeviceid in the Device Entity (msdyn_iotdevice)||Make sure device has the attribute msdyn_DeviceId|
|5000204||Unable to get Time Series Insights Url for the given msdyn_iotdeviceid||Make sure that Connected Field Service Deployment App has deployed Time Series Insights for this CRM Org and the device is linked to the correct IoT Provider|
|5000205||Client ID used to get Microsoft Entra token for TSI Authorization is invalid or an empty GUID (global unique identifier)||Make sure that the system uses a valid Client ID in the Connected Field Service Deployment App|
|5000206||Client Secret used to get Microsoft Entra token for TSI Authorization has expired||Update the Client Secret in Microsoft Entra and rerun Connected Field Service Deployment App to update the new Client ID and Client Secret|
|5000207||Unable to get the access token to query Time Series Insights||Retry your request, and if the problem persists, try updating new Client ID and Client Secret by rerunning the Connected Field Service Deployment App|
|5000603||Request to Time Series Insights API returned with a failure||Retry your request. If the problem persists, contact Microsoft Support to investigate|
|5000604||Response from Time Series Insights API isn't in an expected format||Retry your request. If the problem persists, contact Microsoft Support to investigate|