简单、重要的log4j

达芬奇密码2018-07-30 14:00
 近期在项目当中,发现配置好的log4j.properties不能如期打印出来日志信息。其中这个应用服务器tomcat的部分log4j.properties配置如下所示:
  1. log4j.rootLogger=info
  2. log4j.additivity.debug =true
  3. log4j.logger.debug=debug,debug,console
  4. log4j.additivity.event=true
  5. log4j.logger.event=info,event,console
  6. log4j.additivity.error =true
  7. log4j.logger.error=error,error,console
  1. # debug日志
  2. log4j.appender.debug = org.apache.log4j.DailyRollingFileAppender
  3. log4j.appender.debug.File = ${catalina.home}/logs/zc_debug.log
  4. log4j.appender.debug.DatePattern = '_'yyyyMMdd
  5. log4j.appender.debug.layout = org.apache.log4j.PatternLayout
  6. log4j.appender.debug.BufferedIO=false
  7. #Buffer单位为字节,默认是8K
  8. #log4j.appender.debug.BufferSize=512
  9. log4j.appender.debug.layout.ConversionPattern = c=%c`m=%M`tm=%-d{yyyy-MM-dd HH:mm:ss}`%m%n
是因为上下两部分中红色部分名字应该相同,才可以打印出来debug、error、event的日志。也就是说上面设定好的appenderName,下面也必须用相同的 appenderName才可以打印出来相关日志, 因此把开头部分更改为如下重启机器后就可以产生日志了:
log4j.rootLogger=info
log4j.additivity.zc_debug = true
log4j.logger.zc_debug=debug,zc_debug,console
log4j.additivity.zc_event = true
log4j.logger.zc_event=info,zc_event,console
log4j.additivity.zc_error = true
log4j.logger.zc_error=error,zc_error,console

借此机会, 就学习了一下强大的 log4j
       Log4j是 Apache 的一个开源项目,通过使用Log4j,我们可以控制日志信息输送的目的地是 控制台 、文件、 GUI 组件,甚至是套接口服务器、 NT 的事件记录器、 UNIX   Syslog守护进程 等;我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是,这些可以通过一个 配置文件 来灵活地进行配置,而不需要修改应用的代码。

  Log4j 由三个重要的组件构成:日志信息的优先级,日志信息的输出目的地,日志信息的输出格式 。日志信息的优先级从高到低有 ERROR  WARN  INFO  DEBUG ,分别用来指定这条日志信息的重要程度;日志信息的输出目的地指定了日志将打印到控制台还是文件中;而输出格式则控制了日志信息的显示内容。 

1 、定义配置文件 
    其实您也可以完全不使用配置文件,而是在代码中配置 Log4j 环境。但是,使用配置文件将使您的应用程序更加灵活。 Log4j 支持两种配置文件格式,一种是 XML 格式的文件,一种是 Java 特性文件(键 =  properties 文件)。下面我们介绍使用 Java 特性文件做为配置文件的方法: 

1  . 配置根 Logger ,其语法为: 
 log4j.rootLogger = [ level ] , appenderName, appenderName, …
  其中, level 是日志记录的优先级,分为 OFF  FATAL  ERROR  WARN  INFO  DEBUG  ALL 或者您定义的级别。 Log4j 建议只使用四个级别 ,优先级从高到低分别是 ERROR  WARN  INFO  DEBUG 。通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关。比如在这里定 义了 INFO 级别,则应用程序中所有 DEBUG 级别的日志信息将不被打印出来  appenderName 就是指 B 日志信息输出到哪个地方。您可以同时指定多个输出目的地。

2 )配置日志信息输出目的地 Appender ,其语法为: 
 log4j.appender.appenderName = fully.qualified.name.of.appender.class. 其中, Log4j 提供的 appender 有以下几种: 
        1.org.apache.log4j.ConsoleAppender (控制台), 
        2.org.apache.log4j.FileAppender (文件), 
        3.org.apache.log4j.DailyRollingFileAppender (每天产生一个日志文件), 
        4.org.apache.log4j.RollingFileAppender (文件大小到达指定尺寸的时候产生一个    新的文件) 
        5.org.apache.log4j.WriterAppender (将日志信息以流格式发送到任意指定的地方)

3) . 配置日志信息的格式(布局),其语法为: 
 log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
  其中, Log4j 提供的 layout 有以 e 几种: 
        1.org.apache.log4j.HTMLLayout (以 HTML 表格形式布局), 
        2.org.apache.log4j.PatternLayout (可以灵活地指定布局模式), 
        3.org.apache.log4j.SimpleLayout (包含日志信息的级别和信息字符串), 
        4.org.apache.log4j.TTCCLayout (包含日志产生的时间、线程、类别等等信息) 
 Log4J 采用类似 C 语言中的 printf 函数的打印格式格式化日志信息,打印参数如下: %m 输出代码中指定的消息
 %p 输出优先级,即 DEBUG  INFO  WARN  ERROR  FATAL
 %r 输出自应用启动到输出该 log 信息耗费的毫秒数 
 %c 输出所属的类目,通常就是所在类的全名 
 %t 输出产生该日志事件的线程名 
 %n 输出一个回车换行符, Windows 平台为 “rn”  Unix 平台为 “n”
 %d 输出日志时间点的日期或时间,默认格式为 ISO8601 ,也可以在其后指定格式,比如: %d{yyy MMM dd HH:mm:ss,SSS} ,输出类似: 2002  10  18  22  10  28  921
 %l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java:10)

2. 在代码中使用 Log4j 
 1. 得到记录器 
 使用 Log4j ,第一步就是获取日志记录器,这个记录器将负责控制日志信息。其语法为: 
 public static Logger getLogger( String name) 
 通过指定的名字获得记录器,如果必要的话,则为这个名字创建一个新的记录器。 Name 一般取本类的名字,比如: 
 static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () ) 
 2. 读取配置文件 
 当获得了日志记录器之后,第二步将配置 Log4j 环境,其语法为: 
 BasicConfigurator.configure ()  自动快速地使用缺省 Log4j 环境。 
 PropertyConfigurator.configure ( String configFilename) :读取使用 Java 的特性文件编写的配置文件。 
 DOMConfigurator.configure ( String filename ) :读取 XML 形式的配置文件。 
  3. 插入记录信息(格式化日志信息) 
  当上两个必要步骤执行完毕,您就可以轻松地使用不同优先级别的日志记录语句插入到您想记录日志的任何地方,其语法如下: 
 Logger.debug ( Object message ) ;
 Logger.info ( Object message ) ;
 Logger.warn ( Object message ) ;
 Logger.error ( Object message ) ;  


本文来自网易实践者社区,经作者齐红方授权发布。