基于Log4Net的日志系统

阅读目录

 

不管是Web应用程序还是WinForm应用程序,Visual Studio所带的调试功能都是足够强大,足以应付开发中的各种调试需求。但是,对于已经发布的应用,要记录错误、记载运行中的各种状态信息,就需要依靠日志系统了。

日志系统应具备的特性

一个好的日志系统,应该具备以下的特性:

1、运行稳定。因为日志的作用就是要在系统出现各种错误、各种异常的时候输出信息,因此,它必须具有足够的鲁棒性和稳定性,在任何时候都能发挥其功能。

2、适用性广。需要用到日志功能的地方,在程序中可以说无处不在:ASPX页面,WinForm窗体,类文件、ASHX页面、线程……因此,日志系统应当在任何位置都能发挥其功能。

3、分级管理。日志应当可以按照重要性分为不同的级别,如Info、Debug、Warning、Error、Fatal等。用户可以决定输出何种级别的日志。调试时,可以输出尽可能全面的信息,如Info、Debug等级别的信息都可以输出。部署后,仅仅输出Warning以上的级别。

4、输出丰富。可以根据用户的需求,按用户指定的格式输出日志。

Log4Net

上述的特征,其实就是Log4Net的特点。它来源于Java平台中著名的日志组件log4j,是一个非常成熟的日志系统。它的版本更新极慢,但即使是从在.Net 1.0下发布的版本,在后面的.Net版本中都能工作正常!

由于Log4Net是开源的,所以,可以对它进行各种各样的定制修改。官方网站地址是http://logging.apache.org/log4net/

介绍Log4Net的文章较多,因此在此不打算重复这些细节。本着最快实现的目标,争取把达到目标的必须的几个关键点点到即可。

配置文件:log4net.config

log4net的工作原理很简单,在代码中使用log4net的相应方法(从Info到Fatal)输出日志信息,而最终究竟输出到哪里?输出哪些都由log4net.config这个配置文件来控制。因此log4net.config的重要性可谓关键。下面是一个典型的配置文件,其实有它基本就够了!


<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <log4net>
    <!--错误日志,保存到一个文件Error.log中-->
    <appender name="Log" type="log4net.Appender.FileAppender">
      <file value="log/log.txt" />
      <appendToFile value="true" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[%date{yyyy-MM-dd HH:mm:ss}]%message - (%logger)%newline" />
      </layout>
      <filter type="log4net.Filter.LevelRangeFilter">
        <param name="LevelMin" value="DEBUG" />
        <param name="LevelMax" value="FATAL" />
      </filter>
    </appender> 
    
    <root>
      <level value="ALL" />
      <appender-ref ref="Log" />
    </root>
  </log4net> 
</configuration>

初始化

Log4Net作为一个全局的基础设置,因此必须要进行一个初始化。在Web程序和窗体程序中有所不同。

1、在WinForm应用程序中,需要显示调用以下语句:


log4net.Config.XmlConfigurator.ConfigureAndWatch(new System.IO.FileInfo(System.Windows.Forms.Application.StartupPath + "\\log4net.config"));

2、Web应用程序,也可以通过调用初始化语句完成:


log4net.Config.XmlConfigurator.ConfigureAndWatch(new System.IO.FileInfo(System.Web.HttpContext.Current.Server.MapPath("~")+"\\log4net.config"));

但是,由于Web应用程序不像WinForm应用程序那样有明确的入口点,所以Web程序的初始化往往在global.ascx中的Application_Start中添加设置,如下所示:


void Application_Start(object sender, EventArgs e) 
{
	// 在应用程序启动时运行的代码
	log4net.Config.XmlConfigurator.ConfigureAndWatch(new System.IO.FileInfo(Server.MapPath("~")+"\\log4net.config"));
}
所以,对Web程序,只要添加global.ascx,在Application_Start中添加代码即可。

输出信息

Log4Net输出信息的主要方法就是Debug()、Error()等方法,关键点在于获取Logger对象。有多种方法可以获取Logger对象,经过实验,使用下面的方法可以适用于普通类和静态类的输出:


 log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType).Info("ColumnClick"); 

在WinForm中进行简单的测试:


private void button1_Click(object sender, EventArgs e)
{
	log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType).Debug("普通类中的信息");
	SClass.StaticFunc();
	for (int i = 0; i < 5; i++)
	{
		(new Thread(test)).Start();
	}
}
void test()
{
	log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType).Debug("线程中:"+Thread.CurrentThread.ManagedThreadId.ToString());
}

其中SClass中的StaticFunc是一个简单静态方法,其中有日志信息输出。最后的日志如下:

而在Web应用程序中,也可以进行类似的测试,证明适应性还是不错的。

对Log4Net的封装

经过各种测试,终于找到一些通用性强的方法,为防止以后每次都得回来复制粘贴,还是把它封装一下比较好,在CommonCode中,用Logger封装了日志的相关功能,如下:


public class Logger
{
	public static void Init(string ConfigFile)  
	{
		log4net.Config.XmlConfigurator.ConfigureAndWatch(new System.IO.FileInfo(ConfigFile));
	}
	public static void WinFormInit()  //WinForm程序的初始化
	{
		log4net.Config.XmlConfigurator.ConfigureAndWatch(new System.IO.FileInfo(System.Windows.Forms.Application.StartupPath + "\\log4net.config"));
	}
	public static void WebInit()  //WinForm程序的初始化
	{
		log4net.Config.XmlConfigurator.ConfigureAndWatch(new System.IO.FileInfo(System.Web.HttpContext.Current.Server.MapPath("~")+"\\log4net.config"));
	}
	public static void Debug(String info)
	{
		log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType).Debug(info);
	}
	public static void Info(String info)
	{
		log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType).Info(info);
	}
	public static void Error(String info)
	{
		log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType).Error(info);
	}
	public static void Fatal(String info)
	{
		log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType).Fatal(info);
	}
}

Web的调用还得修改Global.ascx,但WinForm中可以通过WinInit进行初始化了。至于输出信息,则可以通过


CommonCode.Logger.Debug(string)

的形式进行输出。

在CommonCode中,Log4Net是一个通用的输出机制,各种应用的日志输出都需要用它,所以,大多数情况下,需要把Log4Net.dll和CommonCode.dll放在一起。

log4net.config复杂配置

Log4net的输出非常强大,以下是我常用的一些配置:


<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <log4net>
    <!--按日期输出到Log文件中,不记录错误信息-->
    <appender name="LogAppender" type="log4net.Appender.RollingFileAppender">
      <file value="log/Logs_" />
      <appendToFile value="true" />
      <rollingStyle value="Date" />
      <datePattern value="yyyyMMdd&quot;.txt&quot;" />
      <staticLogFileName value="false" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[%date{HH:mm:ss}]%message - (%logger)%newline" />
      </layout>
      <filter type="log4net.Filter.LevelRangeFilter">
        <param name="LevelMin" value="DEBUG" />
        <param name="LevelMax" value="WARN" />
      </filter>
    </appender>
    
    <!--错误日志,保存到一个文件Error.log中-->
    <appender name="ErrorLog" type="log4net.Appender.FileAppender">
      <file value="log/Error.log" />
      <appendToFile value="true" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[%date{yyyy-MM-dd HH:mm:ss}]%message - (%logger)%newline" />
      </layout>
      <filter type="log4net.Filter.LevelRangeFilter">
        <param name="LevelMin" value="ERROR" />
        <param name="LevelMax" value="FATAL" />
      </filter>
    </appender>
    
    <!--输出到Log2Console,可以实时跟踪查看-->
    <appender name="ToLog2Console" type="log4net.Appender.UdpAppender">
      <param name="Encoding" value="utf-8" />
      <param name="RemoteAddress" value="127.0.0.1" />
      <param name="RemotePort" value="8003" />
      <layout type="log4net.Layout.XmlLayoutSchemaLog4j" />
    </appender>

    <root>
      <level value="ALL" />
      <appender-ref ref="LogAppender" />
      <appender-ref ref="ErrorLog" />
      <appender-ref ref="ToLog2Console" />
    </root>
  </log4net> 
</configuration>

简单说明如下:

  • LogAppender:输出Debug到Warn的信息,存储在log文件下Log_时间戳.txt中,并且会随着文件的增加主动分割
  • ErrorLog:只输出错误信息
  • ToLog2Console:通过UDP向网络发送日志,可以同Log2Console等来接收

基于Log4Net的日志系统,古老的榕树,5-wow.com

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。