返回首页 Log4j 教程

Log4j 教程

附录

Logging 级别

org.apache.Log4j.Level 类定义了日志级别,您可通过继承 Level 类定制自己的级别。

级别 描述
ALL 所有级别,包括定制级别。
DEBUG 指明细致的事件信息,对调试应用最有用。
ERROR 指明错误事件,但应用可能还能继续运行。
FATAL 指明非常严重的错误事件,可能会导致应用终止执行。
INFO 指明描述信息,从粗粒度上描述了应用运行过程。
OFF 最高级别,用于关闭日志。
TRACE 比 DEBUG 级别的粒度更细。
WARN 指明潜在的有害状况。

级别是如何工作的?

在一个级别为 q 的 logger 对象中,一个级别为 p 的日志请求在 p >= q 的情况下是开启的。该规则是 Log4j 的核心,它假设级别是有序的。对于标准级别,其顺序为:ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF。

下面的例子展示了如何过滤 DEBUG 和 INFO 级别的日志。改程序使用 logger 对象的 setLevel(Level.X) 方法设置期望的日志级别:

该例子会打印出除过 DEBUG 和 INFO 级别外的所有信息:

import org.apache.Log4j.*;

public class LogClass {
   private static org.apache.Log4j.Logger log = Logger.getLogger(LogClass.class);

   public static void main(String[] args) {
      log.setLevel(Level.WARN);

      log.trace("Trace Message!");
      log.debug("Debug Message!");
      log.info("Info Message!");
      log.warn("Warn Message!");
      log.error("Error Message!");
      log.fatal("Fatal Message!");
   }
}

编译并运行 LogClass,会产生如下输出:

Warn Message!
Error Message!
Fatal Message!

使用配置文件设置日志级别

Log4j 提供了基于配置文件设置日志级别的功能,当您需要改变调试级别时,不用再去修改代码了。

下面这个例子和上面那个例子功能一样,不过不用使用 setLevel(Level.WARN) 方法,只需修改配置文件:

# Define the root logger with appender file
log = /usr/home/Log4j
Log4j.rootLogger = WARN, FILE

# Define the file appender
Log4j.appender.FILE=org.apache.Log4j.FileAppender
Log4j.appender.FILE.File=${log}/log.out

# Define the layout for file appender
Log4j.appender.FILE.layout=org.apache.Log4j.PatternLayout
Log4j.appender.FILE.layout.conversionPattern=%m%n

现在使用如下程序:

import org.apache.Log4j.*;

public class LogClass {

   private static org.apache.Log4j.Logger log = Logger.getLogger(LogClass.class);

   public static void main(String[] args) {

      log.trace("Trace Message!");
      log.debug("Debug Message!");
      log.info("Info Message!");
      log.warn("Warn Message!");
      log.error("Error Message!");
      log.fatal("Fatal Message!");
   }
}

编译并运行如下程序,会在 /usr/home/Log4j/log.out 文件内生成如下内容:

Warn Message!
Error Message!
Fatal Message!
上一篇: Logging 方法 下一篇: 日志格式