快速入门系列--Log4net日志组件

Log4net是阿帕奇基金会的非常流行的开源日志组件，是log4j的.NET移植版本，至今已经有11年的历史，使用方便并且非常稳定，此外很重要的一点是其和很多开源组件能很好的组合在一起工作，例如NHibernate等。对于以本地日志为主的中小型的项目，Log4net已经足够使用，当然涉及跨平台的大型分布式系统可以选择Elmah等其他日志组件。

在这里，主要介绍log4net的一些关键知识点，详细内容可见以下链接：

• 官方配置文档：http://logging.apache.org/log4net/release/config-examples.html
• 老博主摩诘在10年前就做了很仔细的解释：http://www.cnblogs.com/dragon/archive/2005/03/24/124254.html
• 博主每日一bo非常仔细的文档：http://www.cnblogs.com/caokai520/p/4387491.html

首先是log4net的四个对象:

• Logger记录器：用于产生日志，包括Fatal、ERROR、WARN、INFO、DEBUG，可以通过设置logger的记录级别进行设置，例如level=INFO,那么除了DEBUG级别的信息，其他FATAL、ERROR、WARN、INFO等级别都将被记录。
• Reposity库：维护日志对象的组织结构，主要用于对框架的扩展，一般使用不用关注。
• Appender附着器：用于设置Log的输出模式，如文件、数据库、邮件等。
• Layout布局：设置日志信息的格式。

其中Appender的选择很多，但最常见的最有实际意义的分别是：

log4net.Appender.RollingFileAppender：通过配置，可以达到日志文件每天以日期新建一个，方便查看，还可以设置日志文件大小，防止侵占硬盘。

log4net.Appender.SmtpAppender：用于FATAL、ERROR等高危级别的日志，直接发邮件给项目责任人，非常的方便有效。

log4net.Appender.AdoNetAppender：和SQL SERVER很紧密的结合，便于将重要日志信息记入数据库，便于查找和备份。

最后，想说的是log4net组件可以通过配置LockingModel设置并发时日志文件锁的模式，使其应用场景得到很大的扩充。

附上一个简单日志配置例子作为参考，具体设置时有什么问题欢迎一起探讨哈，:) ：

 <?xml version="1.0" encoding="utf-8"?>
 <configuration>
 <configSections>
 <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
 </configSections>
 <log4net>
 <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
 <layout type="log4net.Layout.PatternLayout">
 <conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline"/>
 </layout>
 </appender>
 <appender name="AdoNetAppender" type="log4net.Appender.AdoNetAppender">
 <bufferSize value="100"/>
 <connectionType value="System.Data.SqlClient.SqlConnection, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
 <connectionString value="data source=(localdb)\v11.0;initial catalog=NormalTest;integrated security=false;persist security info=True;User ID=[user];Password=[pwd]"/>
 <commandText value="INSERT INTO Log ([Date],[Thread],[Level],[Logger],[Message],[Exception]) VALUES (@log_date, @thread, @log_level, @logger, @message, @exception)"/>
 <parameter>
 <parameterName value="@log_date"/>
 <dbType value="DateTime"/>
 <layout type="log4net.Layout.RawTimeStampLayout"/>
 </parameter>
 <parameter>
 <parameterName value="@thread"/>
 <dbType value="String"/>
 <size value="255"/>
 <layout type="log4net.Layout.PatternLayout">
 <conversionPattern value="%thread"/>
 </layout>
 </parameter>
 <parameter>
 <parameterName value="@log_level"/>
 <dbType value="String"/>
 <size value="50"/>
 <layout type="log4net.Layout.PatternLayout">
 <conversionPattern value="%level"/>
 </layout>
 </parameter>
 <parameter>
 <parameterName value="@logger"/>
 <dbType value="String"/>
 <size value="255"/>
 <layout type="log4net.Layout.PatternLayout">
 <conversionPattern value="%logger"/>
 </layout>
 </parameter>
 <parameter>
 <parameterName value="@message"/>
 <dbType value="String"/>
 <size value="4000"/>
 <layout type="log4net.Layout.PatternLayout">
 <conversionPattern value="%message"/>
 </layout>
 </parameter>
 <parameter>
 <parameterName value="@exception"/>
 <dbType value="String"/>
 <size value="2000"/>
 <layout type="log4net.Layout.ExceptionLayout"/>
 </parameter>
 </appender>
 <appender name="Log4Net_INFO" type="log4net.Appender.RollingFileAppender">
 <file value="C:/log4net/LuceneDemo/info/"/>
 <appendToFile value="true"/>
 <RollingStyle value="Date"/>
 <DatePattern value="yyyyMMdd&quot;.log&quot;"/>
 <StaticLogFileName value="false"/>
 <lockingModel type="log4net.Appender.FileAppender+MinimalLock"/>
 <layout type="log4net.Layout.PatternLayout">
 <Header value="[Header]"/>
 <Footer value="[Footer]"/>
 <ConversionPattern value="记录时间：%date 线程ID:[%thread] 日志级别：%-5level 信息类：%logger property:[%property{NDC}] - 信息描述：%message%newline"/>
 </layout>
 </appender>
 <root>
 <level value="INFO"/>
 <appender-ref ref="Log4Net_INFO"/>
 <appender-ref ref="AdoNetAppender"/>
 </root>
 </log4net>
 </configuration>