Skip to main content

Enable Logging for the CoLab Integration in PTC Creo Parametric

This article describes how to configure logging for the CoLab integration in PTC Creo Parametric. Logging can be adjusted to help troubleshoot issues. Share the log files with support if needed.

Configure the log level using an environment variable

You can define the log level at startup using the COLAB_CREO_LOG_LEVEL environment variable.

Example

COLAB_CREO_LOG_LEVEL=ERROR

Supported values

  • ERROR

  • WARNING

  • INFO

  • DEBUG

Values are case-insensitive.

Configure logging using colab.properties

Logging can also be configured using a colab.properties file that is read once when PTC Creo Parametric starts.

⚠️ Restart PTC Creo Parametric after modifying this file.

File location

The colab.properties file is loaded from the first location where it is found:

  1. Creo working directory

  2. Plugin installation directory, the directory containing colab-creo.dll

Example configuration

Example colab.properties file:

colab_creo_log_level=DEBUG

Precedence

When both configuration methods are used:

  • The environment variable COLAB_CREO_LOG_LEVEL sets the initial log level at startup

  • colab_creo_log_level in colab.properties overrides the environment variable if it is defined and valid.

Log files location

The log files (colab-integration.log and golab-integration.log) are written to the Creo working directory.

If the working directory is changed during the session, new log entries are written to the new working directory.

As a result, log files may be split across multiple working directories for a single session.

Did this answer your question?