User diagnostics
Users can turn logging on and off in their native iOS and Android apps and choose the level of logging detail that is captured.
The following list shows the supported levels of logging, from the highest to the lowest level:
- Network
- Debug
- Info
- Warning
- Error
The level of logging that the user chooses includes all the levels below it. For example, if the user chooses Info, then Warning and Error messages are also written to the log file.
The maximum size of a logged message is 2 KB. If a message exceeds this size, it is truncated.
iOS applications
When logging is turned on, a directory named SupportArtifacts is created in the application documents directory. A file named mobile_ios.log is created in the SupportArtifacts directory. All logged events are written to this file.
The maximum size of an active log file is 1 MB. When this size is reached, the active log file contents are moved to a file named mobile_ios.log.old. If a mobile_ios.log.old file exists, it is removed first. A new mobile_ios.log file is created and becomes the active log file.
When logging is disabled, the directory and all its contents are removed from the application documents directory.
Android applications
When logging is turned on, a directory named SupportArtifacts is created in the /Android/data/com.ibm.cogmob.artoo/files directory. A file named cogmob.log is created in the SupportArtifacts directory. All logged events are written to this file.
The maximum size of an active log file is 1 MB. When this size is reached, the active log file contents are moved to a file named cogmob.log.old. If the cogmob.log.old file already exists, it is removed first. A new cogmob.log file is created and becomes the active log file.
When logging is disabled, the directory and all its contents are removed from the application documents directory.