Log4J的三个组件:
Logger:日志记录器,负责收集处理日志记录(如何处理日志)
Appender:日志输出目的地,负责日志的输出(输出到什么地方)
Layout:日志格式化,负责对输出的日志的格式化(以什么形式展现)
一个logger可以对应多个appender,一个appender只能对应一个layout。
1、Logger:
logger可以有选择的启动和禁用日志的输出,我们经常会在各种框架中看到如:
private static final Logger log=LoggerFactory.getLogger(xx.class);
讲解:log就代表了一个Logger实例,他的name就是类“xx”的full quailied name(类的全限定名),这个log可以指定多个appender和layout。Logger的名字大小写敏感,其命名有继承机制:例如:name为org.apache.commons的logger会继承name为org.apache的logger。
Log4J中有一个特殊的logger叫做“root”,他是所有logger的根,也就意味着其他的logger都会直接或者间接地继承自root。root logger可以用Logger.getRootLogger()方法获取,但是不能通过Logger.getLogger("root")获得。
java code:
Logger root = Logger.getRootLogger();
Logger log = Logger.getLogger("root");
System.out.println(log==root);//false 说明root无法通过name获取
Logger log2 = Logger.getLogger("root");
System.out.println(log==log2);//true,说明一个name唯一对应一个logger
2、Level:
level为logger服务,用来定义日志的级别,他的值可以是:OFF(关闭)FATAL(致命的)ERROR(错误)WARN(警告)INFO(信息)DEBUG(调试)ALL(所有),输出日志的策略由此Level决定,例如:如果logger的Level设置为INFO,那么系统只输出INFO以及以上(WARN、ERROR、FATAL)信息。如果当前logger没有设定Level,那么它在输出日志时采用的策略是:它会使用它继承的Logger的Level作为它自己的Level来处理。如果它的上级也没有设置Level,那么就找上上级,几次类推,直到root为止,(root的Level是不能设为空的,所以最终一定会找到一个Level)。默认root的Level是INFO,其他logger的Level默认都是null,需要手动指定。
Level对应的logger输出级别对应的方法有:
logger.debug(message);
logger.info(message);
logger.error(message);
logger.fatal(message);
3、Appender:
Appender可以控制日志的输出的目的地,一个输出源就叫一个Appender,appender的类别有:Console(控制台)File(文件)JDBC、JMS等等,logger可以通过方法logger.addAppender(appender)配置多个appender,对logger来说,每个有效的日志请求结果都将输出到logger本身以及父logger的appender上。例如:
Logger com=Logger.getLogger("com");
Appender appender = new FileAppender(new SimpleLayout(),"hello.log");
com.addAppender(appender);
Logger iteye = Logger.getLogger("com.iteye");
iteye.addAppender(new ConsoleAppender(new SimpleLayout(),"System.out"));//target:sys.out(default)或sys.err
iteye.info("hello world");
上例中,“iteye”是继承"com"logger的,“com”定义的appender是FileAppender,而“iteye”定义的appender是ConsoleAppender,这里我并没有设置他们的Level,那么自动使用root默认的INFO作为日志的等级,因此此处iteye.info("hello world")会被输出到指定的appender上。但是最终日志信息会显示在控制台,而且也会输出到文件hello.log中去。不过这里可以通过设置logger“iteye”的additivity(附加标记)设为false==>>iteye.setAdditivity(false);这样日志信息”hello world“就不会写入到hello.log中去了。
常用的集中appender有:
org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
org.apache.log4j.RollingFileAppender((文件大小到达指定尺寸的时候产生一个新的文件))
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
4、Layout:
使用指定的Layout来展示(格式化)日志,常见的Layout有:
org.apache.log4j.HTMLLayout(以HTML表格形式布局)
org.apache.log4j.PatternLayout(可以灵活地指定布局模式)
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息),等
5、配置:
配置了以上几个组件后,我们就可以了解一下log4j的配置.properties了。
Java code:
#配置根Logger
log4j.rootLogger = [level],appenderName1,appenderName2,...
#例子:
log4j.rootLogger = DEBUG,stdout,file
java code:
#配置日志信息输出目的地(Appender)
log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1=value1
...
log4j.appender.appenderName.optionN=valueN
#例子
###输出到控制台###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout .Target = System.out #默认就是System.out,另外一个值是System.error
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{1}:%L - %m%n
###输出到文件###
log4j.appender.file=org.apache.log4j.DailyRollingFileAppender
log4j.appender.file.File = logs/log.log
log4j.appender.file.Append = true #默认是true,系统启动时追加至文件中,否则会覆盖原有内容
log4j.appender.file.Threshold = INFO ## 输出IFNO级别以上的日志,这里的意思是rootLooger设置为DEBUG时,只输出INFO以上(INFO、WARN、ERROR、FATAL)的信息到文件中去,而DEBUG信息就不会输出 了
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] % m%n
java code
#配置日志信息的格式(Layout)
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
...
log4j.appender.appenderName.layout.optionN = valueN
#例子
log4j.appender.file.layout = org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] %m%n
ConversionPattern参数的格式含义
格式名 含义
%c 输出日志信息所属的类的全名
%d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy-MM-dd HH:mm:ss},输出类似:2002-10-18 22:10:28
%f 输出日志信息所属的类的类名
%l 输出日志事件的发生位置,即输出日志信息的语句处于它所在的类的第几行
%m 输出代码中指定的信息,如log(message)中的message
%n 输出一个回车换行符,Windows平台为“rn”,Unix平台为"n"
%p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL。如果是调用debug()输出的。则国DEBUG,依此类推
%r 输出自应用启动到输出该日志信息所耗费的毫秒数
%t 输出产生该日志事件的线程名
最后如果你看到此类错误应该有不再感到疑惑了吧:
public static org.slf4j.Logger log = LoggerFactory.getLogger(Test.class);
log.error("erro");
log4j:WARN No appenders could be found for logger (Test).
log4j:WARN Please initialize the log4j system properly.