Device Location and Tracking Profile

This profile type is supported on iOS, Android and Blackberry devices.

The Device Location and Tracking Profile sets check-in and location options on devices. This is the only profile that applies to Blackberry devices.

Table Columns

Profile Type - The type of profile.
Name - The name of the profile.
Description - A description of the profile.
Checkin only when connected to WiFi - If checked, the agent only checks in if a WiFi connection is available. This feature is not yet supported.
Checkin Only When Connected to WiFi - If checked, the Kaseya Agent app checks in only if a WiFi connection is available. If unchecked, the Kaseya App, will check in by cell phone network if a WiFi connection is not available.
Track Device - If checked, tracking is enabled. Location data is filtered against a number or predefined parameters to ensure that only accurate and useful location data is actually sent to the VSA. Recorded location data is only sent to the VSA when the agent next checks in. The following general criteria is used -
- Accuracy - Each location update received from a GPS tower or satellite has an accuracy rating, estimating the confidence GPS source has in the accuracy of the location data.
- Age - A device caches location data and may at times pass old location data to the Kaseya Agent app if a new location update has not recently been received.
- Distance traveled - The distance the device has moved since the previous location update. This could be zero if the device has not moved.
Agent Check-in Time (minutes) - This field is ignored by agents installed using Kaseya Agent app version 1.1 and later. Sets the minimum time between check-in attempts. A number of environmental and device operating factors govern exactly when check-in takes place. The lower this value the more battery power is consumed.
Tracking Accuracy (meters) - This value is passed to the GPS receiver as a hint for how accurate the location information pass through should be. The more accurate the request, a lower value, the longer it takes to get the location and more power used.
Minimum Accuracy Before Ignore (meters) - This value controls what location information is considered useful enough to send to the VSA and save. When a device is moving quickly—in a car or train for example—location tracking information becomes less accurate and, at some point, is no longer useful. Location points that are less accurate than this value are filtered out and are not recorded or sent to the VSA. This value more than any other governs the quantity and quality of the location info send from the device.
Tracking Movement Distance - This value defines the minimum distance the device must move, in meters, for a location update event to be triggered and sent to the agent. It also is used by the agent to decide if the location point should be recorded and sent to the VSA. For example if this value is set for 500 meters and the device only moves 10 meters then the agent does not record this point, unless the Minimum / Maximum Tracking Time (minutes) allows it.
Minimum / Maximum Tracking Time (minutes) - These values define how frequently location information points should be recorded. The minimum value defines the minimum time between points. For example if the value is 10 minutes then the location info reported to the agent is not recorded nor sent to the VSA for at least 10 minutes from the last time a good location was reported. However if a good location point has not be recorded within the time period governed by the maximum value, then regardless of accuracy or distance traveled, this point is recorded.

An example of recording a point:

A point is requested at the appropriate tracking accuracy.
If the point returned is has an accuracy value greater than specified in minimum accuracy before ignore, the point is discarded.
If the device has not moved at least the distance specified in tracking movement distance the point is discarded.
If the time elapsed between this point and the previous one recorded is less than the minimum tracking time, the point is discarded.
If the time between this point and the previous one recorded is greater than the maximum tracking time, then the point is recorded, even if the previous checks would have discarded it.