Advanced Logging and Getting Additional Debug Output

Introduction

When working in Foresight Analytics Platform, the kernel forms and displays debug output. This information is not recorded anywhere by default. In some cases it may be needed to determine the cause of some errors. For this purpose, the user can write debug output to a file. All the settings for logging debug information are stored in the operating system registry. Note that outputting debug information to a file slows down the development environment and applications. Thus, remove the parameters specified below after the problem is investigated and the log file is no more required.

Work Log

To output debug information to a file in the registry, make the following changes:

• Create the Log section in the following registry key:

• [HKEY_CURRENT_USER\Software\Foresight\Foresight Analytics Platform\9.0] - when working in the desktop application of Foresight Analytics Platform.

• [HKEY_LOCAL_MACHINE\Software\Foresight\Foresight Analytics Platform\9.0] - when working with BI server of Foresight Analytics Platform.

• Create the following parameters in the Log key:

• FileName. The string parameter that contains path and name of the file, to which the debug information is output.

• SeverityLevel. The DWORD parameter that contains the logging level. The following values can be set for this parameter:

• 0. All debug output generated by Foresight Analytics Platform kernel is registered.

• 1. Warnings, errors and critical errors are registered.

• 2. Errors and critical errors are registered.

• 3. Only critical errors are registered.

• IsolatedByDate. DWORD parameter that specifies whether a file should be split by dates. If the parameter is created and has the 1 value, a new file is created each day, to which debug output is written. The current date is added to the file name.

Development Environment Debug Output

To record debug output generated by the development environment kernel to a file, add the following parameters in the registry:

• In the key [HKEY_CURRENT_USER\Software\Foresight\Foresight Analytics Platform\9.0\Debug] create the following DWORD parameters and set them to 1:

• GCTrace. It specifies whether it is required to register all garbage collector messages.

• DisableMetabaseSqlLog. It disables output of SQL queries to repository system tables to debugging information, which are created on addressing repository objects.

• In the key [HKEY_CURRENT_USER\Software\Foresight\Foresight Analytics Platform\9.0\DevEnv] create the following DWORD parameters and set them to 1:

• DevEnvDebug. Registering information about components creation.

• DevEnvParserDebug. Registering development environment parser information.

NOTE. Development environment debug information is output if the SeverityLevel parameter is set to 0.