1.Log4j 简介
Log4j 是 Apache 的一个开源项目,它允许开发者以 任意间隔输出日志信息。 Log4j 主要由三大类组件构成:
1 ) Logger- 负责输出日志信息,并能够对日志信息进行分类筛选,即决定哪些日志信息应该被输出,哪些该被忽略。 Loggers 组件输出日志信息时分为 5 个级别: DEBUG 、 INFO 、 WARN 、 ERROR 、 FATAL 。这五个级别的顺序是: DEBUG<INFO<WARN<ERROR<FATAL 。如果设置某个 Logger 组件的级别是 P ,则只有级别比 P 高的日志信息才能输出。 Logger 是有继承关系的,最上层是 rootLogger ,定义的其他 Logger 都会继承 rootLogger 。
2 ) Appender- 定义了日志输出目的地,指定日志信息应该被输出到什么地方。输出的目的地可以是控制台、文件或网络 设备。
3 ) Layout- 通过在 Appender 的后面附加 Layout 来实现格式化输出。
一个 Logger 可以有多个 Appender ,每个 Appender 对应一个 Layout 。
2.Loggers
Logger 的定义格式: log4j.[loggername]=[level],appenderName,appenderName,…
这里 level 是指 Logger 的优先级, appenderName 是日志信息的输出地,可以同时定义多个输出地。
3.Appenders
Appender 的定义格式:
log4j.appender.appenderName = fully.qualified.name.of.appender.class
// "fully.qualified.name.of.appender.class" 可以指定下面五个目的地中的一个:
Appender 类及其作用列表
Appender 类名
|
作 用
|
org.apache.log4j.ConsoleAppender
|
将 日志输出到控制台
|
org.apache.log4j.FileAppender
|
将 日志输出到文件
|
org.apache.log4j.DailyRollingFileAppender
|
每 天产生一个日志文件
|
org.apache.log4j.RollingFileAppender
|
文 件大小到达指定尺寸时产生一个新的文件
|
org.apache.log4j. WriterAppender
|
将 日志信息以流格式发送到任意指定的地方
|
1 ) ConsoleAppender 选项
-Threshold=WARN: 指定日志消息的输出最低层次。
-ImmediateFlush=true: 默认值是 true, 意谓着所有的消息都会被立即输出。
-Target=System.err :默认情况下是: System.out, 指定输出控制台。
2 ) FileAppender 选项
-Threshold=WARN: 指定日志消息的输出最低层次。
-ImmediateFlush=true: 默认值是 true, 意谓着所有的消息都会被立即输出。
-File=mylog.txt: 指定消息输出到 mylog.txt 文件。
- Append=false: 默认值是 true, 即将消息增加到指定文件中, false 指将消息覆盖指定的文件内容。
3 ) DailyRollingFileAppender 选项
-Threshold=WARN: 指定日志消息的输出最低层次。
-ImmediateFlush=true: 默认值是 true, 意谓着所有的消息都会被立即输出。
-File=mylog.txt: 指定消息输出到 mylog.txt 文件。
-Append=false: 默认值是 true, 即将消息增加到指定文件中, false 指将消息覆盖指定的文件内容。
-DatePattern='.'yyyy-ww: 每周滚动一次文件,即每周产生一个新的文件。当然也可以指定按月、周、天、时和分。即对应的格式如 下:
'.'yyyy-MM: 每月
'.'yyyy-ww: 每周
'.'yyyy-MM-dd: 每天
'.'yyyy-MM-dd-a: 每天两次
'.'yyyy-MM-dd-HH: 每小时
'.'yyyy-MM-dd-HH-mm: 每分钟
4 ) RollingFileAppender 选项
-Threshold=WARN: 指定日志消息的输出最低层次。
-ImmediateFlush=true: 默认值是 true, 意谓着所有的消息都会被立即输出。
-File=mylog.txt: 指定消息输出到 mylog.txt 文件。
- Append=false: 默认值是 true, 即将消息增加到指定文件中, false 指将消息覆盖指定的文件内容。
-MaxFileSize=100KB: 后缀可以是 KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到 mylog.log.1 文件。
-MaxBackupIndex=2: 指定可以产生的滚动文件的最大数。
4.Layouts
Layout 的定义格式:
部分一 log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
//"fully.qualified.name.of.layout.class" 可以指定下面 4 个格式中的一个:
Layout 类 及其作用列表
Layout 类名
|
作 用
|
org.apache.log4j.HTMLLayout
|
以 HTML 表格形式布局
|
org.apache.log4j.PatternLayout
|
可 以灵活地指定布局模式
|
org.apache.log4j.SimpleLayout
|
包 含日志信息的级别和信息字符串
|
org.apache.log4j.TTCCLayout
|
包 含日志产生的时间、线程、类别等等信息
|
1 ) HTMLLayout 选项
-LocationInfo=true: 默认值是 false, 输出 java 文件名称和行号。
-Title=my app file: 默认值是 Log4J Log Messages 。
2 ) PatternLayout 选项
- ConversionPattern=%m%n : 指定怎样格式化指定的消息。
3 ) XMLLayout 选项
-LocationInfo=true: 默认值是 false, 输出 java 文件和行号。
部分二 log4j.appender.A1.layout.ConversionPattern=
%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
这里需要说明的就是日志信息格式中几个符号所代表的含义:
1 )- X 号 : X 信息输出时左对齐。
2 ) %p: 输出日志信息优先级,即 DEBUG , INFO , WARN , ERROR , FATAL 。
3 ) %d: 输出日志时间点的日期或时间,默认格式为 ISO8601 ,也可以在其后指定格式,比如: %d{yyy MMM dd HH:mm:ss,SSS} ,输出类似: 2002 年 10 月 18 日 22 : 10 : 28 , 921 。
4 ) %r: 输出自应用启动到输出该 log 信息耗费的毫秒数。
5 ) %c: 输出日志信息所属的类目,通常就是所在类的全名。
6 ) %t: 输出产生该日志事件的线程名。
7 ) %l: 输出日志事件的发生位置,相当于 %C.%M(%F:%L) 的组合 , 包括类目名、发生的线程,以及在代码中的行数。举例: Testlog4.main(TestLog4.java:10) 。
8 ) %x: 输出和当前线程相关联的 NDC( 嵌套诊断环境 ), 尤其用到像 java servlets 这样的多客户多线程的应用中。
9 ) %%: 输出一个 "%" 字符。
10 ) %F: 输出日志消息产生时所在的文件名称。
11 ) %L: 输出代码中的行号。
12 ) %m: 输出代码中指定的消息 , 产生的日志具体信息。
13 ) %n: 输出一个回车换行符, Windows 平台为 "\r\n" , Unix 平台为 "\n" 输出日志信息换行。
可以在 % 与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如:
1)%20c :指定输出 category 的名称,最小的宽度是 20 ,如果 category 的名称小于 20 的话,默认的情况下右对齐。
2)%-20c: 指定输出 category 的名称,最小的宽度是 20 ,如果 category 的名称小于 20 的话, "-" 号指定左对齐。
3)%.30c: 指定输出 category 的名称,最大的宽度是 30 ,如果 category 的名称大于 30 的话,就会将左边多出的字符截掉,但小于 30 的话也不会有空格。
4)%20.30c: 如果 category 的名称小于 20 就补空格,并且右对齐,如果其名称长于 30 字符,就从左边交远销出的字符截掉。
来源: http://zhangjunhd.blog.51cto.com/113473/21014