log4j.properties配置文件及详解

log4j配置文件有三个主要的组件:Logger,Appender和Layout,分别为日志类型,日志输出目的地,日志输出格式。

1. 配置日志级别及appenderName

log4j.rootLogger=[level],console,debugFileAppender,errorFileAppender,...

注:其中 [level] 是日志输出级别:FATAL、ERROR、WARN、INFO、DEBUG 五个级别,通过定义的级别,你可以控制程序中的日志输出,例:如果定义了ERROR级别,程序中只有FARAL、ERROR 级别的 log 会被输出。

  • FATAL:致命错误。
  • ERROR:严重错误,主要是程序的错误。
  • WARN:一般警告,比如session丢失。
  • INFO:一般要显示的信息,比如登录退出。
  • DEBUG:程序的调试信息。

2. Log4j提供的输出目的地有以下几种:

log4j.appender.appenderName= 输出目的地 (这里的appenderName是在前面定义的,可任意起名)

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

3. 配置布局类型

log4j.appender.appenderName.layout = 布局类型(设置布局类型) 

Log4j提供的layout有以下4种:

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

4. 配置符号所代表的含义:log4j.appender.根.layout.ConversionPattern=

  •  %p:输出日志信息的优先级,即FATAL、ERROR、WARN、INFO、DEBUG。
  •  %d:输出日志日期或时间,默认格式为ISO8601,也可以在其后指定格式。例:%d{yyyy MMM dd HH:mm:ss,SSS},输出:2000年01月01日 00:00:10,000
  •  %c:输出日志信息所属的类目,通常就是所在类的全名。
  •  %F:输出日志消息产生时所在的文件名称
  •  %L:输出代码中的行号。
  •  %l:输出日志事件的发生位置,包括全类名方法名、发生的线程,以及在代码中的行号,相当于%c(%F:%L)的组合,但这个组合不包括方法名。例:cn.xiwh.test.Testlog4j.main(TestLog4j.java:10) 
  •  %m:输出代码中指定产生的日志的具体信息。
  •  %n:输出一个回车换行符,Windows平台为" ",Unix平台为" "输出日志信息换行。
  •  %r:输出自应用启动到输出该log信息耗费的毫秒数。
  •  %t:输出产生该日志事件的线程名。
  •  %x:输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
  •  %%:输出一个"%"字符。
  • [QC]:是log信息的开头,可以为任意字符,一般为项目简称。
  • -X号:X信息输出时左对齐。

可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、及文本的对齐方式。例:

1). %20c:指定输出类的名称,最小的宽度是20,如果类的名称小于20,默认的情况下右对齐。

2). %-20c:指定输出类的名称,最小的宽度是20,如果类的名称小于20,"-"号指定左对齐。 

3). %.30c:指定输出类的名称,最大的宽度是30,如果类的名称大于30就会将左边多出的字符截掉,但小于30也不会有空格。

4). %20.30c:如果类的名称小于20就补空格并且右对齐,如果其名称大于30就从左边较远输出的字符截掉。

5. 配置文件 log4j.properties

### 配置日志级别及appenderName ###
log4j.rootLogger=error,console,debugFileAppender,errorFileAppender,dailyRollingFile,rollingFile,mail

### 配置输出信息到控制抬 ###
log4j.appender.console=org.apache.log4j.ConsoleAppender
#默认值是System.out,指定输出控制台。
log4j.appender.console.Target=System.out
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%-5p] [%d{yyyy-MM-dd HH:mm:ss,SSS}] method:%l%n%m%n

### 配置输出DEBUG级别以上的日志文件到> D://logs/debug.log ###
log4j.appender.debugFileAppender=org.apache.log4j.FileAppender
log4j.appender.debugFileAppender.File=D://logs/debug.log
log4j.appender.debugFileAppender.Append=true
log4j.appender.debugFileAppender.Threshold=DEBUG 
log4j.appender.debugFileAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.debugFileAppender.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出ERROR级别以上的日志文件到> D://logs/error.log ###
log4j.appender.errorFileAppender=org.apache.log4j.FileAppender
log4j.appender.errorFileAppender.File=D://logs/error.log 
log4j.appender.errorFileAppender.Append=true
log4j.appender.errorFileAppender.Threshold=ERROR 
log4j.appender.errorFileAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.errorFileAppender.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出DEBUG级别以上的日志文件到> D://logs/debug.log 并且每天都创建一个文件 ###
log4j.appender.dailyRollingFile=org.apache.log4j.DailyRollingFileAppender
log4j.appender.dailyRollingFile.File=D://logs/debug.log
log4j.appender.dailyRollingFile.Append=true
log4j.appender.dailyRollingFile.Threshold=DEBUG
log4j.appender.dailyRollingFile.layout=org.apache.log4j.PatternLayout
log4j.appender.dailyRollingFile.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出DEBUG级别以上的日志文件到> D://logs/debugRolling.log 且大小到达指定尺寸的时候产生一个新的文件 ###
log4j.appender.rollingFile=org.apache.log4j.RollingFileAppender
#指定消息输出到> D://logs/debugRolling.log文件
log4j.appender.rollingFile.File=D://logs/debugRolling.log
#默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
log4j.appender.rollingFile.Append=true
#指定日志消息的输出最低层次
log4j.appender.rollingFile.Threshold=DEBUG
#后缀可以是KB、MB或者是GB,在日志文件到达该大小时,将会自动滚动,即将原来的内容移到debug.log.1文件。
log4j.appender.rollingFile.MaxFileSize=10KB
#指定可以产生的滚动文件的最大数
log4j.appender.rollingFile.MaxBackupIndex=1
log4j.appender.rollingFile.layout=org.apache.log4j.PatternLayout
log4j.appender.rollingFile.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

### 配置输出到邮件 ###
log4j.appender.mail=org.apache.log4j.net.SMTPAppender
# 日志的错误级别
log4j.appender.mail.Threshold=DEBUG
# 缓存文件大小,日志达到10K时发送Email
log4j.appender.mail.BufferSize=10
# 发送邮件的服务器
log4j.appender.mail.SMTPHost=smtp.163.com
# 邮件的标题
log4j.appender.mail.Subject=Log4J DebugMessage
# 邮箱地址
log4j.appender.mail.SMTPUsername=test@163.com
# 密码
log4j.appender.mail.SMTPPassword=test
# 发件人
log4j.appender.mail.From=test@163.com
# 收件人
log4j.appender.mail.To=receive@163.com
# 日志PatternLayout
log4j.appender.mail.layout=org.apache.log4j.PatternLayout
# 日志的格式
log4j.appender.mail.layout.ConversionPattern=[DebugMessage] %d - %c -%-4r [%t] %-5p %c %x - %m%n