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.
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.
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.
log
files are the only type of files that can be parsed and analyzed with the reports feature.
- Open the navigation menu.
- Select the Data Files item.
- Double-click the desired data file.
There are a few buttons in the top right of the file viewer:
- (
log
files only) Click thebutton to view a chart of the file's data. - (
gps
files only) Click thebutton to view a map of the file's data. - Click the
button to go directly to the device associated with the data file. - Click the
button to download the file. - (
log
files only) Click thebutton to download the parquet files associated with the data file. - Click the
button to delete the file. - Deleting the file will route back to the data files list page.
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.
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.