Enabling diagnostic logging for different topics

You can enable diagnostic logging on a specific product component, service, or function by changing the logging topic.

IBM® Cognos® Analytics processes the log messages from the product services using internally defined loggers. These loggers are abstracted into logging topics. The DEFAULT LOGGING topic that is set for diagnostic logging uses a set of logger names that are set at specific error levels. This is done so that the default logging is not too verbose and records only the most important messages.

You can enable diagnostic logging on a built-in topic or on a custom topic. To create a custom topic, you can download a JSON spec for a built-in topic and use it as a basis for creating your custom topic. Custom topics can be modified, but built-in topics cannot be modified.

Procedure

  1. Go to Manage > Configuration.
  2. Select the Diagnostic logging tab.
  3. Select one of the built-in or custom topics for which you want to enable logging.
    By default, the following built-in topics are available:
    • AAA - Access Manager Authentication logging
    • CM - Content Manager logging
    • DEFAULT LOGGING - logging using default settings
    • DISP - Dispatcher logging
    • MOSER - Modeling service logging
    • POGO_MSGS - Dispatcher SOAP message logging

    To see all built-in topics, select the Show all checkbox.

    For example, to generate logs for Cognos Analytics Mobile Reports, select the MOB topic.

  4. Click Apply.
  5. To restore DEFAULT LOGGING, click Reset.
  6. To create a custom topic, do the following:
    1. Click the Built-in topics tab.
    2. Click the More icon more icon next to a built-in topic that is similar to the one you want to create and then select Download topic.
    3. Edit the file and save it on your computer as filename.json.
    4. Click the Custom topic tab.
    5. Click the Upload topic icon upload topic icon

      Your new topic appears as an entry on the Custom topics tab.

Results

The logs are now written to the cognosserver.log and dataset-service.log files in the install_location/logs directory.