Viewing device data

Who can do it: Service provider
Where: Wialon Platform Studio

The Data tab in the device details is used for technical diagnostics. It shows the data received from the device in the Messages, Chart and Raw views.

To open it, go to the Devices page, click the required device in the list, and switch to the Data tab.

By default, the tab shows the data received during the last two hours. You can change this period using the date picker. Changing the period in one view also changes it in the other views.

Messages

The Messages view allows you to check the parsed messages received from the device. The messages are listed in a table with fields such as Time, Server time, Speed, Address, Satellites, and Other data. To use the view:

  1. In the date picker, select the period for which you want to see the received messages. Click Apply.

  2. Click the icon in the message row.

  3. Select Open message details.

  4. See the parsed parameters in the Message details section. To quickly find the required parameter, start typing its name in the search field.

  5. Verify the device data.

To find the required messages in the table, use the parameter filters in the search field. When you apply filters to the table of messages, they’re also applied to the track.

When you select a message in the table, the map zooms in to the corresponding point on the track.

Creating a sensor template from a message parameter

Apart from creating sensors and sensor templates on the Sensors tab and Telemetry setup page, you can create sensors from parameters in the Message details section.

  1. Go to the Data tab within the selected device.

  2. Select the message with the required parameter. If you don’t find the necessary message among the displayed ones, increase the selected time period.

  3. Click the icon in the message row.

  4. Select Open message details.

  5. In the Message details section, select the required parameter.

  6. Click the icon .

  7. Select the sensor type.

  8. Edit the sensor name or leave the one suggested by the platform.

  9. Select the measurement unit.

  10. Click Create.

After this, the platform creates the sensor template and a sensor based on this template.

If a sensor of the selected type already exists for the device, the new setup replaces the existing one.

The created sensor is displayed on the Sensors tab. You can reuse the same sensor template for other devices when creating sensors of the same sensor type.

Chart

The Chart view shows how the values of the device parameters changed over the selected period. Use it to compare several parameters on one timeline and find the moments when the device reported unexpected values.

To build and analyze a chart:

  1. In the date picker, select the period you need and click Apply.
  2. In the legend above the chart, click the parameters you want to display, for example, position.speed. The selected parameters are highlighted in color, and the others stay grey.
  3. To see the rest of the parameters, use the arrows on the right of the legend. The indicator next to them shows the current page and the total number of pages.
  4. Point to the chart to see the values of the selected parameters at a specific moment.

Each parameter is drawn as a separate line with its own color. The horizontal axis shows the time of the messages, and the vertical axis shows the parameter values.

To zoom in on a part of the period, use the slider below the chart: drag its edges to narrow the range or move it to shift the range without changing its length.

Viewing the track

On the Messages and Chart tabs, you can see the map which shows the track built from the messages of the selected period. Each point on the track corresponds to a received message.

Arrows on the track show the direction of movement. The start of the track is marked with a circle, and the finish is marked with a square.

To work with the track:

  • Hower over a track point to see the date and time of the corresponding message.
  • Click a point on the track to select the corresponding message and see the values reported at that moment.

When you apply search filters to the table of messages, they’re also applied to the track. The matching points are shown in blue, and the rest of the track is shown in gray.

To show or hide the map, click the map button and select how to display the map: Hidden, Below the table or Beside the table.

Raw

The Raw view shows the data packets as the platform receives them from the device. It can be used by developers and support staff to troubleshoot connectivity issues and verify the raw data stream.

The packets are listed in a table with the following columns:

Column Description
Timestamp The date and time of the packet with milliseconds and the time zone offset, for example, 2026-10-12 13:30:45.356 (+00:00). You can’t hide this column.
Session The identifier of the connection session within which the packet was transferred.
Type The type of the record. The following types are available:
- Connected: the device opened a new connection session. Such records don’t contain data.
- Disconnected: the connection session ended. Such records don’t contain data either.
- Data received: the platform received the packet from the device.
- Data sent: the platform sent the packet to the device.
Connection type The protocol used to transfer the packet, for example, TCP.
Size The size of the packet in bytes.
Content The content of the packet in the hexadecimal format. Click the icon in the packet row to copy the content.

If the platform rejects a packet received from the device, the packet is marked in the table, and the reason for the rejection is shown in the packet row. Click the row to find out what caused the problem. In the packet details, the bytes that caused the rejection are highlighted. The platform also suggests the action you should take to fix the problem.

To load the packets that the platform received after you opened the view, click the icon on the right of the search field. To see when the data was last updated, point to this icon.

Managing the packet table

You can manage the table of packets (sort the data, hide and reorder columns, adjust their width, reset to default) in the same way as the table of devices.

If you sort the table by the Timestamp column, the same sorting order is applied to the table in the Messages view, and vice versa. By defalt, the packets are sorted from newest to oldest.

Searching and filtering packets

To find specific packets, use the search field above the table. The following filters are available: Session, Type, Connection type, Size, and Content.

To find the required packets, select the filter you want to use and specify its value as described in the table below.

Filter How to use
Session, Size Select the comparison operator (=, ≠, >, ≥, <, or ≤), and then select one of the suggested values.
Type, Connection type Select the required values and click Apply. To select all the values at once, select the checkbox at the top of the list.
Content Enter the content you want to find.

After applying the filter, the table shows only the packets that match the filter value.

You can combine several filters, for example, to find the packets of a specific session transferred over TCP. To do this, click the search field again and select the next filter. The table shows only the packets that match all the applied filters.

To remove a filter, click the cross icon next to its value in the search field. To remove all the filters at once, click the icon on the right of the search field.

Copying and exporting packets

You can copy the packet table or save it to a file, for example, to send it to the support team or analyze the packets in another tool. If filters are applied, only the filtered packets are exported.

To copy or export the table, click the button on the right of the search field and select the required option:

Option Description
Copy as shown, Copy as HEX, Copy as RAW Copy the packets to the clipboard.
Export as shown, Export as HEX, Export as RAW Save the packets to a text file.
Export CSV as shown, Export CSV as HEX, Export CSV as RAW Save the packets to a CSV file.

The last part of the option name defines the format of the packet content:

  • As shown: the content is exported in the same form as in the table.
  • HEX: the content is exported in the hexadecimal format.
  • RAW: the content is exported as raw data, without any conversion.

Viewing packet details

To analyze the content of a packet byte by byte, click the packet row.

The packet content is shown in rows. Each of them contains the following data:

  • On the left: the offset of the first byte in the row from the beginning of the packet, in the hexadecimal format.
  • In the middle: the bytes in the hexadecimal format.
  • On the right: the same bytes as text characters. The bytes that can’t be shown as characters are replaced with dots.

To find specific bytes in the packet, use the search field. You can enter the bytes in the hexadecimal format (for example, EF59 or 0x0F 0D) or specify text in quotation marks (for example, "862272").

You can read any byte as a decimal or binary number. To do this, click the byte. Its decimal (DEC) and binary (BIN) values are shown below the packet content.

To copy the packet data for the support team, click Copy for support.

If you find a mistake in the text, please select it and press Ctrl+Enter.