Device Statistics
Table of Contents
The Device Statistics (also known as Device Profile Counters) report long term, low frequency counters for performance monitoring and prediction. This is commonly used on battery powered devices.
What do the counters tell us?
Counters will allow you to monitor the performance of each device, such as voltage, GPS fix time, upload time, etc. If certain trends are seen, such as an increased Failed GPS Fixes, this allows the user to determine if certain parameters, such as GPS Settings, or Upload Timeouts will need to be modified, or if the device is simply placed in a location where it cannot receive good signal.
It can also be used for battery usage trends. For example, a failed upload uses up to 20 times the power of a successful upload. This is because a failed upload scans the bands for 3 minutes (registration timeout), while a successful upload is typically done within 5 – 10 seconds. This can be seen in photo of the counters below.
- The device had over 800 uploads with a successful upload time of slightly over 3 hours
- while the roughly 90 failed uploads had the device on, attempting an upload for over 5 hours!
Where are the counters found?
Device Counters can be found via:
- Device Details in OEM
- Device Logs
- Battery Management page in TG
To view within OEM, click on details for the device you are interested in:
This will open a new window. The device counters can be found at the bottom of the details section.
Historical counter values will appear in the Device Logs
However the format is not as readable as in the Device Details Section:
DeviceCounters. DeviceProfiling[0:5311 3:5300 4:5389 128:806 129:12922 130:87 131:20810 132:1586 133:27366 134:384 135:12444 138:1981 139:95 140:0 141:0 142:2382712]
HTTP Connector Settings
Device counters are sent to third party endpoints but OEM filters them out by default for HTTP connections. Contact support and our team can adjust your connector setup to send this information through to your HTTP endpoint.
Counter ID | Use | Units |
0 | Internal Battery Voltage | 1 mV |
3 | Maximum Temperature | 0.01 C |
4 | Initial Internal Battery Voltage | 1 mV |
128 | Successful Uploads | 1 upload |
129 | Successful Upload Time | 1 second |
130 | Failed Uploads | 1 upload |
131 | Failed Upload Time | 1 second |
132 | Successful GPS Fixes | 1 fix |
133 | Successful GPS Fix Time | 1 second |
134 | Failed GPS Fixes | 1 fix |
135 | Failed GPS Fix Time | 1 second |
138 | Accelerometer Wakeups | 1 wakeup |
139 | Trips | 1 trip |
140 | GPS Fixes Due to 'Upload on Jostle' | 1 fix |
141 | Uploads Due to 'Upload on Jostle' | 1 upload |
142 | Uptime | 1 second |
143 |
Tx Count |
1 tx |
144 |
Rx Count |
1 rx |
145 |
Successful Wifi Scans |
1 |
146 |
Failed Wifi Scans |
1 |
147 |
Sensor Sample Count |
1 |
148 |
BLE Module Uptime |
1 s |
149 |
BLE Module Failures |
1 |
150 |
BLE Scans |
1 |
151 |
Power On Resets (since manufacture) |
1 battery insertion |
152 |
Reboots (since POR) |
1 reboot |
153 |
Radar Failures |
1 |
154 |
Radar Scans |
1 |
Reset Statistics
Our battery powered devices provides various indicators like the battery low and battery critical flags, when the batteries are nearing their end of life. This gives the opportunity to get the batteries changed before they go flat.
In certain cases, even after having a battery change and the voltage getting back to normal - above the battery low threshold after a brownout, the flags may not clear.
Generally, this is due to the batteries being changed over very quickly and the device not having a chance to properly reset. For best results after removing batteries, wait around 15 seconds before inserting the next set to be 100% sure.
The latest versions of device firmware incorporate a "Reset Device Statistics" option that will clear the low/critical battery flag and device statistics. This can be accessed from Device Details > Reset Device Statistics.
Or, it can be handled programatically via API call - contact support for OEM WebAPI documentation
For this option to work successfully, ensure
- The device is on the FW which supports this feature. Please check the FW release notes for each device for this information.
- Allow a few update/heartbeats for the device to clear the flags after resetting the statistics.
Note
Resetting the device statistics will also reset the battery percentage for devices with battery meter, regardless of reset was after a battery change or a UVLO.