Logs settings page

When you encounter an issue in CPSH, the log file provides technical information that can help identify what happened:

  • If something appears to be wrong with the product, check the log file first.
  • When reporting a problem to Collibra Support, include the relevant log files in your support ticket.

Depending on the configuration, the log file shows:

  • Errors that have occurred on the server side.
  • Basic information about performed tasks.
  • Detailed information about every action performed.
  • The date and time an event occurred.
  • The thread executing an action.
  • The log level of the message.

Accessing log files

To access log files, you must have a global role with the Logs > View global permission, such as Sysadmin. You can consult log files on the Settings page or download them for offline use.

Note To optimize system performance, syntax highlighting is enabled only when 100 lines are shown.

If you download the log files, they are compressed. Decompress the files before reading them. You can use any text editor to view the contents.

The information in the log files is determined by the logger and logger level configured in the environment log settings in Collibra Console.

You can also find the log files on the file system of the server, in /opt/collibra_data/<component>/logs. For more information on the Collibra directory structure, see Product architecture.

Log retention

By default, we are using a size and time rolling policy which is configured as follows:

  • The log files are rotated daily or when they reach a file size of 100 MB.
  • There are 30 log files in history, corresponding to a maximum of 30 days.
  • The maximum cumulative size for all log files is 1 GB.

Log files are rotated at the start of a new day (midnight, server time) or when the file size reaches 100 MB. Rotated files are renamed with the current date, for example dgc.2016-09-15.log. The active log file, such as dgc.log, is then reset and starts empty.

You can edit the log retention configuration in logging.properties in collibra_data/dgc/config.

Tip To retain logs for extended periods, generate diagnostic files. Diagnostic files bundle selected logs and environment information into a compressed ZIP archive. These archives, once created and stored in Collibra Console, do not count toward the log file storage limit. Generating diagnostic files periodically is a reliable method for preserving log data beyond the standard rotation cycle, especially for historical analysis or troubleshooting complex workflows.