Logger class
Logger API
The Background Geolocation SDK includes powerful logging features for debugging location-tracking problems. The SDK stores log-entries for a period of Config.logMaxDays (default 3
). The volume of logging events
inserted into the database is controlled via Config.logLevel.
Fetching the Logs:
Logs can be fetched from the SDK in three ways:
Inserting your own log messages
You can even insert your own log messages into the SDK's Log database using the following methods:
method | logLevel | icon |
---|---|---|
error | ERROR |
âī¸ |
warn | WARNING |
â ī¸ |
debug | DEBUG |
đ |
info | INFO |
âšī¸ |
notice | INFO |
đĩ |
BackgroundGeolocation.onLocation((Location location) {
Logger.debug("Location received: $location");
});
Example Logs
09-19 11:12:18.716 ââââââââââââââââââââââââââââââââââââââââââââââ
09-19 11:12:18.716 â BackgroundGeolocation Service started
09-19 11:12:18.716 â âââââââââââââââââââââââââââââââââââââââââââââ
09-19 11:12:18.723 [c.t.l.BackgroundGeolocationService d]
09-19 11:12:18.723 â
Started in foreground
09-19 11:12:18.737 [c.t.l.ActivityRecognitionService a]
09-19 11:12:18.737 đž Start activity updates: 10000
09-19 11:12:18.761 [c.t.l.BackgroundGeolocationService k]
09-19 11:12:18.761 đ´ Stop heartbeat
09-19 11:12:18.768 [c.t.l.BackgroundGeolocationService a]
09-19 11:12:18.768 đž Start heartbeat (60)
09-19 11:12:18.778 [c.t.l.BackgroundGeolocationService a]
09-19 11:12:18.778 đĩ setPace: null â false
09-19 11:12:18.781 [c.t.l.adapter.TSConfig c] âšī¸ Persist config
09-19 11:12:18.794 [c.t.locationmanager.util.b a]
09-19 11:12:18.794 âšī¸ LocationAuthorization: Permission granted
09-19 11:12:18.842 [c.t.l.http.HttpService flush]
09-19 11:12:18.842 ââââââââââââââââââââââââââââââââââââââââââââââ
09-19 11:12:18.842 â HTTP Service
09-19 11:12:18.842 â âââââââââââââââââââââââââââââââââââââââââââââ
09-19 11:12:19.000 [c.t.l.BackgroundGeolocationService onActivityRecognitionResult] still (100%)
09-19 11:12:21.314 [c.t.l.l.SingleLocationRequest$2 onLocationResult]
09-19 11:12:21.314 ââââââââââââââââââââââââââââââââââââââââââââââ
09-19 11:12:21.314 â SingleLocationRequest: 1
09-19 11:12:21.314 â âââââââââââââââââââââââââââââââââââââââââââââ
09-19 11:12:21.314 ââ đ Location[fused 45.519239,-73.617058 hAcc=15]999923706055 vAcc=2 sAcc=??? bAcc=???
09-19 11:12:21.327 [c.t.l.l.TSLocationManager onSingleLocationResult]
09-19 11:12:21.327 đĩ Acquired motionchange position, isMoving: false
09-19 11:12:21.342 [c.t.l.l.TSLocationManager a] 15.243
09-19 11:12:21.405 [c.t.locationmanager.data.a.c persist]
09-19 11:12:21.405 â
INSERT: bca5acc8-e358-4d8f-827f-b8c0d556b7bb
09-19 11:12:21.423 [c.t.l.http.HttpService flush]
09-19 11:12:21.423 ââââââââââââââââââââââââââââââââââââââââââââââ
09-19 11:12:21.423 â HTTP Service
09-19 11:12:21.423 â âââââââââââââââââââââââââââââââââââââââââââââ
09-19 11:12:21.446 [c.t.locationmanager.data.a.c first]
09-19 11:12:21.446 â
Locked 1 records
09-19 11:12:21.454 [c.t.l.http.HttpService a]
09-19 11:12:21.454 đĩ HTTP POST: bca5acc8-e358-4d8f-827f-b8c0d556b7bb
09-19 11:12:22.083 [c.t.l.http.HttpService$a onResponse]
09-19 11:12:22.083 đĩ Response: 200
09-19 11:12:22.100 [c.t.locationmanager.data.a.c destroy]
09-19 11:12:22.100 â
DESTROY: bca5acc8-e358-4d8f-827f-b8c0d556b7bb
09-19 11:12:55.226 [c.t.l.BackgroundGeolocationService onActivityRecognitionResult] still (100%)
Constructors
- Logger()
Properties
- hashCode â int
-
The hash code for this object.
no setterinherited
- runtimeType â Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
noSuchMethod(
Invocation invocation) â dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) â String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) â bool -
The equality operator.
inherited
Static Methods
-
debug(
String msg) â Future< void> - Inserts a debug log message into the SDK's log database
-
destroyLog(
) â Future< bool> - Destroy the entire contents of plugin's log database.
-
emailLog(
String email, [SQLQuery? query]) â Future< bool> - Email the result of getLog using device's mail client. Provide an optional SQLQuery to contrain results between dates.
-
error(
String msg) â Future< void> - Inserts an "error" log message into the SDK's log database
-
getLog(
[SQLQuery? query]) â Future< String> -
Returns the contents of the log database as a
String
. Provide an optional SQLQuery to contrain results between dates. -
info(
String msg) â Future< void> - Inserts an "info" log message into the SDK's log database
-
notice(
String msg) â Future< void> - Inserts a "notice" log message into the SDK's log database
-
uploadLog(
String url, [SQLQuery? query]) â Future< bool> - Upload the result of getLog to provided url. Provide an optional SQLQuery to contrain results between dates. The file-upload request will attach your configured Config.headers for authentication.
-
warn(
String msg) â Future< void> - Inserts a "warning" log message into the SDK's log database