You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/iot-central/core/concepts-telemetry-properties-commands.md
+2-6Lines changed: 2 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Telemetry, property, and command payloads in Azure IoT Central | Microsof
3
3
description: Azure IoT Central device templates let you specify the telemetry, properties, and commands of a device must implement. Understand the format of the data a device can exchange with IoT Central.
4
4
author: dominicbetts
5
5
ms.author: dobett
6
-
ms.date: 10/28/2022
6
+
ms.date: 06/08/2022
7
7
ms.topic: conceptual
8
8
ms.service: iot-central
9
9
services: iot-central
@@ -36,8 +36,6 @@ The JSON file that defines the device model uses the [Digital Twin Definition La
36
36
37
37
For sample device code that shows some of these payloads in use, see the [Create and connect a client application to your Azure IoT Central application](tutorial-connect-device.md) tutorial.
38
38
39
-
To troubleshoot payload errors, see [Unmodeled data issues](troubleshoot-connection.md#unmodeled-data-issues) in the troubleshooting FAQ.
40
-
41
39
## View raw data
42
40
43
41
IoT Central lets you view the raw data that a device sends to an application. This view is useful for troubleshooting issues with the payload sent from a device. To view the raw data a device is sending:
@@ -48,9 +46,7 @@ IoT Central lets you view the raw data that a device sends to an application. Th
48
46
49
47
:::image type="content" source="media/concepts-telemetry-properties-commands/raw-data.png" alt-text="Screenshot that shows the raw data view." lightbox="media/concepts-telemetry-properties-commands/raw-data.png":::
50
48
51
-
On this view, you can select the columns to display, set column widths, set a time range to view, and filter the messages.
52
-
* The **Unmodeled data** column shows data from the device that doesn't match any property or telemetry definitions in the device template.
53
-
* The **Error** column shows any error status for the message. To see details of the error, expand the message.
49
+
On this view, you can select the columns to display and set a time range to view. The **Unmodeled data** column shows data from the device that doesn't match any property or telemetry definitions in the device template.
Copy file name to clipboardExpand all lines: articles/iot-central/core/troubleshoot-connection.md
+9-55Lines changed: 9 additions & 55 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Troubleshoot why you're not seeing data from your devices in IoT Ce
4
4
services: iot-central
5
5
author: dominicbetts
6
6
ms.author: dobett
7
-
ms.date: 10/28/2022
7
+
ms.date: 03/24/2022
8
8
ms.topic: troubleshooting
9
9
ms.service: iot-central
10
10
ms.custom: device-developer, devx-track-azurecli
@@ -178,59 +178,6 @@ Here is a list of common error codes you might see when a device tries to upload
178
178
179
179
When you've established that your device is sending data to IoT Central, the next step is to ensure that your device is sending data in a valid format.
180
180
181
-
### Invalid JSON
182
-
183
-
Use the **Raw data** view in your IoT Central to investigate invalid JSON errors.
184
-
185
-
If the payload from the device includes invalid JSON, the **Raw data** view flags the message with the **JsonValidationError** error in the **Errors** column:
186
-
187
-
:::image type="content" source="media/troubleshoot-connection/raw-data-error.png" alt-text="Screenshot that shows messages with a JSON validation error.":::
188
-
189
-
> [!TIP]
190
-
> To make it easier to find error messages, you can filter the **Raw data** view by error type, change column widths, and change the column order.
191
-
192
-
To see the details of the invalid JSON, expand the message:
193
-
194
-
:::image type="content" source="media/troubleshoot-connection/raw-data-error-detail.png" alt-text="Screenshot that shows the details of a message with invalid JSON.":::
195
-
196
-
The payload shown by IoT Central has an `_error` object that includes the error code and message. It also shows the original invalid JSON payload. The previous example shows that the JSON message contained one or more `,` characters where there should be a `:` character. The device sent a message that looks like:
197
-
198
-
```json
199
-
{
200
-
"payload": [
201
-
{
202
-
"temp", 61.000000,
203
-
"humidity", 70.000000
204
-
},
205
-
{
206
-
"temp", 53.000000,
207
-
"humidity", 60.000000
208
-
}
209
-
]
210
-
}
211
-
```
212
-
213
-
The message should look like:
214
-
215
-
```json
216
-
{
217
-
"payload": [
218
-
{
219
-
"temp": 61.000000,
220
-
"humidity": 70.000000
221
-
},
222
-
{
223
-
"temp": 53.000000,
224
-
"humidity": 60.000000
225
-
}
226
-
]
227
-
}
228
-
```
229
-
230
-
To learn more about message payloads, see [Telemetry, property, and command payloads](concepts-telemetry-properties-commands.md).
231
-
232
-
### Data not appearing in IoT Central
233
-
234
181
To detect which categories your issue is in, run the most appropriate Azure CLI command for your scenario:
235
182
236
183
- To validate telemetry, use the preview command:
@@ -247,9 +194,10 @@ To detect which categories your issue is in, run the most appropriate Azure CLI
247
194
248
195
You may be prompted to install the `uamqp` library the first time you run a `validate` command.
249
196
250
-
The two common types of issue that cause device data to not appear in IoT Central are:
197
+
The three common types of issue that cause device data to not appear in IoT Central are:
251
198
252
199
- Device template to device data mismatch.
200
+
- Data is invalid JSON.
253
201
- Old versions of IoT Edge cause telemetry from components to display incorrectly as unmodeled data.
254
202
255
203
### Device template to device data mismatch
@@ -290,6 +238,12 @@ When you've detected the issue, you may need to update device firmware, or creat
290
238
291
239
If you chose to create a new template that models the data correctly, migrate devices from your old template to the new template. To learn more, see [Manage devices in your Azure IoT Central application](howto-manage-devices-individually.md).
292
240
241
+
### Invalid JSON
242
+
243
+
If there are no errors reported, but a value isn't appearing, then it's probably malformed JSON in the payload the device sends. To learn more, see [Telemetry, property, and command payloads](concepts-telemetry-properties-commands.md).
244
+
245
+
You can't use the validate commands or the **Raw data** view in the UI to detect if the device is sending malformed JSON.
246
+
293
247
### IoT Edge version
294
248
295
249
To display telemetry from components hosted in IoT Edge modules correctly, use [IoT Edge version 1.2.4](https://github.com/Azure/azure-iotedge/releases/tag/1.2.4) or later. If you use an earlier version, telemetry from components in IoT Edge modules displays as *_unmodeleddata*.
0 commit comments