.Net魔法堂:log4net详解

一、作用                            

 提供一个记录日志的框架,可以将日志信息记录到文件、控制台、Windows事件日志和数据库(MSSQL、Acess、Oracle、DB2和SQLite等)。

二、先看看示例,感受一下吧                    

config配置文件

<?xml version="1.0" encoding="utf-8"?>
<configuration>
<configSections>
  <section name="log4net" type="System.Configuration.IgnoreSectionHandler"/>
</configSections>
<log4net>
  <!-- 定义日志的输出媒介 -->
  <root>
    <appender-ref ref="ConsoleAppender"/>
    <appender-ref ref="R"/>
  </root>
  <!-- 定义输出到控制台 -->
  <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
    <layout type="log4net.Layout.PatternLayout">
    <conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline"/>
    </layout> 
  </appender>
  <!-- 定义输出到日志文件 -->
  <appender name="R" type="log4net.Appender.FileAppender" rollingStyle="Date" datePattern="yyyyMMdd-HH:mm:ss">
    <file value="logs/log.txt"></file>
    <appendToFile value="true"></appendToFile>
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%-d{yyyy-MM-dd HH\:mm\:ss}  [%L] [%c]-[%p] %m%n"></conversionPattern> 
    </layout>
  </appender>
</log4net>
</configuration>

cs文件

/**
 * 指定log4net使用.config文件来读取配置信息
 * 若为Winform(假定程序为Demo.exe), 那么配置文件则为Demo.exe.config
 * 若为Webform,则为web.config
 */
[assembly:log4net.Config.XmlConfigurator(Watch=true)]
namespace Demo{
  public class MainClass{
    public static void Main(String[] args){
    ILog log = log4net.LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
        log.Error("error", new Exception("there is an exception"));
        log.Fatal("fatal", new Exception("there is a deadly exception occurs"));
    log.Info("info");
    log.Debug("debug");
    log.Warn("warn");
    Console.Read();
    }
  }
}

三、框架的核心组件                         

 1. Appender

作用:用于定义日志信息的输出介质(文件、控制台、Windows事件日志和数据库(MSSQL、Acess、Oracle、DB2和SQLite等)) 内置的Appdner组件:

ConsoleAppender ,输出介质为控制台

FileAppender     ,输出介质为文件,示例如下

<appender name="FileAppender" type="log4net.Appender.FileAppender"
 file="logs/log.txt" appendToFile="true">
  <layout type="log4net.Layout.PatternLayout">
    ..........
  </layout>
</appender>

RollingFileAppender ,将日志以回滚文件的形式写入文件中。可以指定文件最大容量,当超过就生成一个新文件来记录,且可以指定最多生成日志文件数量,当超过时则覆盖从第一个日志文件开始循环覆盖。

示例1:

<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender" 
 file="logs/log.txt" appendToFile="true" rollingStyle="Size" maxSizeRollBackups="10" maximumFileSize="100KB" staticLogFileName="true">
  <layout type="log4net.Layout.PatternLayout">
    ..........
  </layout>
</appender>

示例2:

<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender" 
file="logs/log.txt" appendToFile="true" rollingStyle="Date" datePattern="yyyyMMdd">
  <layout type="log4net.Layout.PatternLayout">
    ..........
  </layout>
</appender>

EventLogAppender ,输出介质为系统日志

AdoNetAppender    ,输出介质为数据库,示例如下

<appender name="AdoNetAppender_Oracle" type="log4net.Appender.AdoNetAppender"> 
      <connectionType value="System.Data.OracleClient.OracleConnection, System.Data.OracleClient" /> 
      <connectionString value="data source=[mydatabase];User ID=[user];Password=[password]" /> 
      <commandText value="INSERT INTO Log (Datetime,Thread,Log_Level,Logger,Message) VALUES (:log_date, :thread, :log_level, :logger, :message)" /> 
      <bufferSize value="128" /> 
      <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> 
    </appender> 

            自定义Appender时,需要继承 log4net.Appender.AppenderSkeleton

2. Layout

作用:定义向用户显示最终的经格式化的输出信息。      注意:一个Appender对象仅能对应一个Layout对象 内容的Layout组件:

PatternLayout ,用户自定义格式,内置参数如下

%m(message),输出的日志消息 %n(newline),换行 %d(datetime),输出当前语句运行的时刻 %r(runtime),输出程序从运行到当前语句时消耗的毫秒数 %t(thread id),输出当前语句运行的线程ID %p(level),输出日志级别(日志事件) %c(class),输出当前语句所在的对象名称 %M(method),输出当前语句所在的方法名称 %f(file),输出当前语句所在的文件名称 %L(line),输出当前语句位于所在的文件中的行号 %l(location),输出当前语句位于的全限定类名,以及源文件和行号 %数字,表示该项的最小长度,如果不够则在左边用空格填充。如:%5p,表示输出日志级别,且长度最小为5个字符 %-数字,表示该项的最小长度,如果不够则在右边用空格填充。如:%-5p,表示输出日志级别,且长度最小为5个字符 %.数字,表示该项的最大长度,如果超出则截断 %数字.数字,表示该项的必须位于最小和最大长度之间,如果超出则截断, 不够则用空格填充

最佳实践: %-d{yyyy-MM-dd HH\:mm\:ss} [%L] [%c]-[%p] %m%n

SimpleLayout

ExceptionLayout ,输出时包含Message和Trace信息。Logger方法必须传入Exception对象,否则什么都不输出。 XmlLayout,中文会有问题。

              自定义Layout时,需要继承 log4net.Layout.LayoutSkeleton

3. Appender Filter

作用:默认情况下Appender对象会将所有日志信息都输出到相应的介质中,通过Appender Filter对象(命令空间:log4net.Filter)可以按照不同的标准过滤日志事件或内容。 内置的Filter组件:

DenyAllFilter ,阻止所有的日志事件被记录

LevelMatchFilter ,只有指定等级的日志事件才被记录

LevelRangeFilter ,日志等级在指定范围内的事件才被记录

LoggerMatchFilter , Logger名称匹配才被记录

PropertyFilter ,消息匹配指定的属性值才被记录

StringMatchFilter ,消息匹配指定的字符串才被记录

4. Logger

作用:直接与应用交互的组件,用于触发日志事件

级别(日志事件)

优先级

OFF

6

FATAL

5

ERROR

4

WARN

3

INFO

2

DEBUG

1

ALL

0

  5. Object Render

作用:输出根据Layout格式化的日志消息。Render必须实现log4net.ObjectRender.IObjectRender接口 

  6. Repository

作用:负责日志对象组织结构的维护。对于非框架扩展者,几乎不会用到该组件。

四、配置方式                           

1. 代码中配置     通过 log4net.Config.BasicConfigurator.Configure 配置根日志且只能配置根日志而已。     示例 :

// 和PatternLayout一起使用FileAppender

log4net.Config.BasicConfigurator.Configure(

  new log4net.Appender.FileAppender(

     new log4net.Layout.PatternLayout("%d

       [%t]%-5p %c [%x] - %m%n"),"testfile.log"));

// using a FileAppender with an XMLLayout

log4net.Config.BasicConfigurator.Configure(

  new log4net.Appender.FileAppender(

    new log4net.Layout.XMLLayout(),"testfile.xml"));

// using a ConsoleAppender with a PatternLayout

log4net.Config.BasicConfigurator.Configure(

  new log4net.Appender.ConsoleAppender(

    new log4net.Layout.PatternLayout("%d [%t] %-5p %c - %m%n")));

// using a ConsoleAppender with a SimpleLayout

log4net.Config.BasicConfigurator.Configure(

  new log4net.Appender.ConsoleAppender(new

    log4net.Layout.SimpleLayout()));

  2. 配置文件(推荐使用)

    log4net框架会在 AppDomain.CurrentDomain.BaseDirectory 指向的目录路径下查找配置文件。

在config文件中配置             在<configuration>节点下添加<configSections>节点

<configSections>
  <section name="log4net" type="System.Configuration.IgnoreSectionHandler"/>
</configSections>

            只有添加上述节点,log4net.dll才能读取config文件下<log4net>节点下配置信息

     根日志<root>节点             框架中所有日志对象都是根日志的后代,因此日志对象若没有显式配置时则会使用根日志的配置信息。

<root>
  <!-- level节点用于定义处理哪个级别的日志事件,缺省值为DEBUG -->
  <level>INFO</level>
  <!-- appender-ref节点用于定义日志对象所使用的Appender对象 -->
  <appender-ref ref="appender节点的name属性值"/>
</root>

    日志对象<logger>节点

显式配置日志对象。

<!-- additivity特性设置为false时,日志对象将不继承根日志的appender-ref节点信息。缺省值为true -->
<logger name="test.Logging" additivity="false">
  <!-- 覆盖根日志的level设置 -->
  <level value="WARN"/>
</logger>

           .cs文件中的相应的调用方式

log4net.LogManager.GetLogger("test.Logging");

Appender对象<appender>节点

<appender name="appender1" type="log4net.Appender.FileAppender">
  <layout type="log4net.Laytout.PatternLayout">
    <conversionPattern value=".........."/>
  </layout>
  <filter type="log4net.Filter.LevelRangeFilter" levelMin="DEBUG" levelMax="WARN">
  </filter>
</appender>

五、关联配置文件                           

   每个可独立执行的程序集均可以关联自己的配置文件。(组件库就使用调用者的配置文件好了)    在 AssemblyInfo.cs文件 中添加

[assembly:log4net.Config.DOMConfigurator([ConfigFile="配置文件名"|ConfigFileExtension="编译后配置文件的扩展名"][Watch=true/false])

参数说明:

ConfigFile :指定配置文件含扩展名的路径,如果为相对路径则以AppDomain.CurrentDomain.BaseDirectory为当前路径; ConfigFileExtension :若程序编译后配置文件使用了不同的扩展名,则通过该属性指定,默认值为config,配置文件的最终名称为"应用程序名.exe.config"; 注意:ConfigFile和ConfigFileExtension属性是互斥的,仅能设置其中一个 Watch :设置是否需要运行时监视文件的修改、重命名和删除等事件,若设置为true,则使用FileSystemWatcher来监视配置文件。

六、输出日志的优化方式                          

/**
 * 由于触发日志事件时,会检查日志对象的级别是否满足日志事件的级别
 * 先检测日志对象的级别,才触发日志事件 
 */
if (log.IsDebugEnabled) log.Debug("message.....");

七、总结                                

    现在我们就不再糊里糊涂地调用log4net了,建议具体使用时再查阅API文档!

八、参考                                

http://www.cnblogs.com/jams742003/archive/2009/12/10/1620861.html http://zhoufoxcn.blog.51cto.com/792419/429988

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏比原链

Derek解读Bytom源码-启动与停止

Gitee地址:https://gitee.com/BytomBlockchain/bytom

13630
来自专栏Linyb极客之路

log4j配置学习总结

Log4j有三个主要的组件:Loggers(记录器),Appenders (输出源)和Layouts(布局)。这里可简单理解为日志类别,日志要输出的地方和日志以...

13630
来自专栏分布式系统进阶

Kafka源码分析-启动流程

使用getPropsFromArgs方法来获取各配置项, 然后将启动和停止动作全部代理给KafkaServerStartable类;

24000
来自专栏SDNLAB

OpenDaylight Lithium版本简单应用及流表操作指南

OpenDaylight(以下简写为ODL)的Lithium(锂)版本的最新版Lithium-SR2已经与2015年10月8日发布,具体详情可参考ODL官网。L...

53080
来自专栏冷冷

【系统日志】log4j配置学习总结

Log4j有三个主要的组件:Loggers(记录器),Appenders (输出源)和Layouts(布局)。这里可简单理解为日志类别,日志要输出的地方和日志以...

19760
来自专栏沃趣科技

看各路神仙如何大战MySQL insecure warning报警有感

一、问题由来 mysql在5.6.5上开始在命令行中直接填入用户密码会提示错误,例如: $./mysql -h10.10.30.18 -uwoqutech -p...

47880
来自专栏计算机编程

关于RxJS 自定义封装Rxbus的使用规范文档

2.3、声明isInner为true的情况: 主要是在push页面之前,即进入子页面:

21220
来自专栏Golang语言社区

package http

要管理代理、TLS配置、keep-alive、压缩和其他设置,创建一个Transport:

23940
来自专栏君赏技术博客

我的个人代码规范文档

我说一下上面几个单词用到的地方,在除去NSString Block之外所有的对象应该声明为Strong

10120
来自专栏Greenplum

Linux 常用命令(三)

curl 命令支持在线下载功能,使用方便,它支持,S,等协议,还支持PUT,POST,COOKIES,认证授权等操作。

30000

扫码关注云+社区

领取腾讯云代金券