Relay Server Tracing

Create the following string values to configure the tracing of Relay Server functions. This is useful for troubleshooting and performance monitoring.
These settings also affect logging for other Ivanti products that originate from RES Software, such as (for example) Ivanti Automation and Ivanti Identity Director.

Enable

Create the following string value to enable the tracing of Relay Server functions.

Key

HKEY_LOCAL_MACHINE\SOFTWARE\RES\LoggingOptions

Value

Enable

Type

REG_DWORD

Data

1

EnableMicroLogging

Create the following string value to enable the capture of additional trace details.

Key

HKEY_LOCAL_MACHINE\SOFTWARE\RES\LoggingOptions

Value

EnableMicroLogging

Type

REG_DWORD

Data

1

EnableFileLogs

Create the following string value to enable tracing to a log file.

Key

HKEY_LOCAL_MACHINE\SOFTWARE\RES\LoggingOptions

Value

EnableFileLogs

Type

REG_DWORD

Data

1

FileLogLocation

Create the following string value to specify the location where to store the trace log file.

Key

HKEY_LOCAL_MACHINE\SOFTWARE\RES\LoggingOptions

Value

FileLogLocation

Type

REG_SZ

Data

<trace log filepath>

For example C:\Temp\RESTrace

MaxLogFileSizeMB

Create the following string value to specify the size of the trace log file in MB.

Key

HKEY_LOCAL_MACHINE\SOFTWARE\RES\LoggingOptions

Value

MaxLogFileSizeMB

Type

REG_DWORD

Data

<trace log file size>

For example 32

  • When the file reaches the maximum size, it overwrites the log from the start. Information that is overwritten, is lost.
  • If no maximum size is specified, the size of the file keeps increasing.

FreeDiskspacePercent

Create the following string value to specify the required minimum free disk space in percent for logging to be written.

Key

HKEY_LOCAL_MACHINE\SOFTWARE\RES\LoggingOptions

Value

FreeDiskspacePercent

Type

REG_DWORD

Data

<free disk space>

For example 15

FileLogThreshold

Create the following string value to specify the level of detail in the trace file.

Key

HKEY_LOCAL_MACHINE\SOFTWARE\RES\LoggingOptions

Value

FileLogThreshold

Type

REG_DWORD

Data

1 through 7

  • 1 (debug)
  • 2 (info)
  • 3 (status)
  • 4 (warning)
  • 5 (error)
  • 6 (critical)
  • 7 (fatal)