Log4Net日志记录简单使用讲解

　一. Log4Net 简介

　　Log4net 是 Apache 下一个开放源码的项目，我们可以控制日志信息的输出目的地（数据库、控制台、文本文档、文件）。Log4net中定义了多种日志信息输出模式。 

　　在做项目的时候令我最头疼的是在程序发布到正式环境之后出现了问题，我们不能调试而且问题很难重新，于是我们需要大量的日志数据来精确的跟踪程序的运行状况。 

　　Log4net就可以帮我来解决这一个难题，对于日志的输出我们不需要人为的去干涉，它可以根据需要将日志输出到控制台，文本文件，windows 日志事件查看器中，包括数据库，邮件等等位置，以便我们快速跟踪程序bug。 

二. Log4Net 简单使用

　　使用Log4net必须引入log4net.dll 文件，因为log4net 是开源的，所以可以直接将源码添加到工程项目中去。然后生成新的dll文件。

1.首先引用Log4Net.dll

2.如果是在Web程序中，我们可以将这句话添加到 Global.asax 文件的Application_Start(object sender, EventArgs e) 方法中，在程序启动的时候就初始化配置信息:

log4net.Config.XmlConfigurator.Configure(); --这句话相当于初始化注册Log4net ,

注：如果不是Web程序则每次调用时候写这句话。

3.配置web.config

 

下面使用配置一个最简单的文件输出和控制台输出。 

　　Log4Net 的配置文件，此段内容添加到App.config 或者　web.config 文件中：

<configSections>
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net"/>
  </configSections>
  <log4net>
    <appender name="FileAppender" type="log4net.Appender.FileAppender">
      <file value="D:\a.log"></file>
      <appendToFile value="true"></appendToFile>
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[%d]:%n%m%n"></conversionPattern>
      </layout>
    </appender>
    <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[%d]:%n%m%n"></conversionPattern>
      </layout>
    </appender>
    <root>
      <level value="INFO"></level>
      <appender-ref ref="FileAppender"></appender-ref>
      <appender-ref ref="ConsoleAppender"></appender-ref>
    </root>
    <logger name="MyLogger">
      <level value="ERROR"></level>
      <appender-ref ref="FileAppender"></appender-ref>
      <appender-ref ref="ConsoleAppender"></appender-ref>
    </logger>
  </ log4net>

　　控制台程序测试例子:

ILog log = LogManager.GetLogger("MyLogger");
        static void Main(string[] args)
        {
            log4net.Config.XmlConfigurator.Configure();
            Program program = new Program();
            program.log.Info(">>>>>>>>>>>>>>");
            program.log.Info(">>>>>>>>>>>>>>1");
            program.log.Info(">>>>>>>>>>>>>>2"); 
} 

 注：上述例子是不会输出任何日志信息的，因为配置级别的限制。 下面我们来看下日志的结构

　三. Log4Net 结构

　　Log4net 主要分为5个核心组件: Logger, Appender, Filter, Layout, Object Render。 

　　Logger: 

　　主要用于记录日志的分类和控制日志的级别。它可以以多种格式输出日志信息，同时它也可以控制日志的输出级别。上面的简单例子我们看似做了日志输出，但是没有输出任何日志结果，因为我们在日志级别上做了限制。 

　　Appender： 

　　这里我们简单称之为“附着器”。意思就是说日志的输出必须依赖于它，更确切的说以文本形式输出，还是控制台格式输出都必须要依靠它来控制。Log4net定义了多种附着器：

　　(1) AdoNetAppender 将日志记录到数据库中。可以采用SQL和存储过程两种方式 。

　　(2) AnsiColorTerminalAppender 在ANSI 窗口终端写下高亮度的日志事件。 

　　(3) AspNetTraceAppender 能用asp.net中Trace的方式查看记录的日志。

　　(4) BufferingForwardingAppender 在输出到子Appenders之前先缓存日志事件。

　　(5) ConsoleAppender 将日志输出到控制台。

　　(6) EventLogAppender 将日志写到Windows Event Log。

　　(7) FileAppender 将日志写到文件中。 

　　(8) MemoryAppender 将日志存到内存缓冲区。 

　　(9) NetSendAppender 将日志输出到Windows Messenger service，这些日志信息将在用户终端的对话框中显示。

　　(10) RemoteSyslogAppender 通过UDP网络协议将日志写到Remote syslog service。

　　(11) RemotingAppender 通过.NET Remoting将日志写到远程接收端。

　　(12) RollingFileAppender 将日志以回滚文件的形式写到文件中。 

　　(13) SmtpAppender 将日志写到邮件中。

　　(14) TraceAppender 将日志写到.NET trace 系统。

　　(15) UdpAppender 将日志connectionless UDP datagrams的形式送到远程宿主或以UdpClient的形式广播。

　　Filter:

　　Appender 是将日志以缺省值的方式输出，意思就是按照默认值的方式输出。而Filter 意思就是过滤器，使用Filter 可以将日志以不同格式来输出。

　　Layout:

　　这个用于控制日志输出显示格式。

　　Object Render:

　　用于按照用户自定义标准来输出日志。

　　Log4net 结构图 （从其他地方截图过来）

 

　Log4net 的日志对象管理器LogManager：LogManager是用于来管理所有的Logger对象的，GetLogger() 可以用来查找已经存在的Logger对象，如果对象不存在它会自动创建一个Logger对象，并且管理它。

　　四. Log4Net 日志级别

　　Log4net 分为如下几个级别：

　　FATAL  毁灭级别

　　ERROR 错误级别

　　WARN 警告级别

　　INFO 消息级别

　　DEBUG 调试级别

　　这几种日志级别高低：FATAL> ERROR> WARN > INFO > DEBUG。

　　只有日志输出级别大于或等于配置的级别才能输出日志信息。

　　比如我的日志配置级别为INFO，那么只有log.Info(), log.Warn(), log.Error(), log.Fatal()才能输出日志信息，Debug方式就不能输出。

　　Log4net中还有两种特殊的配置级别: ALL - 允许所有的日志级别输出，OFF - 拒绝所有的日志级别输出。

　　五. Log4Net 配置说明

<configSections>
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net"/>
</configSections>
<log4net>
    <!--记录日志到数据库-->
    <appender name="AdoNetAppender" type="log4net.Appender.AdoNetAppender">
      <bufferSize value="100" />
      <connectionType value="System.Data.SqlClient.SqlConnection, System.Data, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
      <connectionString value="data source=GAS-HECHEN;initial catalog=dsc141051_db;integrated security=false;persist security info=True;User ID=sa;Password=000000" />
      <commandText value="INSERT INTO Log ([Date],[Thread],[Level],[Logger],[Message],[Exception]) VALUES (@log_date, @thread, @log_level, @logger, @message, @exception)" />
      <parameter>
        <parameterName value="@log_date" />
        <dbType value="DateTime" />
        <layout type="log4net.Layout.RawTimeStampLayout" />
      </parameter>
      <parameter>
        <parameterName value="@thread" />
        <dbType value="String" />
        <size value="255" />
        <layout type="log4net.Layout.PatternLayout">
          <conversionPattern value="%thread" />
        </layout>
      </parameter>
      <parameter>
        <parameterName value="@log_level" />
        <dbType value="String" />
        <size value="50" />
        <layout type="log4net.Layout.PatternLayout">
          <conversionPattern value="%level" />
        </layout>
      </parameter>
      <parameter>
        <parameterName value="@logger" />
        <dbType value="String" />
        <size value="255" />
        <layout type="log4net.Layout.PatternLayout">
          <conversionPattern value="%logger" />
        </layout>
      </parameter>
      <parameter>
        <parameterName value="@message" />
        <dbType value="String" />
        <size value="4000" />
        <layout type="log4net.Layout.PatternLayout">
          <conversionPattern value="%message" />
        </layout>
      </parameter>
      <parameter>
        <parameterName value="@exception" />
        <dbType value="String" />
        <size value="2000" />
        <layout type="log4net.Layout.ExceptionLayout" />
      </parameter>
    </appender>
    
    <!--输入日志到控制台-->
    <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[时间]:%d%n[级别]:%p%n[内容]:%m%n%n"></conversionPattern>
      </layout>
    </appender>

    <appender name="FileAppender" type="log4net.Appender.FileAppender">
      <param name="file" value="D:\a.log"></param>
      <param name="appendToFile" value="true"></param>
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[时间]:%d%n[级别]:%p%n[内容]:%m%n%n"></conversionPattern>
      </layout>
    </appender>
    
    <root>
      <level value="INFO"></level>
      <appender-ref ref="FileAppender"></appender-ref>
      <appender-ref ref="ConsoleAppender"></appender-ref>
    </root>
    <logger name="MyLogger">
      <level value="INFO"></level>
      <appender-ref ref="FileAppender"></appender-ref>
      <appender-ref ref="ConsoleAppender"></appender-ref>
    </logger>
</log4net>

　　这个配置文件定义了三种不同的Appender，分别是ADO.NET 记录到数据，ConsoleAppender 从控制台输出， FileAppender 日志信息文件输出。

　　然而Log4Net 的配置附着器远不止这些，这里上传一个比较全的附着器配置文件供大家参考 点击下载。

　　根据上面的日志配置文件仍然使用如下代码测试:

 

　　这里需要注意，log4net.Config.XmlConfigurator.Configure();   这个相当于初始化Log4net, 如果是在Web程序中，我们可以将这句话添加到 Global.asax 文件的Application_Start(object sender, EventArgs e) 方法中，在程序启动的时候就初始化配置信息。

　　上面的程序运行结果图，控制台输出结果为：

 

　　信息记录到指定的磁盘文件中，记录的结果如下图:

 

　　这里说明两个配置:

 

　　这里的 root 和 logger 配置节点，root 就相当于默认的日志对象配置，而logger是指定特定的日志配置。他们可以共存。

　　对于这两个节点下面都有 level 和 appender-ref 节点，分别用于指定日志的输出级别和引用哪些附着器。每个日志对象都可以使用多个appender，这里的配置同时使用文件输出和控制台输出。得到的结果就是上面两个结果图。

 

　　下面的logger对象添加了AdoNetAppender附着器，当使用MyLogger日志对象的时候就会使用这三种不同的方式记录日志。

 

 

 

　上面的程序声明了两个日志对象 log 和 log1，log 是在初始化的时候存在的，它得到的是<logger name="MyLogger"> 这个日志对象，而log1 是 LogManager 中不存在的日志对象，这里它会重新创建一个并且由LogManager 管理，后面再次使用则使用这个已经存在的对象。 这里两个日志对象同时使用结果如下：

 

 

　　现在我修改配置文件的日志文件输出级别：

<logger name="MyLogger">
      <level value="WARN"></level>
      <appender-ref ref="FileAppender"></appender-ref>
      <appender-ref ref="ConsoleAppender"></appender-ref>
      <appender-ref ref="AdoNetAppender"></appender-ref>
</ logger>

　　运行得到的结果如图：

 

显然MyLogger对象日志没有输出日志信息。

　　六. Log4Net 参数说明 

　　上面我们看到的配置文件中有类似 %m %n 等这样的符号，这些符号都是有特殊意义的。

   %m[%message]       : 输出的日志消息
   %n                 : 换行
   %d[%datetime]      : 输出当前语句运行的时刻
   %r                 : 输出程序从运行到执行到当前语句时消耗的毫秒数
   %d                 ： 当前语句所在的线程ID
   %p                 : 日志的当前优先级别
   %c                 ：当前日志对象的名称
   %L                 : 输出语句所在的行号
   %F                 ：输出语句所在的文件名
   %-数字              ：表示该项的最小长度，如果不够，则用空格填充