Log4j log for java(java的日志) 是java主流的日志框架,提供各种类型,各种存储,各种格式,多样化的日志服务;
Maven项目
pom.xml引入log4j
1
2
3
4
5
|
<
dependency
>
<
groupId
>log4j</
groupId
>
<
artifactId
>log4j</
artifactId
>
<
version
>1.2.17</
version
>
</
dependency
>
|
log4j.properties
1
2
3
4
5
6
7
8
9
10
11
12
|
log4j.rootLogger=DEBUG, Console ,File
#Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
#File
log4j.appender.File = org.apache.log4j.FileAppender
log4j.appender.File.File = C://log.log
log4j.appender.File.layout = org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
|
把Debug信息输出到控制台和本地文件
Log4j根据日志信息的重要程度: OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL
当然再细分的话 还有 FATAL(严重错误),
但是Log4j官方建议实际实用的话,Log4j建议只使用四个级别,优先级从高到低分别是 ERROR、WARN、INFO、DEBUG
假如rootLogger定义的是DEBUG 那所有的报错信息都会输出;
假如定义的是INFO 那么DEBUG信息是不会输出的,其他信息输出;
假如定义最高等级ERROR,那么只有ERROR信息会输出,其他低等级信息是不会输出的;
Log4j 根配置语法
1
|
log4j.rootLogger = [ level ] , appenderName, appenderName, …
|
指代 把指定级别的日志信息输出到指定的一个或者多个位置
如:
log4j.properties
1
2
3
4
5
6
7
8
9
10
11
12
|
log4j.rootLogger=INFO, Console ,File
#Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
#File
log4j.appender.File = org.apache.log4j.FileAppender
log4j.appender.File.File = C://log.log
log4j.appender.File.layout = org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
|
这里我们把INFO层级以及以上的信息输出到Console和File;
Log4j官方的appender给出了一下几种实现
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
MaxFileSize 是日志文件的最大尺寸;根据实际需求来定 10KB 100KB也行
MaxBackupIndex是日志文件的个数,假如超过了,则覆盖,主要考虑到的是硬盘的容量问题;根据实际需求来定 比如 100 500;
实际开发我们使用第1,第3和第4种实现;
假如日志数据量不是很大,我们可以用DailyRollingFileAppender 每天产生一个日志,方便查看;
假如日志数据量很大,我们一般用RollingFileAppender,固定尺寸的日志,假如超过了 就产生一个新的文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
log4j.rootLogger=DEBUG, Console ,File ,DailyRollingFile ,RollingFile
#Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
#File
log4j.appender.File = org.apache.log4j.FileAppender
log4j.appender.File.File = C://log2.log
log4j.appender.File.layout = org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
#DailyRollingFile
log4j.appender.DailyRollingFile = org.apache.log4j.DailyRollingFileAppender
log4j.appender.DailyRollingFile.File = C://log3.log
log4j.appender.DailyRollingFile.layout = org.apache.log4j.PatternLayout
log4j.appender.DailyRollingFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
#RollingFile
log4j.appender.RollingFile = org.apache.log4j.RollingFileAppender
log4j.appender.RollingFile.File = C://log4.log
log4j.appender.RollingFile.MaxFileSize=1KB
log4j.appender.RollingFile.MaxBackupIndex=3
log4j.appender.RollingFile.layout = org.apache.log4j.PatternLayout
log4j.appender.RollingFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
|
Log4j提供的layout
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
HTMLLayout实例,我们把前面的实例的配置文件改下
1
2
3
|
#Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.HTMLLayout
|
我们运行 看下输出信息:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<
html
>
<
head
>
<
title
>Log4J Log Messages</
title
>
<
style
type
=
"text/css"
>
<!--
body, table {font-family: arial,sans-serif; font-size: x-small;}
th {background: #336699; color: #FFFFFF; text-align: left;}
-->
</
style
>
</
head
>
<
body
bgcolor
=
"#FFFFFF"
topmargin
=
"6"
leftmargin
=
"6"
>
<
hr
size
=
"1"
noshade>
Log session start time Wed Mar 29 10:17:41 CST 2017<
br
>
<
br
>
<
table
cellspacing
=
"0"
cellpadding
=
"4"
border
=
"1"
bordercolor
=
"#224466"
width
=
"100%"
>
<
tr
>
<
th
>Time</
th
>
<
th
>Thread</
th
>
<
th
>Level</
th
>
<
th
>Category</
th
>
<
th
>Message</
th
>
</
tr
>
<
tr
>
<
td
>0</
td
>
<
td
title
=
"main thread"
>main</
td
>
<
td
title
=
"Level"
>INFO</
td
>
<
td
title
=
"com.open1111.Test category"
>com.open1111.Test</
td
>
<
td
title
=
"Message"
>普通Info信息</
td
>
</
tr
>
<
tr
>
<
td
>16</
td
>
<
td
title
=
"main thread"
>main</
td
>
<
td
title
=
"Level"
><
font
color
=
"#339933"
>DEBUG</
font
></
td
>
<
td
title
=
"com.open1111.Test category"
>com.open1111.Test</
td
>
<
td
title
=
"Message"
>调试debug信息</
td
>
</
tr
>
<
tr
>
<
td
>16</
td
>
<
td
title
=
"main thread"
>main</
td
>
<
td
title
=
"Level"
><
font
color
=
"#993300"
><
strong
>ERROR</
strong
></
font
></
td
>
<
td
title
=
"com.open1111.Test category"
>com.open1111.Test</
td
>
<
td
title
=
"Message"
>报错error信息</
td
>
</
tr
>
<
tr
>
<
td
>16</
td
>
<
td
title
=
"main thread"
>main</
td
>
<
td
title
=
"Level"
><
font
color
=
"#993300"
><
strong
>WARN</
strong
></
font
></
td
>
<
td
title
=
"com.open1111.Test category"
>com.open1111.Test</
td
>
<
td
title
=
"Message"
>警告warn信息</
td
>
</
tr
>
<
tr
>
<
td
>16</
td
>
<
td
title
=
"main thread"
>main</
td
>
<
td
title
=
"Level"
><
font
color
=
"#993300"
><
strong
>FATAL</
strong
></
font
></
td
>
<
td
title
=
"com.open1111.Test category"
>com.open1111.Test</
td
>
<
td
title
=
"Message"
>严重错误fatal信息</
td
>
</
tr
>
<
tr
>
<
td
>16</
td
>
<
td
title
=
"main thread"
>main</
td
>
<
td
title
=
"Level"
><
font
color
=
"#993300"
><
strong
>ERROR</
strong
></
font
></
td
>
<
td
title
=
"com.open1111.Test category"
>com.open1111.Test</
td
>
<
td
title
=
"Message"
>报错信息</
td
>
</
tr
>
<
tr
><
td
bgcolor
=
"#993300"
style
=
"color:White; font-size : xx-small;"
colspan
=
"6"
>java.lang.IllegalArgumentException: 非法参数
<
br
> at com.open1111.Test.main(Test.java:16)
</
td
></
tr
>
|
标准的html table表格格式,显示信息包括 线程 等级 类 报错信息;
PatternLayout是我们以后推荐使用的,很灵活;
有个ConversionPattern属性,灵活配置输出属性:
%m 输出代码中指定的消息;
%M 输出打印该条日志的方法名;
%p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL;
%r 输出自应用启动到输出该log信息耗费的毫秒数;
%c 输出所属的类目,通常就是所在类的全名;
%t 输出产生该日志事件的线程名;
%n 输出一个回车换行符,Windows平台为"rn”,Unix平台为"n”;
%d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyyy-MM-dd HH:mm:ss,SSS},输出类似:2002-10-18 22:10:28,921;
%l 输出日志事件的发生位置,及在代码中的行数;
SimpleLayout简单布局:
1
2
3
|
#Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.SimpleLayout
|
运行输出:
INFO - 普通Info信息
DEBUG - 调试debug信息
ERROR - 报错error信息
WARN - 警告warn信息
FATAL - 严重错误fatal信息
ERROR - 报错信息
java.lang.IllegalArgumentException: 非法参数
at com.open1111.Test.main(Test.java:16)
只有级别和信息,确实简单
TTCCLayout我们测试下:
1
2
3
|
#Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.TTCCLayout
|
运行输出:
[main] INFO com.open1111.Test - 普通Info信息
[main] DEBUG com.open1111.Test - 调试debug信息
[main] ERROR com.open1111.Test - 报错error信息
[main] WARN com.open1111.Test - 警告warn信息
[main] FATAL com.open1111.Test - 严重错误fatal信息
[main] ERROR com.open1111.Test - 报错信息
java.lang.IllegalArgumentException: 非法参数
at com.open1111.Test.main(Test.java:16)
我们实际开发使用的是灵活的PatternLayout 其他的了解即可;
Log4j Threshold属性指定输出等级
有时候我们需要把一些报错ERROR日志单独存到指定文件 ,这时候,Threshold属性就派上用场了;
Threshold属性可以指定日志level
Log4j根据日志信息的重要程度,分OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL
比如我们指定某个appender的Threshold为WARN,那这个appender输出的日志信息就是WARN级别以及WARN以上的级别;
假如我们指定的是ERROR,那这个就输出ERROR或者FATAL日志信息;
当然这里有个提前 rootLogger里配置的level比如小于Threshold层级 否则无效 还是按照总的rootLogger里的level来输出,一般我们实际实用的话 rootLogger里配置DEBUG,然后某个文件专门存储ERRO日志,就配置下Threshold为ERROR,这个就是我们的最佳实践,不要乱七八糟瞎配置;
我们给下参考配置:
log4j.rootLogger=DEBUG, Console ,DFile ,EFILE
#Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.TTCCLayout
#DEBUGFile
log4j.appender.DFile = org.apache.log4j.FileAppender
log4j.appender.DFile.File = C://DEBUG.log
log4j.appender.DFile.layout = org.apache.log4j.PatternLayout
log4j.appender.DFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
log4j.appender.DFile.Threshold = DEBUG
#ERRORFile
log4j.appender.EFILE = org.apache.log4j.FileAppender
log4j.appender.EFILE.File = C://ERROR.log
log4j.appender.EFILE.layout = org.apache.log4j.PatternLayout
log4j.appender.EFILE.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
log4j.appender.EFILE.Threshold = ERROR
rootLogger里配置DEBUG,
DFile的Threshold 配置为DEBUG
EFILE的Threshold 配置为ERROR 只输入ERROR信息;
ERROR.LOG只输出error信息
Log4j Append属性指定是否追加内容
Log4j默认是不断的把日志内容追加到日志文件;
这里就有个属性 Append 默认就是true;
假如我们设置成false 就不追加了 直接覆盖前面的内容;
我们来测试下:
log4j.rootLogger=DEBUG, Console ,FIEL
#Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.TTCCLayout
#FIEL
log4j.appender.FIEL = org.apache.log4j.FileAppender
log4j.appender.FIEL.File = C://log.log
log4j.appender.FIEL.layout = org.apache.log4j.PatternLayout
log4j.appender.FIEL.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n
log4j.appender.FIEL.Append = false
改成了 Append false
测试类:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
package
com.open1111;
import
org.apache.log4j.Logger;
public
class
Test {
private
static
Logger logger=Logger.getLogger(Test.
class
);
// 获取logger实例
public
static
void
main(String[] args) {
logger.info(
"普通Info信息"
);
logger.debug(
"调试debug信息"
);
logger.error(
"报错error信息"
);
logger.warn(
"警告warn信息"
);
logger.fatal(
"严重错误fatal信息"
);
logger.error(
"报错信息"
,
new
IllegalArgumentException(
"非法参数"
));
}
}
|
我们第一次执行:
我们修改下测试代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
package
com.open1111;
import
org.apache.log4j.Logger;
public
class
Test {
private
static
Logger logger=Logger.getLogger(Test.
class
);
// 获取logger实例
public
static
void
main(String[] args) {
logger.info(
"普通Info信息22222222222222"
);
logger.debug(
"调试debug信息"
);
logger.error(
"报错error信息"
);
logger.warn(
"警告warn信息"
);
logger.fatal(
"严重错误fatal信息"
);
logger.error(
"报错信息222222222222222"
,
new
IllegalArgumentException(
"非法参数"
));
}
}
|
按照默认 Append true
是追加的,我们这里Append false
结果是覆盖前面的
OK 这个属性我们了解下即可 用默认的true即可;