Enabling diagnostic logging for Cognos Analytics Reports

Diagnostic logging is used for intermittent or service-specific problems.

The diagnostic logging messages are logged in the cognosserver.log file in the install_location/logs directory.

For more information, see Diagnostic logging.

About this task

You can enable diagnostic logging for Cognos Analytics Reports on the built-in MOB topic. This type of logging also includes audit and performance information.

If you want to enable the type of logging that was provided by the install_location\configuration\mob.log4j.xml and install_location\configuration\mob.log4j.xml.DEBUG.sample files in previous versions of Cognos® Analytics, use the mobile_service.json and mobile_service-DEBUG.json specs that are provided in the Procedure section.

With the mobile_service.json spec, you can monitor the mobile service for events such as database schema upgrades, changes to configuration settings and advanced settings, and warnings and errors. With the mobile_service-DEBUG.json spec, full debug-level logging is enabled.

Procedure

Go to Manage > Configuration.
Select the Diagnostic logging tab.
To use the built-in MOB logging topic, do the following tasks:
1. Click the Built-in topics tab.
2. Select the Show all checkbox.
3. Find the MOB topic, and select it.
4. Click Apply.

To enable logging based on the mobile_service.json spec, do the following tasks:

Copy the following spec into Notepad, and save it as mobile_service.json file.

{
    "loggerDefinitions": [
        {
            "loggerName": "com.cognos.mobile.vm",
            "level": "WARN",
            "additivity": true
        },
		{
            "loggerName": "com.cognos.mobile.assembler",
            "level": "ERROR",
            "additivity": true
        },
		{
            "loggerName": "com.cognos.mobile.database",
            "level": "WARN",
            "additivity": true
        },
		{
            "loggerName": "com.cognos.mobile.database.SchemaUpgrader",
            "level": "INFO",
            "additivity": true
        },
		{
            "loggerName": "com.cognos.mobile.task.ThreadPool",
            "level": "ERROR",
            "additivity": true
        },
		{
            "loggerName": "com.cognos.mobile.server.core.SCConfiguration",
            "level": "INFO",
            "additivity": true
        },
		{
            "loggerName": "com.cognos.mobile.standardedition.SETransformHelper",
            "level": "ERROR",
            "additivity": true
        },
		{
            "loggerName": "com.cognos.mobile.database.SQLTempStorageDAO",
            "level": "ERROR",
            "additivity": true
        },
		{
            "loggerName": "com.cognos.mobile.server.core.SCUserSessionCache",
            "level": "WARN",
            "additivity": true
        },
		{
            "loggerName": "com.cognos.mobile",
            "level": "WARN",
            "additivity": true
        }
    ],
    "topicName": "mob_service"
}

Click the Custom topics tab.
Click the Upload topic icon , and upload the mobile_service.json file.

The mob_service topic appears on the Custom topics tab.
Select the mob_service topic, and click Apply.

To enable logging based on the mob_service_DEBUG.json spec, do the following tasks:
1. Copy the following spec into Notepad, and save it as mob_service_DEBUG.json file:
```
{
    "loggerDefinitions": [        
		{
            "loggerName": "com.cognos.mobile",
            "level": "DEBUG",
            "additivity": true
        }
    ],
    "topicName": "mob_service_DEBUG"
}    
```
2. Click the Custom topics tab.
3. Click the Upload topic icon , and upload the mob_service_DEBUG.json file.
  
  The mob_service_DEBUG topic appears on the Custom topics tab.
4. Select the mob_service_DEBUG topic, and click Apply.