Enabling Debug Mode in Distributed Engine Log Files

You are viewing documentation for an older version of Secret Server. If you are using Secret Server Cloud visit the current version of this documentation here. If you are using Secret Server On-Premises choose the version that matches yours from this list.
For release dates, end-of-support timelines, and upgrade guidance, see the Secret Server Product Lifecycle page.

This topic discusses enabling DEBUG mode for distributed engine logs for troubleshooting.

Overview

You can expand Secret Server logging capability to locate additional information regarding an error or to help with troubleshooting an issue.

Procedure

How to enable DEBUG logging mode:

  1. Log in as an administrator on the distributed engine server.

  2. Locate the Thycotic.DistributedEngine.Service.exe.config in the C:\Program Files\Thycotic Software Ltd\Distributed Engine directory.

  3. Open the file in a text editor.

  4. Run a find (<Control>+ <F>) command.

  5. Type in log4net and press <Enter> to locate that section, which is usually at the top.

  6. Locate the three lines that contain "INFO"

  7. Replace each INFO with DEBUG.

  8. Restart the Delinea Distributed Engine service to apply the log configuration change.

  9. After DEBUG mode is enabled in the system log, you can reproduce the issue, investigate the error, or send the updated logs in with your support case.

Verbose Mode

On occasion, you may be instructed to enable the VERBOSE mode to capture details for troubleshooting. Do this by using the same procedure and replacing "INFO" or "DEBUG" with "VERBOSE" instead.

Enabling VERBOSE mode will create very detailed log information with large numbers of log files that can accumulate and quickly consume available resources on the machine. Therefore, you should only enable it during the troubleshooting process and immediately turned off afterward in order to prevent performance issues.