1.全局log4j.rootLogger的配置

log4j.rootLogger是用来配置log4j的全局配置的,一般可以写为:

log4j.rootLogger = [ level ] , appenderName, appenderName, …

其中,level表示的是日志记录优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。log4j建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG。当定义了一个级别时,低于该级别的优先级就被忽略。例如,如果定义级别为INFO,那么DEBUG级别的日志信息就会被忽略了。

appenderName 是在 Appender 配置中使用的名称信息,一个 lo4j.rootLogger 中可以定义多个 appenderName ,然后通过他们的不同的名字来在 Appender 中分别使用。

例如,下面这个语句表示定义了一个优先级别为DEBUG、有5个输出位置的log4j:

log4j.rootLogger = debug,stdout,D,I,W,E

2.Appender的配置

  1. 配置日志的输出方式

    log4j的输出方式的配置有以下几种类型,他用来控制log的输出位置:

    org.apache.log4j.ConsoleAppender(控制台)
    org.apache.log4j.FileAppender(文件)
    org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
    org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
    org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
    

    使用方式如下所示:

    log4j.appender.appenderName = xxx
    
  2. 配置日志信息的格式(布局)

    log4j的layout有以下几种的配置方式,他用来控制log的输出格式:

    org.apache.log4j.HTMLLayout(以HTML表格形式布局),  
    org.apache.log4j.PatternLayout(可以灵活地指定布局模式),  
    org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),  
    org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
    

    使用方式如下所示:

    log4j.appender.appenderName.layout = xxx
    

    如果我们使用了org.apache.log4j.PatternLayout这个配置,那我们就可以使用类似于 C 的格式化输出的方式来更灵活的控制我们的 log 的输出格式,格式化输出命令如下所示:

    %m 输出代码中指定的消息
    %p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL  
    %r 输出自应用启动到输出该log信息耗费的毫秒数  
    %c 输出所属的类目,通常就是所在类的全名  
    %t 输出产生该日志事件的线程名
    %n 输出一个回车换行符,Windows平台为"\r\n",Unix平台为"\n"
    %d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS}
    %l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数
    

    使用方式如下所示:

    log4j.appender.appenderName.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
    
  3. 其他的一些属性配置信息

    Threshold属性,用来控制输出日志的优先级别,同 log4j.rootLogger 中的 level 类似,但是 Threshold 只对当前的 appender 有效

    使用方式如下所示:

    log4j.appender.appenderName.Threshold = DEBUG
    

    File 和 Append 属性,当我们要把日志输出到文件的时候,需要用这两个属性来配置日志的输出位置和是否覆盖原来文件中日志(显然一般是不覆盖,而是在后面追加新的日志的)

    使用方式如下所示:

    log4j.appender.appenderName.File = ${webapp.root}/WEB-INF/logs/log.log
    log4j.appender.appenderName.Append = true
    

    把日志输出到系统的标准输出上

    log4j.appender.appenderName.Target = System.out
    

3.一个典型的例子

### 定义了log4j.rootLogger,优先级为debug,即包含了所有的优先级日志 ###
### 定义了三个 Appender,分别为 stdout, D, E ###
log4j.rootLogger = debug,stdout,D,E

### 设置 stdout,它实现了控制台日志输出 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
### 使用了自定义的布局模式 ###
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
### 自定义了输出模式 ###
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

### 设置 D,它实现了把日志输出到文件,优先级为DEBUG ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
### 把日志输出到指定的文件之中 ###
log4j.appender.D.File = ${webapp.root}/WEB-INF/logs/log.log
### 在现有的日志后面追加新的日志 ###
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 输出ERROR 以上级别的日志到 logs/error.log ###
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File = ${webapp.root}/WEB-INF/logs/error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m

关于如何搭建 log4j 的使用环境,可以参阅搭建一个 log4j 使用环境