Apache log4net 入门

版本: 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,见下图:

Apache log4net 入门_第1张图片

步骤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.iteye.com/admin/blogs/604154
内容部分引用:
  1. http://www.xueit.com/asp.net/show-5223-2.aspx  作者:dodo

你可能感兴趣的:(apache,UI,Web,asp.net,asp)