Deployment Guide › iConsole › Post-deployment Tasks › General Setup Tasks › Configure iConsole Log Files

Configure iConsole Log Files

To configure iConsole logging, modify values in the \WebService\Logging registry key. Within this registry key, edit the following values:

LogLevel

Type: REG_DWORD

Data: Defaults to 2. This value determines the logging level. For example, you can configure the iConsole to only log errors or warning system messages.

Log entries are written to the iConsole_<date>.log file, where <date> is the date and time when the log file was created; the file is located in CA's \data\log subfolder of the Windows All Users profile; see Where are log files saved?. The supported logging levels are:

1 Errors only

2 Errors and warnings

3 As 2, plus informational and status messages

Note: Setting LogLevel=3 will cause the log file to grow extremely rapidly. This level of logging is provided for testing and diagnostic purposes, for example, it shows storage and retrieval on every resource item.

LogMaxNumFiles

Type: REG_DWORD

Data: Defaults to 10. This value specifies the maximum number of log files. When the maximum number of log files exists and the maximum size of the latest is reached (see below), the oldest log file is deleted to enable a new one to be created.

LogMaxSizeBytes

Type: REG_SZ

Data: Defaults to 1,000,000. This value specifies the maximum size for each log file. When the current log file reaches its maximum size, the iConsole creates a new log file. Log entries are written to a iConsole_<date>.log file, where <date> is the date and time when the log file was created.

AlwaysLogSearchCriteria

Type: REG_SZ

Data: Defaults to False. If set to True, this value configures the iConsole to automatically add information messages containing search criteria and parameters to the iConsole log file regardless of the LogLevel entry. Search criteria are logged before the search is run and include the name and version of the associated stored procedure file, plus the parameters used. The search outcome indicates the success or failure of the search, plus:

• If the search succeeds, it also shows the number of results returned and how long the search took.
• If the search fails, it gives a reason for the failure.

If set to False, the iConsole uses the value of LogLevel.

More information:

iConsole Registry Values