Skip to content

Commit ba83385

Browse files
authored
Merge pull request #218767 from dominicbetts/central-revert-error-view
IoT Central: temporary revert of previous PR
2 parents e3c27f2 + 98a315c commit ba83385

File tree

4 files changed

+11
-61
lines changed

4 files changed

+11
-61
lines changed

articles/iot-central/core/concepts-telemetry-properties-commands.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Telemetry, property, and command payloads in Azure IoT Central | Microsof
33
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.
44
author: dominicbetts
55
ms.author: dobett
6-
ms.date: 10/28/2022
6+
ms.date: 06/08/2022
77
ms.topic: conceptual
88
ms.service: iot-central
99
services: iot-central
@@ -36,8 +36,6 @@ The JSON file that defines the device model uses the [Digital Twin Definition La
3636

3737
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.
3838

39-
To troubleshoot payload errors, see [Unmodeled data issues](troubleshoot-connection.md#unmodeled-data-issues) in the troubleshooting FAQ.
40-
4139
## View raw data
4240

4341
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
4846

4947
:::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":::
5048

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.
5450

5551
## Telemetry
5652

Binary file not shown.
Binary file not shown.

articles/iot-central/core/troubleshoot-connection.md

Lines changed: 9 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Troubleshoot why you're not seeing data from your devices in IoT Ce
44
services: iot-central
55
author: dominicbetts
66
ms.author: dobett
7-
ms.date: 10/28/2022
7+
ms.date: 03/24/2022
88
ms.topic: troubleshooting
99
ms.service: iot-central
1010
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
178178

179179
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.
180180

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-
234181
To detect which categories your issue is in, run the most appropriate Azure CLI command for your scenario:
235182

236183
- 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
247194
248195
You may be prompted to install the `uamqp` library the first time you run a `validate` command.
249196
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:
251198
252199
- Device template to device data mismatch.
200+
- Data is invalid JSON.
253201
- Old versions of IoT Edge cause telemetry from components to display incorrectly as unmodeled data.
254202
255203
### 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
290238

291239
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).
292240

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+
293247
### IoT Edge version
294248

295249
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

Comments
 (0)