Platform Deployment Guide › iConsole Deployment › 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 log only 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. The supported logging levels are:

1 Errors only

2 Errors and warnings

3 As 2, plus informational and status messages

Note: If you set LogLevel=3, log files 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.

LogMaxSizeBytes

Type: REG_DWORD

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 an iConsole_<date>.log file, where <date> is the date and time when the log file was created.

AlwaysLogSearchCriteria

Type: REG_SZ

Data: Defaults to True on an Enterprise installation, defaults to false on Express installations. If set to True, the iConsole automatically adds 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, log entries also show how many search results were 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.