Skip to content

Colota - Android GPS Location tracker

feat: log GPS tracking heartbeat every 5 minutes for stall diagnostics

Max Dietrichf9f25446cce5
diff --git a/apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt b/apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt
index 0a3ff6a1..be3b37e8 100644
--- a/apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt
+++ b/apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt
@@ -51,6 +51,8 @@ class LocationForegroundService : Service() {
@Volatile private var serviceScope: CoroutineScope? = null
@Volatile private var locationUpdateCallback: LocationUpdateCallback? = null
@Volatile private var locationRestartJob: Job? = null
+ @Volatile private var trackingHeartbeatJob: Job? = null
+ @Volatile private var lastFixAtMs: Long = 0L
@Volatile private var motionDetector: MotionDetector? = null
@Volatile private var insidePauseZone = false
@Volatile private var isWifiPaused = false
@@ -77,6 +79,8 @@ class LocationForegroundService : Service() {
private const val ENTRY_DELAY_MULTIPLIER = 3.5
/** Debounce before resuming GPS after unmetered network is lost (ms). */
private const val WIFI_RESUME_DEBOUNCE_MS = 2_000L
+ /** Cadence at which the tracking heartbeat logs time-since-last-fix for diagnostics. */
+ private const val TRACKING_HEARTBEAT_INTERVAL_MS = 5 * 60_000L
const val ACTION_MANUAL_FLUSH = "com.Colota.ACTION_MANUAL_FLUSH"
const val ACTION_RECHECK_ZONE = "com.Colota.RECHECK_PAUSE_ZONE"
const val ACTION_REFRESH_NOTIFICATION = "com.Colota.REFRESH_NOTIFICATION"
@@ -284,10 +288,12 @@ class LocationForegroundService : Service() {
val callback = object : LocationUpdateCallback {
override fun onLocationUpdate(location: android.location.Location) {
+ lastFixAtMs = SystemClock.elapsedRealtime()
handleLocationUpdate(location)
}
}
locationUpdateCallback = callback
+ lastFixAtMs = SystemClock.elapsedRealtime()
if (deviceInfoHelper.isBatteryCritical(threshold = 5)) {
val (level, _) = deviceInfoHelper.getCachedBatteryStatus()
@@ -319,6 +325,8 @@ class LocationForegroundService : Service() {
},
onFailure = { /* initial location unavailable, updates will arrive */ }
)
+
+ startTrackingHeartbeatLogger()
} catch (e: SecurityException) {
AppLogger.e(TAG, "Location permission missing", e)
stopForegroundServiceWithReason("Location permission missing")
@@ -329,10 +337,35 @@ class LocationForegroundService : Service() {
}
private fun stopLocationUpdates() {
+ cancelTrackingHeartbeatLogger()
locationUpdateCallback?.let { locationProvider.removeLocationUpdates(it) }
locationUpdateCallback = null
}
+ /**
+ * Diagnostic-only periodic logger. Records "time since last GPS fix" every 5 minutes
+ * to the activity log so silent stalls (eg stale FLP binding after long uptime) become
+ * visible in user-exported logs. Does not take any recovery action - data only.
+ */
+ private fun startTrackingHeartbeatLogger() {
+ trackingHeartbeatJob?.cancel()
+ val scope = serviceScope ?: return
+ trackingHeartbeatJob = scope.launch {
+ while (isActive) {
+ delay(TRACKING_HEARTBEAT_INTERVAL_MS)
+ if (isWifiPaused || isMotionlessPaused) continue
+ if (locationUpdateCallback == null) continue
+ val sinceLastFix = SystemClock.elapsedRealtime() - lastFixAtMs
+ AppLogger.i(TAG, "Tracking alive: ${sinceLastFix / 1000}s since last fix")
+ }
+ }
+ }
+
+ private fun cancelTrackingHeartbeatLogger() {
+ trackingHeartbeatJob?.cancel()
+ trackingHeartbeatJob = null
+ }
+
private fun handleZoneRecheckAction() {
geofenceHelper.invalidateCache()