Apache log4net 入门

obeckham

版本： 2.0.1.2.10
下载： http://archive.apache.org/dist/incubator/log4net/1.2.10/incubating-log4net-1.2.10.zip
测试环境： VS.NET2008 / ASP.NET2.0 / XP(SP3) / IIS6.0
步骤1： 添加 log4net 引用
  创建测试 ASP.NET2.0 项目，在项目中引用 log4net-1.2.10\bin\net\2.0\release\log4net.dll，见下图：

步骤2： 修改 web.config
  在 web.config 文件中添加下面配置：

<?xml version="1.0"?>
<configuration>
<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net"/>
</configSections>
...
</configuration>


步骤3： 创建 log4net 配置文件
  创建 log4net.config 文件，如下：

<?xml version="1.0" encoding="utf-8"?>
<log4net>
<!-- OFF, FATAL, ERROR, WARN, INFO, DEBUG, ALL -->
<!-- Set root logger level to ERROR and its appenders -->
<root>
<level value="ALL"/>
<appender-ref ref="SysAppender"/>
</root>
<!-- Print only messages of level DEBUG or above in the packages -->
<logger name="WebLogger">
<level value="DEBUG"/>
</logger>
<appender name="SysAppender" type="log4net.Appender.RollingFileAppender,log4net" >
<param name="File" value="App_Data/" />
<param name="AppendToFile" value="true" />
<param name="RollingStyle" value="Date" />
<param name="DatePattern" value="&quot;Logs_&quot;yyyyMMdd&quot;.txt&quot;" />
<param name="StaticLogFileName" value="false" />
<layout type="log4net.Layout.PatternLayout,log4net">
<param name="ConversionPattern" value="%d [%t] %-5p %c - %m%n" />
<param name="Header" value="&#13;&#10;----------------------header--------------------------&#13;&#10;" />
<param name="Footer" value="&#13;&#10;----------------------footer--------------------------&#13;&#10;" />
</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>
</log4net>


  这里注意 log4net.config 文件中根节点名称要与上一步 web.config 配置中的
  <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
  名称保持一致。
步骤4： 在程序集中指定 log4net 配置文件
  打开项目中的 Properties/AssemblyInfo.cs，并添加代码：

using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
// 有关程序集的常规信息通过下列属性集
// 控制。更改这些属性值可修改
// 与程序集关联的信息。
[assembly: AssemblyTitle("TestLog4net1")]
[assembly: AssemblyDescription("")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("CHINA")]
[assembly: AssemblyProduct("TestLog4net1")]
[assembly: AssemblyCopyright("Copyright © CHINA 2010")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]
// 将 ComVisible 设置为 false 使此程序集中的类型
// 对 COM 组件不可见。如果需要从 COM 访问此程序集中的类型，
// 则将该类型上的 ComVisible 属性设置为 true。
[assembly: ComVisible(false)]
// 如果此项目向 COM 公开，则下列 GUID 用于类型库的 ID
[assembly: Guid("3d5900ae-111a-45be-96b3-d9e4606ca793")]
// 程序集的版本信息由下面四个值组成:
//
//      主版本
//      次版本
//      内部版本号
//      修订号
//
// 可以指定所有这些值，也可以使用“修订号”和“内部版本号”的默认值，
// 方法是按如下所示使用“*”:
[assembly: AssemblyVersion("1.0.0.0")]
[assembly: AssemblyFileVersion("1.0.0.0")]
// log4net 日志组件配置
[assembly: log4net.Config.DOMConfigurator(ConfigFile = "log4net.config", Watch = true)]


  上面代码最后 2 行是为 log4net 添加的。
  // log4net 日志组件配置
  [assembly: log4net.Config.DOMConfigurator(ConfigFile = "log4net.config", Watch = true)]
步骤5： 测试代码
  测试单元需要引入 log4net 命名空间：
  using log4net;

using System;
using System.Collections;
using System.Configuration;
using System.Data;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using log4net;
namespace TestLog4net1
{
public partial class _Default : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
object o = ConfigurationSettings.GetConfig("log4net");
log4net.Config.DOMConfigurator.Configure(o as System.Xml.XmlElement);
log4net.ILog logger = log4net.LogManager.GetLogger("WebLogger");
//下面按照从上倒下顺序，日志级别由低到高，debug是最低级别，fatal级别最高
logger.Debug("新加一条调试日志");      
logger.Info("新加一条普通信息日志");
logger.Warn("新加一条警告日志");
logger.Error("新加一条错误日志");
logger.Fatal("新加一条致命错误日志");
}
}
}


  执行结果，在测试程序 App_Data 目录下产生 Logs_20100227.txt 文件，内容如下：
  ----------------------header--------------------------
  2010-02-27 11:15:11,765 [4] DEBUG WebLogger - 新加一条调试日志
  2010-02-27 11:15:11,875 [4] INFO  WebLogger - 新加一条普通信息日志
  2010-02-27 11:15:11,875 [4] WARN  WebLogger - 新加一条警告日志
  2010-02-27 11:15:11,875 [4] ERROR WebLogger - 新加一条错误日志
  2010-02-27 11:15:11,875 [4] FATAL WebLogger - 新加一条致命错误日志
  简单使用 log4net 的示例就完成了。
切割日志文件的 log4net.config 示例：

<?xml version="1.0" encoding="utf-8"?>
<log4net>
<!-- OFF, FATAL, ERROR, WARN, INFO, DEBUG, ALL -->
<!-- Set root logger level to ERROR and its appenders -->
<root>
<level value="ALL"/>
<appender-ref ref="SysAppender"/>
</root>
<!-- Print only messages of level DEBUG or above in the packages -->
<logger name="WebLogger">
<level value="DEBUG"/>
</logger>
<appender name="SysAppender" type="log4net.Appender.RollingFileAppender">
<param name="File" value="App_Data\Logs.txt"/>
<param name="AppendToFile" value="true"/>
<param name="MaxSizeRollBackups" value="12"/><!-- 切割最多文件数 -->
<param name="MaximumFileSize" value="500KB"/><!-- 每个文件的大小 -->
<param name="RollingStyle" value="Size"/>
<param name="StaticLogFileName" value="true"/>
<layout type="log4net.Layout.PatternLayout">
<param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n"/>
</layout>
</appender>
</log4net>


日志行内容配置：
  %m(message)： 输出的日志消息，如ILog.Debug(…)输出的一条消息
  %n(new line)： 換行
  %d(datetime)： 输出当前语句运行的时刻
  %r(run time)： 输出程序从运行到执行到当前语句时消耗的毫秒数
  %t(thread id)： 当前语句所在的线程ID
  %p(priority)： 日志的当前优先级别，即DEBUG、INFO、WARN…等
  %c(class)： 当前日志对象的名称
  %L： 输出语句所在的行号
  %F： 输出语句所在的文件名
  %-数字： 表示该项的最小长度，如果不够，则用空格填充
  例如：
  <param name="ConversionPattern" value="%d [%t] %-5p %F(%L) -- %m%n" />
  输出：
  2010-02-27 11:47:50,437 [4] DEBUG E:\Projects\zah\TcmForum\TestCode\TestLog4net1\TestLog4net1\Default.aspx.cs(26) -- 新加一条调试日志

博客原文：http://cbuiler.iyunv.com/admin/blogs/604154
内容部分引用：
  1.http://www.xueit.com/asp.net/show-5223-2.aspx  作者：dodo