Log4Net介绍

原创 2007年10月11日 17:14:00

1 简介

1.1 Log4net的优点:

几乎所有的大型应用都会有自己的用于跟踪调试的API。因为一旦程序被部署以后,就不太可能再利用专门的调试工具了。然而一个管理员可能需要有一套强大的日志系统来诊断和修复配置上的问题。

经验表明,日志记录往往是软件开发周期中的重要组成部分。它具有以下几个优点:它可以提供应用程序运行时的精确环境,可供开发人员尽快找到应用程序 中的Bug;一旦在程序中加入了Log 输出代码,程序运行过程中就能生成并输出日志信息而无需人工干预。另外,日志信息可以输出到不同的地方(控制台,文件等)以备以后研究之用。

Log4net就是为这样一个目的设计的,用于.NET开发环境的日志记录包。

1.2 Log4net的安装:

用户可以从http://logging.apache.org/log4net/下载log4net的源代码。解压软件包后,在解压的src目录下将log4net.sln载入Visual Studio .NET,编译后可以得到log4net.dll。用户要在自己的程序里加入日志功能,只需将log4net.dll引入工程即可。  

2  Log4net的结构

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

2.1 Logger

2.1.1 Logger接口

Logger是应用程序需要交互的主要组件,它用来产生日志消息。产生的日志消息并不直接显示,还要预先经过Layout的格式化处理后才会输出。

Logger提供了多种方式来记录一个日志消息,你可以在你的应用程序里创建多个Logger,每个实例化的Logger对象都被log4net框 架作为命名实体(named entity)来维护。这意味着为了重用Logger对象,你不必将它在不同的类或对象间传递,只需要用它的名字为参数调用就可以了。log4net框架 使用继承体系,继承体系类似于.NET中的名字空间。也就是说,如果有两个logger,分别被定义为a.b.c和a.b,那么我们说a.b是a.b.c 的祖先。每一个logger都继承了祖先的属性

Log4net框架定义了一个ILog接口,所有的logger类都必须实现这个接口。如果你想实现一个自定义的logger,你必须首先实现这个接口。你可以参考在/extension目录下的几个例子。

ILog接口的定义如下:

public interface ILog

{

  void Debug(object message);

  void Info(object message);

  void Warn(object message);

  void Error(object message);

  void Fatal(object message);

 

//以上的每一个方法都有一个重载的方法,用来支持异常处理。

//每一个重载方法都如下所示,有一个异常类型的附加参数。

  void Debug(object message, Exception ex);

  // ...

 

//Boolean 属性用来检查Logger的日志级别

//(我们马上会在后面看到日志级别)

  bool isDebugEnabled;
  bool isInfoEnabled;

  //… 其他方法对应的Boolean属性

}

Log4net框架定义了一个叫做LogManager的类,用来管理所有的logger对象。它有一个GetLogger()静态方法,用我们提 供的名字参数来检索已经存在的Logger对象。如果框架里不存在该Logger对象,它也会为我们创建一个Logger对象。代码如下所示:

log4net.ILog log = log4net.LogManager.GetLogger("logger-name");

通常来说,我们会以类(class)的类型(type)为参数来调用GetLogger(),以便跟踪我们正在进行日志记录的类。传递的类(class)的类型(type)可以用typeof(Classname)方法来获得,或者可以用如下的反射方法来获得:

System.Reflection.MethodBase.GetCurrentMethod().DeclaringType

尽管符号长了一些,但是后者可以用于一些场合,比如获取调用方法的类(class)的类型(type)。

2.1.2     日志的级别

正如你在ILog的接口中看到的一样,有五种不同的方法可以跟踪一个应用程序。事实上,这五种方法是运作在Logger对象设置的不同日志优先级别 上。这几种不同的级别是作为常量定义在log4net.spi.Level类中。你可以在程序中使用任何一种方法。但是在最后的发布中你也许不想让所有的 代码来浪费你的CPU周期,因此,框架提供了7种级别和相应的Boolean属性来控制日志记录的类型。

 Level有以下几种取值

级别

允许的方法

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

1  Logger的日志级别  

  在log4net框架里,通过设置配置文件,每个日志对象都被分配了一个日志优先级别。如果没有给一个日志对象显式地分配一个级别,那么该对象会试图从他的祖先继承一个级别值。

ILog接口的每个方法都有一个预先定义好了的级别值。正如你在表1看到的,ILog的Inof()方法具有INFO级别。同样的,以此类推, Error()方法具有ERROR级别。当我们使用以上的任何一种方法时,log4net框架会检查日志对象logger的级别和方法的级别。只有当方法 的级别高于日志级别时,日志请求才会被接受并执行。

举例说明,当你创建了一个日志对象,并且把他的级别设置为INFO。于是框架会设置日志的每个Boolean属性。当你调用相应的日志方法时,框架会检查相应的Boolean属性,以决定该方法能不能执行。如下的代码:
 

Logger.Info("message");
Logger.Debug("message");
Logger.Warn("message");

对于第一种方法,Info()的级别等与日志的级别(INFO),因此日志请求会被传递,我们可以得到输出结果”message”。

对于第二种方法,Debug()的级别低于日志对象logger的日志级别(INFO),因此,日志请求被拒绝了,我们得不到任何输出。同样的,针对第三行语句,我们可以很容易得出结论。

在表1中有两个特殊的级别:ALL和OFF。ALL表示允许所有的日志请求。OFF是拒绝所有的请求。

你也可以显式地检查Logger对象的Boolean属性,如下所示:

if (logger.IsDebugEnabled)
{
  Logger.Debug("message");
}

 

2.2  Repository

Repository主要用于负责日志对象组织结构的维护。在log4net的以前版本中,框架仅支持分等级的组织结构(hierarchical organization)。这种等级结构本质上是库的一个实现,并且定义在log4net.Repository.Hierarchy 名字空间中。要实现一个Repository,需要实现log4net.Repository.ILoggerRepository 接口。但是通常并不是直接实现该接口,而是以log4net.Repository.LoggerRepositorySkeleton为基类继承。体系 库 (hierarchical repository )则由log4net.Repository.Hierarchy.Hierarchy类实现。

如果你是个log4net框架的使用者,而非扩展者,那么你几乎不会在你的代码里用到Repository的类。相反的,你需要用到LogManager类来自动管理库和日志对象。

2.3Appender

一个好的日志框架应该能够产生多目的地的输出。比如说输出到控制台或保存到一个日志文件。log4net 能够很好的满足这些要求。它使用一个叫做Appender的组件来定义输出介质。正如名字所示,这些组件把它们附加到Logger日志组件上并将输出传递 到输出流中。你可以把多个Appender组件附加到一个日志对象上。 Log4net框架提供了几个Appender组件。关于log4net提供的Appender组件的完整列表可以在log4net框架的帮助手册中找 到。有了这些现成的Appender组件,一般来说你没有必要再自己编写了。但是如果你愿意,可以从 log4net.Appender.AppenderSkeleton类继承。

2.4 Appender Filters

一个Appender 对象缺省地将所有的日志事件传递到输出流。Appender的过滤器(Appender Filters) 可以按照不同的标准过滤日志事件。在log4net.Filter的名字空间下已经有几个预定义的过滤器。使用这些过滤器,你可以按照日志级别范围过滤日 志事件,或者按照某个特殊的字符串进行过滤。你可以在API的帮助文件中发现更多关于过滤器的信息。

2.5 Layout

Layout 组件用于向用户显示最后经过格式化的输出信息。输出信息可以以多种格式显示,主要依赖于我们采用的Layout组件类型。可以是线性的或一个XML文件。 Layout组件和一个Appender组件一起工作。API帮助手册中有关于不同Layout组件的列表。一个Appender对象,只能对应一个 Layout对象。要实现你自己的Layout类,你需要从log4net.Layout.LayoutSkeleton类继承,它实现了ILayout 接口。

  3 在程序中使用log4net

 3.1. 在自己的项目中添加对 log4net.dll 的引用。
 3.2. 设置配置文件App.config

示例:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    
<!--如果不用App.config作配置文件,则configSections节不是必须的。-->
    
<configSections>
        
<!--“type”属性的完整格式为:配置节处理器类名,程序集名称,Version=程序集版本号,Culture=区域信息,PublicKeyToken=公钥-->
        
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
    
</configSections>
    
<log4net>
        
<!--日志记录器logger,可以有多个-->
        
<logger name="AppLogger">
            
<level value="INFO" />
            
<appender-ref ref="LogFileAppender" />
            
<appender-ref ref="ConsoleAppender" />
        
</logger>
        
<logger name="Form1">
            
<level value="DEBUG" />
            
<appender-ref ref="LogFileAppender" />
        
</logger>
        
<!--所有logger的基,root的设置在所有logger中都起作用。
        当在root和logger中重复设定相同的appender时,你会发现同一日志信息将被记录两次。
-->
        
<!--<root>
            <level value="WARN" />
            <appender-ref ref="LogFileAppender" />
            <appender-ref ref="ConsoleAppender" />
        </root>
-->
        
<!--一个appender可以由多个logger共用,当然一个logger可以指定多个appender。-->
        
<appender name="LogFileAppender" type="log4net.Appender.FileAppender">
            
<param name="File" value="App.log" />
            
<param name="AppendToFile" value="true" />
            
<layout type="log4net.Layout.PatternLayout">
                
<param name="Header" value="[Header]/r/n" />
                
<param name="Footer" value="[Footer]/r/n" />
                
<param name="ConversionPattern" value="%d [%t] %-5p %c [%x] %X{auth} - %m%n" />
            
</layout>
            
<filter type="log4net.Filter.LevelRangeFilter">
                
<param name="LevelMin" value="DEBUG" />
                
<param name="LevelMax" value="FATAL" />
            
</filter>
        
</appender>
        
<appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
            
<layout type="log4net.Layout.PatternLayout">
                
<param name="ConversionPattern" value="%d [%t] %-5p %c [%x] %X{auth} - %m%n" />
            
</layout>
        
</appender>
    
</log4net>
</configuration>

3.3 代码里实现 

          
  private void btnLog_Click(object sender, System.EventArgs e)
  {
   log4net.ILog log = log4net.LogManager.GetLogger("AppLogger");
   log.Debug("debug");
   log.Info("info");
   log.Warn("warn");
   log.Error("error");
   MessageBox.Show("生成日志成功!");
  }



posted on 2005-12-03 01:29 李天平 阅读(2667) 评论(5)  编辑  收藏 所属分类: ASP.NET开发C#开发项目管理

评论

#1楼  2006-03-31 15:41 yiyang [未注册用户]
我那你的代码运行了一下,但是我不知道在那里看日志
  回复  引用  查看    

#2楼  2006-07-05 21:47 zhoubin [未注册用户]
读了你这篇文件,感觉很好,我也对这个组件了解了很多,但是我在测试你的代码时,却看不到日志文件的输出,找了很最后在:AssemblyInfo.cs  中加入一句:[assembly: log4net.Config.XmlConfigurator(Watch=true)]
就看到我写到文件中的日志了,但我不知道这个是什么意思,谢谢帮我解答一下!
  回复  引用  查看    

#3楼  2007-03-27 14:52 Ame
studying...
  回复  引用  查看    

#4楼 [TrackBack] 2007-03-29 18:48 erich.zhou
在.net开发中使用Log4Net组件 1简介 1.1Log4net的优点: 几乎所有的大型应用都会有自己的用于跟踪调试的API。因为一旦程序被部署以后,就不太可能再利用专门的调试...
[引用提示]erich.zhou引用了该文章, 地址: http://www.cnblogs.com/erichzhou/archive/2007/03/29/693191.html
  回复  引用  查看    

#5楼 [TrackBack] 2007-07-10 10:23 落拓孤鸿
[引用提示]落拓孤鸿引用了该文章, 地址: http://www.cnblogs.com/cheatlove/archive/2007/07/10/812249.html
  回复  引用  查看   

log4net的配置详解

前言:没买到1号回家的票,所以在祖国64岁生日之际,宅在宿舍一天,玩游戏之余把昨天想整理的log4net整理下,于是有了下文。         log4net是一款优秀的第三方日志框架,可以很容易的...
  • yhyhyhy
  • yhyhyhy
  • 2016年10月06日 13:39
  • 389

c# log组件 log4net使用介绍

在软件开发和测试过程中,打印log信息是必不可少的调试方法。尤其在定位偶发性出现的问题的时候,用log的方式,就能体现出优势了。 log4net是一个开源的log代码,只需要应用他的dll,并且在co...
  • caimagic
  • caimagic
  • 2016年04月05日 10:19
  • 1304

log4net的配置详解

前言:没买到1号回家的票,所以在祖国64岁生日之际,宅在宿舍一天,玩游戏之余把昨天想整理的log4net整理下,于是有了下文。         log4net是一款优秀的第三方日志框架,可以很容易的...
  • pfe_Nova
  • pfe_Nova
  • 2013年10月01日 22:45
  • 56170

[C#]Log4net创建日志及简单扩展

1、概述 log4net是.Net下一个非常优秀的开源日志记录组件。log4net记录日志的功能非常强大。它可以将日志分不同的等级,以不同的格式,输出到不同的媒介。本文主要是介绍如何在Visua...
  • sinat_32349327
  • sinat_32349327
  • 2017年02月22日 14:09
  • 1510

利用Log4net记录系统日志信息(支持6种数据库)

Log4net的优点: 几乎所有的大型应用都会有自己的用于跟踪调试的API。因为一旦程序被部署以后,就不太可能再利用专门的调试工具了。然而一个管理员可能需要有一套强大的日志系统来诊断和修复配置上的问...
  • dmz1981
  • dmz1981
  • 2013年02月05日 11:57
  • 4313

Log4Net的坎坷配置之旅。

第一步:引入dll 第二步:新建log4net.Config 
  • UnOpenMyCode
  • UnOpenMyCode
  • 2014年08月28日 13:56
  • 1645

Hello log4net——做一个实用好用的log4net的demo

参考文章: 1. Log4Net使用详解(周公)——点击打开链接 2. Log4Net使用详解(续)周公——点击打开链接 3. 点击打开链接 4. 点击打开链接 日志是一个正式项目布署所必备的东东...
  • yenange
  • yenange
  • 2014年02月20日 16:50
  • 4993

log4net在项目中使用

1》从log4net官网下面log4net的文件包,然后在包的bin文件夹下的net文件夹中的4.0文件夹中找到log4net.dll文件,然后将它引入到我们的项目中来 2》在项目中新建一个log4n...
  • Fanbin168
  • Fanbin168
  • 2015年04月30日 12:30
  • 1872

使用Log4net记录日志

使用Log4net记录日志      首先说说为什么要进行日志记录。在一个完整的程序系统里面,日志系统是一个非常重要的功能组成部分。它可以记录下系统所产生的所有行为,并按照某种规范表达出来。我...
  • SHhuangju
  • SHhuangju
  • 2016年04月05日 11:16
  • 2133

log4net辅助类

直接用log4net还是不太方便,写下作参考: using System; using System.Collections.Generic; using System.Linq; using Sys...
  • yenange
  • yenange
  • 2014年02月21日 16:05
  • 2450
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Log4Net介绍
举报原因:
原因补充:

(最多只允许输入30个字)