log4j是干什么的
log4j是Apache的一个开源项目,主要功能是打印日志信息,以各种形式在各种地方花式打印日志。
使用log4j的准备工作
使用log4j就必须要引入其jar包。
附上官网地址http://logging.apache.org/log4j/2.x/download.html
如果你用maven
<dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency>
当然,这里的maven依赖不是最新的版本。如果想用最新版本,在网上随随便便就能找到,具体就不说了。
使用
代码
按照用过程来说,我们首先写好配置文件然后在进行代码的编写。但是由于代码的编写比较简单单一,并且在这里我们把不同的配置方式结果都是用相同的代码进行比较,所以这里就暂且本末倒置,先把代码部分放上来。
import org.apache.log4j.Logger; public class Log4jDemo { private static Logger logger = Logger.getLogger(Log4jDemo.class); public static void main(String[] args) { logger.debug("@debug"); logger.info("@info"); logger.error("@error"); logger.warn("@warn"); } }
配置
log4j可以使用xml文件配置,也可以使用properties文件进行配置。
在日常使用中,我们基本上都使用properties文件进行配置。这里就以properties文件进行配置举例说明。在此之前我们需要新建一个log4j.properties配置文件并将其放在项目根目录下。
在log4j的配置中,有以下三大必要要素。
- 日志级别
- 日志输出位置
- 日志输出样式
接下来我们看具体配置:
日志级别
log4j中日志级别一共有5级,加上全开与全关两个状态,一共有7个状态:
状态 | 级别 |
---|---|
all | Integer.MIN_VALUE |
debug | 10000 |
info | 20000 |
warn | 30000 |
error | 40000 |
fatal | 50000 |
off | Integer.MAX_VALUE |
从上到下级别的值是增加的,但是权重是逐渐降低的。权重的排名如下:
all>debug>info>warn>error>fatal>off
我们选择打印某个级别的日志的时候,权重不大于这个级别的日志都会被打印出来。例如:我们选择info级别的日志,则info、warn、error、fatal都会被打印出来,但是debug不会被打印出来。
日志的各种级别以及优先级已经分析清楚了,那么具体是怎么配置的呢?
log4j.rootLogger = [leven],[appendername]
举例:
log4j.rootLogger = debug,myAppender
在上边的例子中,我们配置日志的级别为debug级,还定义了一个名为myAppender的appender
输出类型
在log4j里一共提供了5种输出类型,分别是:
org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
举例:
log4j.appender.myAppender = org.apache.log4j.ConsoleAppender
在上边的例子中,我们定义为控制台输出,其中myAppender
为上边定义日志级别的时候我们定义的那个appender
输出格式
在log4j里一共提供了4种输出格式,分别是:
org.apache.log4j.HTMLLayout(HTML表格形式)
org.apache.log4j.SimpleLayout(日志级别信息、输出字符串)
org.apache.log4j.TTCCLayout(日志级别、产生日志的线程、输出字符串)
org.apache.log4j.PatternLayout(自己指定输出格式)
举例:
log4j.appender.appender1.layout = org.apache.log4j.SimpleLayout
在上边的例子中,我们定义了一个SimpleLayout(包含日志信息的级别和信息字符串)类型的输出格式。
自定义格式:
%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},输出类似:2002年10月18日 22 : 10 : 28 , 921
%l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java: 10 )
实战举例
log4j.rootLogger = debug,stdout,appender1,appender2 # 输出到控制台 log4j.appender.stdout = org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout = org.apache.log4j.TTCCLayout #输出到日志文件 log4j.appender.appender1 = org.apache.log4j.DailyRollingFileAppender #输出日志文件位置 log4j.appender.appender1.File = logs/log.log #以追加的方式添加 log4j.appender.appender1.Append = true #输出权重不大于DEBUG的日志 log4j.appender.appender1.Threshold = DEBUG log4j.appender.appender1.layout = org.apache.log4j.TTCCLayout #保存异常信息到单独文件 log4j.appender.appender2 = org.apache.log4j.DailyRollingFileAppender #输出日志文件位置 log4j.appender.appender2.File = logs/error.log #以追加的方式添加 log4j.appender.appender2.Append = true #只输出权重不大于ERROR日志 log4j.appender.appender2.Threshold = ERROR log4j.appender.appender2.layout = org.apache.log4j.PatternLayout log4j.appender.appender2.layout.ConversionPattern = %d %p %l - %m %n
输出日志结果:
log.log
[main] DEBUG com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @debug [main] INFO com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @info [main] WARN com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @warn [main] ERROR com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @error [main] FATAL com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @fatal
error.log
2015-11-28 23:17:00,371 ERROR com.zhangyingwei.log4jdemo.debug_console.Log4jDemo.main(Log4jDemo.java:12) - @error 2015-11-28 23:17:00,375 FATAL com.zhangyingwei.log4jdemo.debug_console.Log4jDemo.main(Log4jDemo.java:13) - @fatal
【1】从零开始
a). 新建Java Project>>新建package>>新建java类;
b). import jar包(一个就够),这里我用的是log4j-1.2.14.jar,
c). 新建log4j.properties,置于project根目录下;
log4j.rootLogger=info, ServerDailyRollingFile, stdout
log4j.appender.ServerDailyRollingFile=org.apache.log4j.DailyRollingFileAppender
log4j.appender.ServerDailyRollingFile.DatePattern='.'yyyy-MM-dd
log4j.appender.ServerDailyRollingFile.File=C://logs/notify-subscription.log
log4j.appender.ServerDailyRollingFile.layout=org.apache.log4j.PatternLayout
log4j.appender.ServerDailyRollingFile.layout.ConversionPattern=%d - %m%n
log4j.appender.ServerDailyRollingFile.Append=truelog4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %p [%c] %m%n
d). 在main()中,加载log4j:
PropertyConfigurator.configure("log4j.properties");
e). 写个小程序测试下,好了,我们看下效果:
【神马】找不到文件exception?
1). 用绝对路径,真心不推荐啊,太不优雅了;
2). 将log4j文件置于bin/目录下:
a). 代码中,PropertyConfigurator.configure("bin/log4j.properties");
b). 代码中,PropertyConfigurator.configure(ClassLoader.getSystemResource("log4j.properties"));
c). 注意,必须位于bin直接目录下,不可位于bin更深层的目录当中。可是这究竟是为神马捏?
可参考: http://blog.sina.com.cn/s/blog_3f4755c70100jco1.html
3) 必杀技:
private static void initLog4j() {
Properties prop = new Properties();
prop.setProperty("log4j.rootLogger", "DEBUG, CONSOLE");
prop.setProperty("log4j.appender.CONSOLE", "org.apache.log4j.ConsoleAppender");
prop.setProperty("log4j.appender.CONSOLE.layout", "org.apache.log4j.PatternLayout");
prop.setProperty("log4j.appender.CONSOLE.layout.ConversionPattern", "%d{HH:mm:ss,SSS} [%t] %-5p %C{1} : %m%n");
PropertyConfigurator.configure(prop);
}
【2】log4j 格式详解
log4j.rootLogger=日志级别,appender1, appender2, ….
- 日志级别:ALL<DEBUG<INFO<WARN<ERROR<FATAL<OFF,不区分大小写
- 注意,需在控制台输入,只需将其中一个appender定义为stdout即可
- 注意,rootLogger默认是对整个工程生效
- 注意,如果只想对某些包操作,那么:log4j.logger.com.hutu=info, stdout,表示该日志对package com.hutu生效
- 注意,这样做可以区分dev/线上,也可以减小性能影响:if(log.isDebugEnabled()){log.debug();}
log4j.appender.appender1=org.apache.log4j.日志输出到哪儿
- ConsoleAppender(控制台)
- FileAppender(文件)
- DailyRollingFileAppender(每天产生一个日志文件)
- RollingFileAppender(文件大小到达指定尺寸时产生一个新的文件)
- WriteAppender(将日志信息以流格式发送到任意指定的地方)
- JDBCAppender(将日志信息保存到数据库中)
log4j.appender.appender1.File=文件目录及文件
${user.home}/logs/...
log4j.appender.appender1.MaxFileSize=最大文件大小
log4j.appender.appender1.MaxBackupIndex=备份文件个数
- 其中,appender1是在第一行定义过的;
- 文件目录及文件,例如,/home/admin/logs/hutudan.log
- 最大文件大小,例如,100KB
- 备份文件个数,例如,1
log4j.appender.ServerDailyRollingFile.DatePattern=日志后缀格式
- 例如,'.'yyyy-MM-dd
log4j.appender.appender1.layout=org.apache.log4j.日志布局格式
- HTMLLayout(以HTML表格形式布局)
- SimpleLayout(包含日志信息的级别和信息字符串)
- TTCCLayout(包含日志产生的时间,执行绪,类别等信息)
- PatternLayout(可以灵活的指定布局格式,常用)
log4j.appender.appender1.layout.ConversionPattern=日志输出格式
- 例如,%d - %m%n或%d{yyyy-MM-dd HH:mm:ss} %p [%c] %m%n
- %c 输出日志信息所属的类的全名
- %d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy-M-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 输出产生该日志事件的线程名
- 可参考:http://blog.sina.com.cn/s/blog_4e4dd5570100qowy.html
log4j.appender.ServerDailyRollingFile.Append=true
- 例如,不解释,追加往后写便是
总结一下:
- Logger类:完成日志记录,设置日志信息级别
- Appender类:决定日志去向,终端、DB、硬盘
- Layout类:决定日志输出的样式,例如包含当前线程、行号、时间
from: http://www.jianshu.com/p/9ea1f893aa41?utm_campaign=haruki&utm_content=note&utm_medium=reader_share&utm_source=qq
http://www.cnblogs.com/alipayhutu/archive/2012/06/21/2558249.html