Log4Net使用

1.下载文件

下载地址:http://logging.apache.org/log4net/,有源码和dll文件可供下载,有能力的大神可以研究研究源码。

解压之后log4net-1.2.13\bin文件夹下面会有四个文件夹,cli,mono,net,net-cp,前连个不知道是在什么情况下用的,后两个主要是针对不同的.net编译程序,每个程序或者是类库都有一个目标框架属性,可右键项目,点击属性查看,.NET Framework 4 对应net,.NET Framework 4 Client Profile 对应 net-cp。

.NET Framework 4 Client Profile 是 .NET Framework 4 已针对客户端应用程序进行优化的一个子集。 它提供了适用于大多数客户端应用程序的功能,包括 Windows Presentation Foundation (WPF)、Windows 窗体、Windows Communication Foundation (WCF) 和 ClickOnce 功能。 这使得以 .NET Framework 4 Client Profile 为目标的应用程序的部署速度加快且安装包变小。

2.配置

log4net 有四种主要的组件,分别是Logger(记录器), Repository(库), Appender(附着器)以及 Layout(布局).

日志级别

级别

允许的方法

Boolean属性

优先级别

OFF

 

 

Highest

FATAL

void Fatal(...);

bool IsFatalEnabled;

 

RROR

void Error(...);

bool IsErrorEnabled;

 

WARN

void Warn(...);

bool IsWarnEnabled;

 

INFO

void Info(...);

bool IsInfoEnabled;

 

DEBUG

void Debug(...);

bool IsDebugEnabled;

 

ALL

 

 

Lowest

 

我们可根据不同情况,输出不同级别的日志。

将下载的对应版本的log4net.dll文件引入到工程中,然后再工程的AssemblyInfo.cs文件中添加

1 [assembly: log4net.Config.XmlConfigurator(ConfigFile = "log4net.config")]

上面的是单独文件的配置,如果我们将log4net的配置放入到app.config或者是web.config,则在AssemblyInfo.cs文件中添加配置时,不需要设置ConfigFile = "log4net.config", 如下:

1 [assembly: log4net.Config.XmlConfigurator()]

这个为log4net的初始化设置,当然我们也可以在代码中进行初始化,但是我比较喜欢在AssemblyInfo.cs文件中进行初始化。

如下面的代码,与上面的效果是一样的:

1 log4net.Config.XmlConfigurator.Configure(new FileInfo("log4net.Config"));

配置文件log4net.config:

A.XML

 1 <?xml version="1.0" encoding="utf-8" ?>
 2 <configuration>
 3   <log4net>
 4     <logger name="loginfo">
 5       <level value="INFO" />
 6       <appender-ref ref="LogCommon" />
 7     </logger>
 8     <appender name="LogCommon" type="log4net.Appender.RollingFileAppender">
 9       <param name="File" value="logs\"/>
10       <param name="AppendToFile" value="true"/>
11       <param name="maxSizeRollBackups" value="10"/>
12       <param name="maximumFileSize" value="1MB"/>
13       <param name="staticLogFileName" value="false"/>
14       <param name="DatePattern" value="yyyy-MM/yyyy-MM-dd&quot;.log&quot;" />
15       <param name="RollingStyle" value="Composite" />
16       <layout type="log4net.Layout.XmlLayout">
17         <param name="Header" value="&lt;?xml version=&quot;1.0&quot; ?&gt;&lt;logs&gt;" />
18         <param name="Footer" value="&lt;/logs&gt;" />
19       </layout>
20       <filter type="log4net.Filter.LevelRangeFilter">
21         <param name="LevelMin" value="INFO" />
22         <param name="LevelMax" value="RROR" />
23       </filter>
24     </appender>
25   </log4net>
26 </configuration>

以上是将日志存储到xml中的配置文件,根据官网的提示,添加了Header和Footer。因为默认的为xmlNode,当使用XMLDocument访问的时候,会提示不是有效的xml文件。

当然如果这种生成xml的方式还是不能满足工作需要的话,可以访问http://blogs.lessthandot.com/index.php/DesktopDev/MSTech/making-an-xmllayout-for-log4net

有大能自定义了XMLLayout,但是代码是VB的,可参照或者扩展。

  参数说明:

   type="log4net.Appender.RollingFileAppender",log4net提供了各种可实现不同功能的Appender,具体可参考官方提供的帮助文档http://logging.apache.org/log4net/release/sdk/log4net.Appender.html,或者:@Anders Cui 翻译的 log4net的各种Appender配置示例

或者原文:http://logging.apache.org/log4net/release/config-examples.html

B.文本

如果想输出到文本,则将配置文件中的Layout的Type属性修改成:log4net.Layout.PatternLayout

1 <layout type="log4net.Layout.PatternLayout">
2         <param name="Header" value="[Header]\r\n"/>
3         <param name="Footer" value="[Footer]\r\n"/>
4         <param name="ConversionPattern" value="%d [%t] %-5p %c [%x]  - %m%n" />
5 </layout>

  参数说明

    Layout用法可参考:http://www.cnblogs.com/manhoo/archive/2009/06/25/1511066.html

    %m(message):输出的日志消息,如ILog.Debug(…)输出的一条消息

    %n(new line):换行

    %d(datetime):输出当前语句运行的时刻

    %r(run time):输出程序从运行到执行到当前语句时消耗的毫秒数

    %t(thread id):当前语句所在的线程ID

    %p(priority): 日志的当前优先级别,即DEBUG、INFO、WARN…等

    %c(class):当前日志对象的名称,例如:

         模式字符串为:%-10c -%m%n

    %L:输出语句所在的行号

    %F:输出语句所在的文件名

    %-数字:表示该项的最小长度,如果不够,则用空格填充

C.数据库(SQLServer 2008)

 1 <?xml version="1.0"?>
 2 <configuration>
 3   <log4net>
 4     <appender name="ADONetAppender" type="log4net.Appender.ADONetAppender">
 5       <bufferSize value="1" />
 6       <useTransactions value="false" />
 7       <connectionType value="System.Data.SqlClient.SqlConnection, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
 8       <connectionString value="Data Source=192.168.1.99\SQLSERVER;Initial Catalog=RailWeightDB;User ID=sa; PWD=*******;" />
 9       <commandText value="INSERT INTO [RailWeightDB].[dbo].[SysLog]([ThreadName],[LevelName],[Message],[Exception],[CreateTime],[CreaterID]) VALUES (@thread,@level,@message,@exception,@time,@user)" />
10       <parameter>
11         <parameterName value="@thread" />
12         <dbType value="String" />
13         <size value="100" />
14         <layout type="log4net.Layout.PatternLayout">
15           <conversionPattern value="%t" />
16         </layout>
17       </parameter>
18       <parameter>
19         <parameterName value="@level" />
20         <dbType value="String" />
21         <size value="50" />
22         <layout type="log4net.Layout.PatternLayout">
23           <conversionPattern value="%p" />
24         </layout>
25       </parameter>
26       <parameter>
27         <parameterName value="@message" />
28         <dbType value="String" />
29         <size value="5000" />
30         <layout type="log4net.Layout.PatternLayout">
31           <conversionPattern value="%m" />
32         </layout>
33       </parameter>
34       <parameter>
35         <parameterName value="@exception" />
36         <dbType value="String" />
37         <size value="5000" />
38         <layout type="log4net.Layout.ExceptionLayout" />
39       </parameter>
40       <parameter>
41         <parameterName value="@time" />
42         <dbType value="DateTime" />
43         <layout type="log4net.Layout.RawTimeStampLayout" />
44       </parameter>
45       <parameter>
46         <parameterName value="@user" />
47         <dbType value="String" />
48         <size value="50" />
49         <layout type="log4net.Layout.PatternLayout">
50           <conversionPattern value="%X{user}" />
51         </layout>
52       </parameter>
53     </appender>
54     <!-- specify the level for some specific categories -->
55     <logger name="SysLog">
56       <level value="DEBUG"/>
57       <appender-ref ref="ADONetAppender"/>
58     </logger>
59   </log4net>
60 </configuration>

在配置数据库过程中遇到过好多麻烦,当然,过程是痛苦的,结果是美好的。

  参数说明

    bufferSize:一般设置为1,如果设置为10,则,我们写10次log才会被写入一次,这种可能会造成延迟更新,也就是说我10:10操作的日志,到10:15,buffer满了,此时才会写入到数据库中,如果协同交互较多,并且需要频繁写日志,则可根据实际情况,将其设置为较大的值。

    useTransactions :是否使用存储过程,bool类型。

    connectionType:其中Version,我看到过2.0,也看到过1.3,好像官网的就是1.3,然后我查了这个,据非官方说明,这个是.netframework的版本。

    %X{user}:%X代表的是MDC,如果不明白这个才是是怎么来的,可参考下面的注意事项以及Layout参数说明

    有大能总结了在使用数据库的4个注意事项,可参考一下:http://weblogs.asp.net/drnetjes/archive/2005/02/16/374780.aspx

 

 

posted @ 2013-11-28 09:19  zhuhc  阅读(1796)  评论(1编辑  收藏  举报