Data File

Data files are uploaded to Spoke Zone from devices and can be used for analytics in a variety of ways. Some files can be integrated into reports to view chart representations of data, while others provide debugging and logging information, such as logs of alert triggers or device console output.

Caution

Spoke Zone does not enforce or regulate files’ formatting and/or contents. It is up to the device’s code to upload files of the correct types and with the proper formatting.

File Types

There are 7 different file types, each recording a different type of data:

• log files (trace files) are used for recording CAN messages.
  • These can be parsed so the data can be analyzed in reports in the form of graphs, tables, and maps.
• event files record data about alert triggers.
• gps files contain the changing GPS coordinates of a device
  • These can be parsed and analyzed in a map view.
• debug files are used for console output from a device.
• journal files provide logs of systemd processes.
• dmesg files contain message logs from the Linux kernel ring buffer.
• txt files can contain anything. These are just general all-purpose files.

Note

log files are the only type of files that can be parsed and analyzed with the reports feature.

Access Data Files

1. Open the navigation menu.
2. Select the Data Files item.
3. Double-click the desired data file.

File Viewer Actions

There are a few buttons in the top right of the file viewer:

• (log files only) Click the Open chart button to view a chart of the file’s data.
• (gps files only) Click the Open map button to view a map of the file’s data.
• Click the Device button to go directly to the device associated with the data file.
• Click the Download button to download the file.
• (log files only) Click the Download Parquets button to download the parquet files associated with the data file.
• Click the Delete button to delete the file.
  • Deleting the file will route back to the data files list page.

Data File Charts/Maps

A log file can be viewed in a chart that parses the file’s data and compiles it into a more human-readable table or graph.

A gps file can be viewed on a map that shows all of its latitude/longitude coordinates and connects them chronologically.

Note

The charts/maps created for individual log and gps are not reports and cannot be found from the reports list page. They are only designed to display data from a single file.

However, the process for setting up charts for a log file is very similar to the setup of a report. See here for a detailed description.