Besides the product configuration options that are available from the Settings section of the application UI, there are some additional configuration settings users may adjust to tailor RayQC towards their individual requirements.
Logging RayQC Activity
The program data directory (C:\Users\<username>\AppData\Roaming\RayQC\Logs) is used by default to store the application activity log files. A separate log file is created for each started RayQC Instance. If the default settings remain unchanged, RayQC adds a new line to this log file for every system INFO level message that is generated during application use.
In order to change the default settings for the log file behavior, users have to manually edit the log4net.config file, which resides in the root of the installation folder of RayQC (usually something like C:\Program Files (x86)\RayQCAdvanced\). The settings which are most likely to be of interest for adjustments are:
Log File Storage Location
The log files are by default stored in C:\Users\<username>\AppData\Roaming\RayQC\Logs. However, it is possible to define any other absolute local paths as well as shared network locations for logging resource storage.
<file type="log4net.Util.PatternString" value="%env{AppData}\\Raynet\\RayQC\\Logs\\%date{yyyy-MM-dd HH-mm-ss}.log" /> |
|
Be aware: The user that runs RayQC must have write permissions in the log file location in order to initiate and maintain the message flow to the log file. If the user does not have sufficient access rights, there will be no error message, or actual product usage cutback, but simply a loss of system activity documentation. Please refer to the Troubleshooting section for additional instructions in case of missing logs. |
Max. Log File Size
The max. log file size may be defined as KB, MB,or GB. The default setting for newly installed RayQC instances is "2048KB"
<maximumFileSize value="2048KB" /> |
Log Level
The most frequently used log level settings are DEBUG, INFO, WARN, ERROR, FATAL, OFF, whilst OFF prevents logging at all, FATAL is the most restrictive but still writing setting, and DEBUG the most talkative option.
The recommendation is to use the DEBUG level for newly setup systems, since a lot of the information logged in this mode may help to adjust settings regarding access rights, and the like. As soon as the application and system are up and running productively, setting the log level to WARNING should be sufficient for permanent maintenance.
<level value="DEBUG" /> |
Default Logging Configuration
The default configuration file is given below as a review and backup support:
<?xml version="1.0" encoding="utf-8" ?> <configuration>
<configSections> <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/> </configSections>
<log4net>
<appender name="RayQC" type="log4net.Appender.RollingFileAppender"> <file type="log4net.Util.PatternString" value="%env{AppData}\\RayQC\\Logs\\%date{yyyy-MM-dd HH-mm-ss}.log" />
<rollingStyle value="Once" /> <maxSizeRollBackups value="2" /> <maximumFileSize value="10240KB" /> <staticLogFileName value="false" /> <immediateFlush value="true" /> <layout type="log4net.Layout.PatternLayout,log4net"> <param name="header" value="/***************************** LOG HEADER *****************************/
"/> <param name="footer" value="/***************************** LOG FOOTER *****************************/
"/> <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" /> </layout> <threshold value="INFO" /> </appender>
<root> <level value="ALL" /> <appender-ref ref="RayQC" /> </root>
</log4net> </configuration> |
Further Information
RayQC uses an external library to provide logging functionality. Please refer to the online-documentation provided for the log4net project (http://logging.apache.org/log4net/) in order to get further details regarding available configuration and usage options. log4net can be adjusted to connect directly with databases or event-loggers. There are numerous options for layout and behavior manipulations. RayQC system administrators with a slight affection for perfection are highly welcome to configure their very own logger version.