Support Home Portal Log in
Open navigation

Device Counters - Oyster3 Cellular

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:

  1. Device Details in OEM
  2. 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 IDUseUnits
0Internal Battery Voltage1 mV
3Maximum Temperature0.01 C
4Initial Internal Battery Voltage1 mV
128Successful Uploads1 upload
129Successful Upload Time1 second
130Failed Uploads1 upload
131Failed Upload Time1 second
132Successful GPS Fixes1 fix
133Successful GPS Fix Time1 second
134Failed GPS Fixes1 fix
135Failed GPS Fix Time1 second
138Accelerometer Wakeups1 wakeup
139Trips1 trip
140GPS Fixes Due to 'Upload on Jostle'1 fix
141Uploads Due to 'Upload on Jostle'1 upload
142Uptime1 second

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.