本文不是教你全面了解log4net,本文只是希望教会你按步就班,照糊芦画瓢般就会用log4net
1,引入log4net.dll组件
2,建立一个配置文件
两种方法,一种是在web.config或app.config里
加入以下配置节
<configsections>
<section name="log4net" type="log4net.config.log4netconfigurationsectionhandler,log4net" />
</configsections>
上面的配置节,复制就可以用了
加入log4net配置内容的定义,这个紧接着上面的内容定义在config文件里就可以了,下面是一个范例:
<log4net>
<root>
<level value="all" />
<appender-ref ref="rollingfile" />
</root>
<appender name="rollingfile" type="log4net.appender.rollingfileappender,log4net" >
<param name="file" value="log.txt" />
<param name="appendtofile" value="false" />
<param name="rollingstyle" value="date" />
<param name="datepattern" value="yyyy.mm.dd" />
<param name="staticlogfilename" value="true" />
<layout type="log4net.layout.patternlayout,log4net">
<param name="conversionpattern" value="%d [%t] %-5p %c - %m%n" />
<param name="header" value="
----------------------header--------------------------
" />
<param name="footer" value="
----------------------footer--------------------------
" />
</layout>
</appender>
<appender name="consoleapp" type="log4net.appender.consoleappender,log4net">
<layout type="log4net.layout.patternlayout,log4net">
<param name="conversionpattern" value="%d [%t] %-5p %c - %m%n" />
</layout>
</appender>
<logger name="log4nettest.logtest">
<level value="debug" />
<appender-ref ref="rollingfile" />
<appender-ref ref="coloredconsoleapp" />
<appender-ref ref="systemevent" />
</logger>
</log4net>
你懒得写的话,复制上面的内容也可以
不过,还是稍做讲解,log4net配置节的xsd层次如下
<log4net>
<root><level /><appender-ref ref="" /></root>
<appender name="" type="appender的完全限定类名">
<param name="" value="" />
<layout type="log4net.layout.patternlayout,log4net">
<param name="" value="" />
</layout>
</appender>
<logger>
<level value="" />
<appender-ref ref="" />
</logger>
看不懂?其实很简单啦
log4net是log4net配置节的根标记
root标记定义一个根级别的记录者,log4net的记录者采用层级组织的, 两个logger,a的名字叫loggera,b的名字叫loggera.b的话,那么b就是a的儿子,b会自动继承a的一些定义,例如level定义,appender-ref定义等,root就是总的logger,其余定义的logger都是他的后代,都会继承他的设置
包括root在内的每一个logger(root也是一个logger,只不过,他是祖先而已,别的方面,跟其他logger一样),都可以定义level
level定义记录的日志级别,就是说,你要记录哪个级别以上的日志,级别由高往低依次是:
none
fatal
error
warn
debug
info
all
级别的定义要注意,如果你定义debug,那么低于debug级别以下的信息,将不会记入日志,啥意思呢?就是说,就算你在程序里,用log.info()来写入一个日志信息,可是你在配置中指定level为debug,由于info级别低于debug,所以,不会被记入日志.这样的处理非常灵活
logger还有一个配置就是appender-ref了,ref是参照的意思,log4net的架构非常有意思,可扩展性非常高非常值得借鉴,他分为四个要素:
logger
appender
layout
filter
logger是负责日志的记录者
appender提供记录的介质
layout负责把记入的内容格式化
filter负责把内容进行筛选
可以说,整个过程就是一个日志流水线,每个成员负责其中的一个环节
logger发出记录信息,appender接到信息,根据内部的layout配置对记录信息格式化,根据filter决定此信息是否被过滤掉,最后,将其序列化
因此,logger的appender-ref就是定义说,logger要找谁去将内容写入磁盘,流或其他介质,因此,十分重要吧
既然是ref引用,那肯定要定义这个被引用的appender对象了呀
每个appender都代表了一个输出介质
name属性指定其名称,type则是log4net.appender命名空间的一个类的名称,意思是,指定使用哪种介质
log4net支持的appender类型有十几种,最常用的有rollingfileappender,adonetappender,eventlogappender,fileappender,分别把日志记入文件,系统日志和数据库
除此之外,appender内的其他参数都用param标记,以key/value形式定义于其内
这里有个小提示,每一个appender,log4net并没有在文档中提出他们需要哪些参数,那么,我们怎么知道呢?
原来,这些param的名称,你可以直接查对应的appender类的属性名即可,例如,使用eventlogappender时,通过查看类的属性,我们知道其有
logname,applicationname属性,那么,意味着,你可以直接在这个appender的param里加入以下内容:
<param name="logname" value="application" />
<param name="applicationname" value="log4nettest" />
定义了appender的name及type属性,以及使用param为其指定参数后,一个appender就建立了,你可以使用他的名字在logger的<appender-ref中去 引用它,那么,引用它的logger在写入日志时,就是写到了appender中定义的介质中去了
一个logger可以引用多个appender,其结果是,同一个日志,被同时记录到多个介质中去 ,便如,同时发邮件,写入系统日志,发送到远程主机.不过,虽然可以这样做,但是还是要小心,因为,会对性能有一定的影响,除非你需要,否则,不要乱用此功能
另外,appender中可以定义可选的layout,layout的定义非常有必要,如果你不想将来看到你的日志会感觉头晕的话,虽然log4net帮你写入日志,但是,日志信息的格式却是我们使用者自行定义的
layout的type参数指定使用哪个类的定义来格式化,常用的有xmllayout,simplelayout,patternlayout,这个当然要根据你的需要,以及你要产生的格式来选啦,如果你要输出成xml文档格式,你肯定不能用simplelayout吧
layout使用param以key/value形式定义其参数
各个layout类使用的参数当然不一样啦,具体的,你可以去看各个layout类的属性
其中,patternlayout可以使用conversionpattern参数来指定一个格式化字符串
以及可以指定一个header参数,做为日志开头的字符串,footer来指定结尾字符串
这里有一个小技巧,日志中开头和结尾总想产生回车符吧,虽然logger在写入一条日志会自动回车,可是header和footer却不会,咋办?用\n\r吗?(我从别人的blog上看到过)经实践,\n\r会原样定改日志,根本不会转换.其实,我们可以用xml实体呀,使用
就可以在指定位置插入一个回车换行符了
最后,像log4net的文档中说的那样,如果你不想你的日志文件变得很大,使读写的性能下降的话,建议你还是分级管理日志,把粒度变小点,也就是说,除了定义root外,最后,对每一个模块或每一个实体,依据用途,目的,定义各自的logger配置,这样的好处是日志被分散了,日志文件增长就没那么快了.每一个logger的结构跟root是一模一样的,这里不再叙述了.像前面说的那样,如果你相让日志产生层级关系,你可以跟他们的name属性像c#中的namespace那样命名就可以了
要说明的是,logger的定义是非必须的,只是一种建议罢了,log4net的配置中,除了必须定义一个root和一个appender外,其他的都是可选的
另一种配置log4net的方法,是在单独的xml文件中配置,这个时候,只要把log4net标记中的内容复制过来就行了,不需要configsections
3,在应用程序代码中读取配置
这一步非常简单,你可以在应用程序集的assemblyinfo.cs文件中读取log4net配置
对于winform应用程序,你可以加入
[assembly:log4net.config.domconfigurator()]或
[assembly:log4net.config.xmlconfigurator()]
对于webform你可以加入
[assembly:log4net.config.domconfigurator(configfile="web.config",watch=true)]
注意:如果使用nunit测试的朋友,要用生成后事件,copy "$(projectdir)app.config" "$(targetpath).config"
4.在应用程序中获取ilog对象
在需要使用logger功能的类中,引入log4net空间,为类加入静态只读成员(静态的目的是只用一个对象,只读是防止误改)
private static readonly ilog logger=logmanager.getlogger(typeof(类))
这里就可以获取配置文件中与类名同名的logger对象了
5,写入日志
很简单 logger.deub(写入的内容)
其他的还有info,warn,error等,很容易理解的
浙公网安备 33010602011771号