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, will need to be modified.
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
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]
Note:
Counters are only sent when the devices are able to commit. Counters and Device Logs are not available when devices are set to 3rd party direct mode.
HTTP Connector Settings
Device counters are sent to third party endpoints but OEM filters them out by default for HTTP connections. To send the device counters through the HTTP connector the below will need to be added to the XML of your connector.
<add key="removeCounters" value="false"/>
Counter ID's:
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 |