Logging types and files

Log messages provide information about the status of components and important events. Administrators and users can use these messages to troubleshoot problems.

IBM® Cognos® Analytics supports different types of logging, including the following main types of logging: audit logging, diagnostic logging, user session logging, and report performance logging.

By default, the IBM Cognos service for each installation sends information to the local install_location/logs directory. The audit messages are saved to the cogaudit.log file, and the diagnostic messages are saved to the cognosserver.log and dataset-service.log files. For audit logs, the administrator can specify the location, size and number of log files in IBM Cognos Configuration. For diagnostic logging, the size and number of log files is set in the Manage part of Cognos Analytics. Diagnostic logs are always written to the install_location/logs directory. Audit logging can be configured to also write to a database, remote log server, or system log. For more information, see Diagnostic logging.

Session logging can be turned on by individual users for a single Cognos Analytics session after administrators enable this type of logging for the system. The messages are logged in the following log files in the install_location/logs directory: cognosserver-session-session_id.log and dataset-service-session-session_id.log. For more information, see Setting up session logging.

Report performance logging

This type of logging is supported in IBM Cognos Analytics - Reporting for individual reports. A report author enables the option to log performance details by selecting the report run option Include performance details. The following details can be viewed in the report output: Total execution time, Query execution time, and Rendering time. Customers can use this information to self-diagnose performance or tuning issues before logging a service request.

For more information, see the sections about running reports and viewing performance details in the IBM Cognos Analytics - Reporting Guide.