一、配置文件详解
首先讲下日志等级,等级从高到底分别是:OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL。总共7个等级,
其中最常用的是ERROR、WARN、INFO、DEBUG。在配置文件中,我们可以根据需要设置日志等级,当设置为ERROR
等级时,可以打印出ERROR以下的日志信息,当设置为DEBUG等级时,会将DEBUG等级以及以下的等级的日志打印出来。
常用的log4j配置如下:
#设置根Logger
log4j.rootLogger = debug,stdout,D,E
### 输出信息到控制抬 ###
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 = %d{yyyy-MM-dd HH:mm:ss,SSS} [%-5p] method:%l %m%n
### 输出DEBUG 级别以下的日志到=F://logs/debug.log ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = F://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,SSS} [%-5p] method:%l %m%n
### 输出ERROR 级别以下的日志到=F://logs/error.log ###
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File =F://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,SSS} [%-5p] method:%l %m%n
二、配置讲解
1、首先要配置根Logger:
log4j.rootLogger = [ level ] , appenderName, appenderName, …
[ level ] :设置日志等级;
appenderName:日志输出目的地,可以配置多个
2、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 配置使用文件保存日志信息时,可以使用log4j.appender.appenderName.File配置日志文件保存路径;
4、log4j.appender.appenderName.Append 日志内容是否追加,默认是true。
5、log4j.appender.appenderName.Threshold 配置日志等级,注意:这里配置的日志等级应该小于或者等于log4j.rootLogger配置的日志等级,不然即使配置更高级也无效。
6、log4j.appender.appenderName.layout 配置日志的打印方式,有以下几种类型:
#org.apache.log4j.HTMLLayout(以HTML表格形式布局),
#org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
#org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
#org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息。
7、log4j.appender.appenderName.layout.ConversionPattern 设置打印日志信息的具体格式,与log4j.appender.appenderName.layout=org.apache.log4j.PatternLayout配合使用,
比如:log4j.appender.appenderName.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss,SSS} [%-5p] method:%l %m%n
# %d{yyyy-MM-dd HH:mm:ss,SSS} [%-5p] method:%l %m%n 从右向左介绍
# %n 输出一个回车换行符,Windows平台为"rn”,Unix平台为"n”,
# %m 输出代码中指定的消息,
# %l 输出日志事件的发生位置,及在代码中的行数。
# %p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL,
# %r 输出自应用启动到输出该log信息耗费的毫秒数,
# %d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyyy-MM-dd HH:mm:ss,SSS},输出类似:2002-10-18 22:10:28,921。
8、如果想要配置生成一个日志文件,则可以参考下面配置:
log4j.appender.DailyRolling=org.apache.log4j.DailyRollingFileAppender
log4j.appender.DailyRolling.File=${catalina.base}/logs/portal.log
log4j.appender.DailyRolling.DatePattern=yyyy-MM-dd'.log'
log4j.appender.DailyRolling.layout=org.apache.log4j.PatternLayout
log4j.appender.DailyRolling.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%-5p] method:%l %m%n
配置完成的当天, 会在Tomcat的logs目录下,生成名为portal.log的文件,比如今天是2019-04-11, 到明天这个文件将更名为portal.log2019-04-11.log。
9、如果想要设置日志文件的大小,则可以参考下面配置:
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=${catalina.base}/logs/portal.log
log4j.appender.R.Encoding=GBK
log4j.appender.R.MaxFileSize=256KB
log4j.appender.R.Append=true
log4j.appender.R.MaxBackupIndex=10
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%-5p] method:%l %m%n
将会在Tomcat的logs目录下,生成portal.log文件,当文件大小超过256KB时,将原来的文件更名为portal.log.1,再使用portal.log接收新的日志记录。
log4j.appender.R.MaxBackupIndex=10表示只保存10个备份文件。
二、代码引入思路
1、加依赖包:导入包log4j-1.2.17.jar;
2、写配置文件,参考上面配置;
3、在需要打印日志的类中创建一个日志对象,如:private static Logger logger = Logger.getLogger(Log4jDemo.class);
三、优缺点
优点:实现方式简单、使用方便,通过配置文件可以灵活配置自己想要的日志模型;
缺点:需要大量创建日志对象,耗资源。