Quick start guide for setting up logging for Dovetail Agent and Dovetail Admin. (Article # 136)
View products that this article applies to.
Problem:
All Dovetail applications that use our SDK have a logging capability that can be enabled. The following steps will get you up and running quickly with SDK logging in Dovetail Agent and Dovetail Admin.
Note: There are detailed instructions on customizing logging in the Dovetail SDK documentation.
Resolution:
Assuming you have a place to store your log files. This example assumes: C:\TEMP\logs\DovetailAgent.log.
1. Create an new config file and put it in the root directory of your Dovetail Agent application (ex. C:\dovetailagent\agent_logging.config).
2. Copy the following to the newly created config file (several other examples are included with the Dovetail SDK documentation) and save it.
<log4net>
<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender" >
<param name="File" value="C:\\TEMP\\logs\\DovetailAgent.log" />
<param name="AppendToFile" value="true" />
<param name="RollingStyle" value="Size" />
<param name="MaxSizeRollBackups" value="100" />
<param name="MaximumFileSize" value="1024KB" />
<param name="StaticLogFileName" value="true" />
<layout type="log4net.Layout.PatternLayout">
<param name="ConversionPattern" value="%d [user: %X{user}] [fcsessionid: %X{session}] [%-5p] [%c]%n\t%m%n%n" />
</layout>
</appender>
<root>
<level value="all" />
<appender-ref ref="RollingFileAppender" />
</root>
</log4net>
3. Add the following line at the top of your fc.env file:
compat_logconfigfile=<config file location>
(ex. c:\DovetailAgent\agent_logging.config).
4. Done. You should start seeing log information in C:\TEMP\logs\DovetailAgent.log.
Applies To: