Apache log4net 入门

[b]版本： 2.0.1.2.10[/b]

[b]下载：[/b] [url]http://archive.apache.org/dist/incubator/log4net/1.2.10/incubating-log4net-1.2.10.zip[/url]

[b]测试环境：[/b] VS.NET2008 / ASP.NET2.0 / XP(SP3) / IIS6.0

[b]步骤1： 添加 log4net 引用[/b]

创建测试 ASP.NET2.0 项目，在项目中引用 log4net-1.2.10\bin\net\2.0\release\log4net.dll，见下图：

[img]http://dl.iteye.com/upload/attachment/210063/a8ce35c5-3142-3b8f-9ffa-4dc50c4bb1d6.jpg[/img]

[b]步骤2： 修改 web.config [/b]

在 web.config 文件中添加下面配置：

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

     ...

</configuration>

[b]步骤3： 创建 log4net 配置文件[/b]

创建 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=""Logs_"yyyyMMdd".txt"" />
    <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="
----------------------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>
</log4net>

这里注意 log4net.config 文件中根节点名称要与上一步 web.config 配置中的
<section [color=red]name="log4net"[/color] type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
名称保持一致。

[b]步骤4： 在程序集中指定 log4net 配置文件[/b]

打开项目中的 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 添加的。
[color=green] // log4net 日志组件配置
[assembly: log4net.Config.DOMConfigurator(ConfigFile = "log4net.config", Watch = true)][/color]

[b]步骤5： 测试代码[/b]

测试单元需要引入 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 的示例就完成了。

[b]切割日志文件的 log4net.config 示例：[/b]

<?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>

[b]日志行内容配置：[/b]

%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) -- 新加一条调试日志


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