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

2018-01-24 14:56:46 浏览数 (1)

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设置并发时日志文件锁的模式,使其应用场景得到很大的扩充。

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

代码语言:javascript复制
 1 <?xml version="1.0" encoding="utf-8"?>
 2 <configuration>
 3 <configSections>
 4 <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
 5 </configSections>
 6 <log4net>
 7 <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
 8 <layout type="log4net.Layout.PatternLayout">
 9 <conversionPattern value="�te [%thread] %-5level %logger [%ndc] - %message%newline"/>
10 </layout>
11 </appender>
12 <appender name="AdoNetAppender" type="log4net.Appender.AdoNetAppender">
13 <bufferSize value="100"/>
14 <connectionType value="System.Data.SqlClient.SqlConnection, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
15 <connectionString value="data source=(localdb)v11.0;initial catalog=NormalTest;integrated security=false;persist security info=True;User ID=[user];Password=[pwd]"/>
16 <commandText value="INSERT INTO Log ([Date],[Thread],[Level],[Logger],[Message],[Exception]) VALUES (@log_date, @thread, @log_level, @logger, @message, @exception)"/> 
17 <parameter>
18 <parameterName value="@log_date"/>
19 <dbType value="DateTime"/>
20 <layout type="log4net.Layout.RawTimeStampLayout"/>
21 </parameter>
22 <parameter>
23 <parameterName value="@thread"/>
24 <dbType value="String"/>
25 <size value="255"/>
26 <layout type="log4net.Layout.PatternLayout">
27 <conversionPattern value="%thread"/>
28 </layout>
29 </parameter>
30 <parameter>
31 <parameterName value="@log_level"/>
32 <dbType value="String"/>
33 <size value="50"/>
34 <layout type="log4net.Layout.PatternLayout">
35 <conversionPattern value="%level"/>
36 </layout>
37 </parameter>
38 <parameter>
39 <parameterName value="@logger"/>
40 <dbType value="String"/>
41 <size value="255"/>
42 <layout type="log4net.Layout.PatternLayout">
43 <conversionPattern value="%logger"/>
44 </layout>
45 </parameter>
46 <parameter>
47 <parameterName value="@message"/>
48 <dbType value="String"/>
49 <size value="4000"/>
50 <layout type="log4net.Layout.PatternLayout">
51 <conversionPattern value="%message"/>
52 </layout>
53 </parameter>
54 <parameter>
55 <parameterName value="@exception"/>
56 <dbType value="String"/>
57 <size value="2000"/>
58 <layout type="log4net.Layout.ExceptionLayout"/>
59 </parameter>
60 </appender>
61 <appender name="Log4Net_INFO" type="log4net.Appender.RollingFileAppender">
62 <file value="C:/log4net/LuceneDemo/info/"/>
63 <appendToFile value="true"/>
64 <RollingStyle value="Date"/>
65 <DatePattern value="yyyyMMdd&quot;.log&quot;"/>
66 <StaticLogFileName value="false"/>
67 <lockingModel type="log4net.Appender.FileAppender MinimalLock"/>
68 <layout type="log4net.Layout.PatternLayout">
69 <Header value="[Header]"/>
70 <Footer value="[Footer]"/>
71 <ConversionPattern value="记录时间:�te 线程ID:[%thread] 日志级别:%-5level 信息类:%logger property:[%property{NDC}] - 信息描述:%message%newline"/>
72 </layout>
73 </appender>
74 <root>
75 <level value="INFO"/>
76 <appender-ref ref="Log4Net_INFO"/>
77 <appender-ref ref="AdoNetAppender"/>
78 </root>
79 </log4net>
80 </configuration>

0 人点赞