The processing activity of the BlackBerry Dynamics runtime is logged, by the runtime itself. The contents of the activity log may be requested for diagnostic purposes, by the BlackBerry Dynamics technical support team. This is typically only necessary for complex support issues.
The activity log can be written to:
The log is only written to the console if detailed logging is allowed by policy.
The log consists of a sequence of messages about runtime activity. Log messages are divided into a number of categories in the activity logging system. These categories can be used to configure the activity log.
Each message in the activity logging system is assigned to one of the following categories.
The activity logging system can be configured not to print some or all of its messages, based on the above categories. In the default configuration, messages in the Errors, Warnings, and Info categories are printed; messages in the Detailed category aren't printed.
Each logging location is configured differently and independently. The developer configures the console log and the enterprise administrator configures the container log.
The console log is only printed if detailed logging is allowed by policy. The policy setting that controls detailed logging can be changed in the enterprise management console.
The categories of message that will be printed to the IDE console are configured in the settings object of the application. There are two ways to set the configuration.
Whichever way the configuration is set, changes to console logging are effective the next time the target is built and run. Changes to console logging have no affect on the container log.
To set a target's activity logging configuration to print all messages, including messages in the Detailed category:
assets/settings.json
file of the application.GDConsoleLogger
array attribute to the settings object, or change the existing atrtribute as follows."GDFilterNone"
Next time the target is built and run, the console will include all log messages.
The following snippet shows a settings object reflecting the above configuration. (The snippet also shows configuration of GDLibraryMode
and the BlackBerry Dynamics entitlement identifier and version, which would be present in the assets/settings.json
file but aren't related to activity logging.)
To set a target's activity logging configuration to print a selection of message categories:
assets/settings.json
file of the application.GDConsoleLogger
array attribute to the settings object, or change the existing atrtribute as follows."GDFilterDetailed"
"GDFilterInfo"
"GDFilterWarnings"
"GDFilterErrors"
"GDFilterAll"
Next time the target is built and run, the console will include log messages that aren't in any of the listed categories.
Tip: Appending an underscore to a string in the above array attribute is an easily reversible way to remove the filter. To reinstate the filter, delete the underscore character.
The following snippet shows a settings object in which warnings and errors are printed and other messages are filtered out. The filters on warnings and errors have been disabled by appending an underscore as described above. (The snippet also shows configuration of GDLibraryMode
and the BlackBerry Dynamics entitlement identifier and version, which would be present in the assets/settings.json
file but aren't related to activity logging.)
The categories of message that are printed to the container log file is configured in the BlackBerry Dynamics management console. Access to the management console is required to set this configuration. See the on-line help and other documentation for instructions.
Detailed category-by-category configuration is not available for the container log file.
Changes to container logging are effective immediately if the application is running and connected to the BlackBerry Dynamics proxy infrastructure. Otherwise, changes are effective as soon as the application does connect. Changes to container logging have no effect on the console log.
Note that the application can cause the container log to be uploaded. See the startUpload documentation.