Rapid Manager Logging

Follow

The Rapid Manager is configured for logging using a log.config XML file (RapidManager.log.config) placed by default in the Rapid Manager folder on the server (c:\illiad\Rapid Manager). How much information is logged and the location to store the log is configured in the contents of the log.config file; it is configured by default to point to c:\iLLiad\logs\RapidManager.log.

The contents of the log.config file define everything about how and what the application logs, including how much to log, where to put it, and how often to roll it over. How much information is logged and where the information is stored are normally the two most important factors to be tracked.

Collecting the Information

How much information should be logged is specified by changing the value of the "level" element in the XML. The default value is "INFO", but you get the most detail by changing it to "DEBUG". When you are troubleshooting the Rapid Manager, it is useful to change this setting to "DEBUG". However, this can increase the number of log entries by quite a bit so the setting should be changed back to "INFO" as soon as troubleshooting is finished.

Storing the Log

As stated above, where to store the log is specified by the "file" element in the XML. The default value upon installation is the logs sub-directory of the directory where the application is installed. For the Rapid Manager, the default logging location is on the server at c:\iLLiad\logs\.

If the server has an alternate path for log files, this should be manually changed in the log.config file.

The log.config XML File

This diagram shows the XML content of the log.config file:

<?xml version="1.0" encoding="utf-8" ?>
<log4net>
    <root>
        <level value="INFO" />
        <appender-ref ref="RollingFile" />
    </root>

    <appender name="RollingFile" type="log4net.Appender.RollingFileAppender">
        <file value="C:\ILLiad\Logs\RapidManager.log" />
        <appendToFile value="true" />
        <maximumFileSize value="1MB" />
        <maxSizeRollBackups value="5" />
        <rollingStyle value="Size" />
        <staticLogFileName value="true" />

        <layout type="log4net.Layout.PatternLayout">
            <conversionPattern value="%date [%thread] %-5level %logger - 
			%message%newline%exception"/>
        </layout>
    </appender>
</log4net>

Questions?

If this article didn’t resolve your issue, please take a moment and answer a few questions to help improve our documentation:

Feedback