Enabling Debug Mode in Distributed Engine Log Files

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

Enabling Verbose Debug Log Mode via the User Interface

Configure the log mode in Secret Server by doing the following:

1. Log into Secret Server.

2. Search for Distributed Engine. The Distributed Engine page loads.

3. Select a relevant Site from the list and expand it to see each Distributed Engine it has.

4. On the engine you want within that site listing, hover over its name, a 3-dot hidden menu appears on the far right. Click on it.

5. From the drop-down options, select Show Settings. The Engine Settings pop-up appears, example:

   

6. Toggle the Log Level setting so that it is now set to Verbose.

7. Click OK to save your changes.

Downloading Distributed Engine Logs (Cloud / On-Prem)

Downloading the Distributed Engine Log (Cloud)

1. Log into Secret Server.

2. Search for Distributed Engine. The Distributed Engine page loads.

3. Select a relevant Site from the list and expand it to see each Distributed Engine it has.

4. On the engine you want within that Site listing, hover over its name, a 3-dot hidden menu appears on the far right. Click on it.

5. From the drop-down options in the menu, select Download Log.

6. A download pop-up will automatically appear listing the file name, and location options for where you can save the file.

   Example file name: engine-QA-CLOUD-DE01.gamma.thycotic.com

7. Set the local folder location to: C:\Program Files\Thycotic Software Ltd\Distributed Engine\log

8. Click Save to download your log file.

Downloading the Distributed Engine Log (On-Premises)

1. Log into Secret Server.

2. Navigate to Settings.

3. Select Diagnostics and choose Export Logs.

4. Click Collect to trigger collection.

5. Once completed, select Download.

6. Choose the following local folder location: C:\Program Files\Thycotic Software Ltd\Distributed Engine\log, and save your log file.

Enabling Logging Manually on the DE Server

How to enable DEBUG logging mode manually:

1. Log in as an administrator on the Distributed Engine server.

2. Navigate to the C:\Program Files\Thycotic Software Ltd\Distributed Engine directory.

3. Locate the Thycotic.DistributedEngine.Service.exe.config file.

4. Open the file in a text editor.

5. Use Find (Ctrl + F) and search for log4net, which is usually at the top.

6. Locate all entries that contain INFO.

7. Replace each instance of INFO with DEBUG.

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

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

Enabling Verbose Logging Mode Manually on the DE Server

On occasion, you may be instructed to enable the VERBOSE mode to capture extra details for troubleshooting. Do this by using the same procedure as shown in the previous section, but replace INFO or DEBUG with VERBOSE instead.