Mobile Logging

Overview

The Mobile Logging feature provides a way for client application messages to be saved and viewed. Logging application messages can be useful when troubleshooting application issues, developing new features or creating new mobile applications. Logging application messages adds additional overhead to the application execution and may affect application performance. Logging should be disabled for normal use

Logging Writers

The logging output is determined by the Log Writers.

There are three Log Writers available

• Console

  Writes log messages to the browser or device console.

• File

  Writes log messages to a file located on the device. The log messages are written to the archibusmobile.log file.

• Database

  Writes log messages to a table in the device database. Messages can be synced to the Web Central database for viewing and analysis.

At least one Logging Writer must be enabled to record log messages.

Logging Settings

The mobile logging settings can be accessed from the Mobile Client application screen

To enable or change the logging settings tap the Settings icon () then select Logging from the Preferences tab

The Logging Settings form will be displayed.

The following Logging settings are available:

• Logging

  Enables or disables the Logging feature.

• Minimum Level

  Sets the level of the reported messages. The reported messages will be limited to the selection and any higher priority errors. Selecting VERBOSE will result in ALL messages being reported. Selecting ERROR will report only messages that are the result of an application error. Selecting INFO will report messages in the INFO, DEPRECATE, WARN and ERROR categories.

• Console Writer - Enabled

  Writes messages to the device console when enabled

  Note: The Console Writer is enabled by default when executing the Mobile Apps in the desktop development environment

• File Writer - Enabled

  Writes messages to a file on the device when enabled.

• File Writer - Max. File Size

  The maximum log file size in bytes. The log file is archived when the size of the file exceeds this setting

• File Writer - Archived Files

  The number of archived log files to keep on the device. The oldest log file is deleted from the device if the number of archived files exceeds this setting.

• Database Writer - Enabled

  Writes messages to a table in the device database when enabled.

• Database Writer - Max. Records

  Sets the maximum number of records allowed in the device database log table. Older records will be deleted from the log table if this value is exceeded.

Viewing Log Output

There are several ways to view the contents of the mobile log. The viewing options depend on the log writer or writers that are enabled

Console Writer

Output from the Console Writer can be viewed in the Chrome Developer Console when executing the mobile apps in the desktop environment. There are debugging tools available that allow the console messages to be viewed when the mobile apps are executing on the device.

File Writer

Messages recorded by the File Writer can be viewed by tapping the Display Log button on the Logging Settings form.

Database Writer

Messages recorded by the Database Writer can be viewed in Web Central after the messages have been synced from the device.

To view the mobile log messages in Web Central

1. Open the Logging Settings form on the Mobile Client
2. Tap Sync Log
3. Open the Mobile Log view in Web Central by navigating to System Administration | Mobile Apps Manager | View Mobile Log
4. Enter the desired view parameters

Note: The mobile log message timestamps are recorded in GMT time. Use GMT time when entering the time parameters in the Mobile Log view.