Log4j相关配置以及在Tomcat中的使用

 

一、Log4j在Tomcat中的配置说明（tomcat6）

 

学习java中,从简单的开始.如果需要文中提到的文件可以找我要.

http://www.apache.org/dist/tomcat/tomcat-6/v6.0.29/bin/extras/tomcat-juli-adapters.jar

http://www.apache.org/dist/tomcat/tomcat-6/v6.0.29/bin/extras/tomcat-juli.jar

其中v6.0.29为tomcat的版本号，请根据具体版本进行修改后下载，以保证最后正常效果。

接下去再保证已经有log4j的情况下。

按照如下目录结构来放置:

######################################################################

tomcat6-------lib

                |       |--------tomcat-juli-adapters.jar

                |       |--------log4j.jar

                |       |--------log4j.properties

                | 

                |----bin

                         |--------tomcat-juli.jar

       |---------webapps

                        |-----xxx\WEB-INF

                                        |---classes

                                                   |----log4j.properties

######################################################################

 

最后把log4j.properties里的配置写好就可以了。

如：

######################################################################

# 设定logger的root level为INFO，指定的输出目的地（appender）为file,并在控制台输出stdout(Console)

log4j.rootLogger=INFO, file , stdout

# 设定stdout控制台 

log4j.appender.stdout=org.apache.log4j.ConsoleAppender

log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

log4j.appender.stdout.layout.ConversionPattern=[%d{HH:mm:ss}] %5p %c{2} \"%m\"%n

# 设定输出位置，此处设定tomcat目录的logs下,文件名为projectLogs.log。 

log4j.appender.file=org.apache.log4j.RollingFileAppender 

log4j.appender.file.File=${catalina.home}/logs/projectLogs.log

log4j.appender.file.MaxFileSize=1024KB

# 设定制定的file使用的PatternLayout. 

# 有关ConversionPattern中的转意字符的含义参考说明 

log4j.appender.file.layout=org.apache.log4j.PatternLayout 

log4j.appender.file.layout.ConversionPattern=%d{HH:mm:ss} %-5p [%C] (%F:%L) - %m%n

######################################################################

 

 

二、Apache Log4j配置说明

 

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字符，就从左边交远销出的字符截掉。

5.Apache Log介绍集

[1] Apache Log4j配置说明

[2] Apache Log4j使用实例

[3] Apache Commons-logging使用实例

[4] 如何自建appender扩展Log4j框架

6.参考资料

[1] 赵强，精通JSP编程，电子工业出版社

[2] Log4j配置过程

[url]http://hi.baidu.com/hunqiu/blog/item/7386ad6e[/url]59c5a4da81cb4a31.html

 

 ------------------------------------------------------------------------------------------------------------------------

 

一、 实现分模块,输出到不同的日志文件,  以下是log4j.properties的实现  

[java]  view plain copy

 

1.     
2. log4j.appender.file=org.apache.log4j.DailyRollingFileAppender     
3. log4j.appender.file.file=src\\log\\all.log     
4. log4j.appender.file.DatePattern='.'yyyy-MM-dd     
5. log4j.appender.file.layout=org.apache.log4j.PatternLayout     
6. log4j.appender.file.layout.ConversionPattern=[%-5p]   %d{yyyy-MM-dd   HH:mm:ss,SSS}  method:%l%n%m%n     
7. log4j.rootLogger=debug，file      
8.     
9. log4j.appender.usermanagerfile=org.apache.log4j.DailyRollingFileAppender     
10. log4j.appender.usermanagerfile.file=src\\log\\usermanager.log     
11. log4j.appender.usermanagerfile.DatePattern='.'yyyy-MM-dd     
12. log4j.appender.usermanagerfile.layout=org.apache.log4j.PatternLayout     
13. log4j.appender.usermanagerfile.layout.ConversionPattern=[%-5p]   %d{yyyy-MM-dd   HH:mm:ss,SSS}   method:%l%n%m%n     
14. log4j.logger.userManager   =   info,   usermanagerfile      

 

调试方法：

[java]  view plain copy

 

1. public   static   void   main(String[]   args)throws   Exception   {     
2.         
3.     Log   logger   =   LogFactory.getLog("file");     
4.     Log   logger   =   LogFactory.getLog("usermanager");     
5.       
6.   }     

二、log4j日志分级别输出到不同文件
 配置文件 

[java]  view plain copy

 

1. #log4j.rootLogger=info,stdoutdebug,error   
2. log4j.appender.stdout=org.apache.log4j.ConsoleAppender   
3. log4j.appender.stdout.layout=org.apache.log4j.PatternLayout   
4. log4j.appender.stdout.layout.ConversionPattern=[%-5p] [%d{HH:mm:ss}] %c - %m%n   
5.   
6. log4j.logger.info=info   
7. log4j.appender.info=org.apache.log4j.DailyRollingFileAppender   
8. log4j.appender.info.layout=org.apache.log4j.PatternLayout   
9. log4j.appender.info.layout.ConversionPattern=[%-5p] [%d{HH:mm:ss}] %c - %m%n   
10. log4j.appender.info.datePattern='.'yyyy-MM-dd   
11. log4j.appender.info.Threshold = INFO   
12. log4j.appender.info.append=true   
13. log4j.appender.info.File=${catalina.home}/logs/log4j/info.log   
14.   
15. log4j.logger.debug=debug   
16. log4j.appender.debug=org.apache.log4j.DailyRollingFileAppender   
17. log4j.appender.debug.layout=org.apache.log4j.PatternLayout   
18. log4j.appender.debug.layout.ConversionPattern=[%-5p] [%d{HH:mm:ss}] %c - %m%n   
19. log4j.appender.debug.datePattern='.'yyyy-MM-dd   
20. log4j.appender.debug.Threshold = DEBUG   
21. log4j.appender.debug.append=true   
22. log4j.appender.debug.File=${catalina.home}/logs/log4j/debug.log   
23.   
24. log4j.logger.warn=warn   
25. log4j.appender.warn=org.apache.log4j.DailyRollingFileAppender   
26. log4j.appender.warn.layout=org.apache.log4j.PatternLayout   
27. log4j.appender.warn.layout.ConversionPattern=[%-5p] [%d{HH:mm:ss}] %c - %m%n   
28. log4j.appender.warn.datePattern='.'yyyy-MM-dd   
29. log4j.appender.warn.Threshold = DEBUG   
30. log4j.appender.warn.append=true   
31. log4j.appender.warn.File=${catalina.home}/logs/log4j/warn.log   
32.   
33. log4j.logger.error=error   
34. log4j.appender.error=org.apache.log4j.DailyRollingFileAppender   
35. log4j.appender.error.layout=org.apache.log4j.PatternLayout   
36. log4j.appender.error.layout.ConversionPattern=[%-5p] [%d{HH:mm:ss}] %c - %m%n   
37. log4j.appender.error.datePattern='.'yyyy-MM-dd   
38. log4j.appender.error.Threshold = ERROR   
39. log4j.appender.error.append=true   
40. log4j.appender.error.File=$${catalina.home}/logs/log4j/error.log   

 

ConversionPattern设置输出格式的参数说明：

 %p: 输出日志信息优先级，即DEBUG，INFO，WARN，ERROR，FATAL,

 %d: 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出类似：2011年08月30日 15：00：00，921

%r: 输出自应用启动到输出该log信息耗费的毫秒数

%c: 输出日志信息所属的类目，通常就是所在类的全名

%t: 输出产生该日志事件的线程名

%l: 输出日志事件的发生位置，相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java:10)

%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。

%%: 输出一个”%”字符 %F: 输出日志消息产生时所在的文件名称 %L: 输出代码中的行号 %m: 输出代码中指定的消息,产生的日志具体信息

%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字符，就从左边交远销出的字符截掉。

 

三、log4j日志级别介绍

log4j把日志分为ALL、TRACE&（跟踪）、DEBUG（调试）、INFO（信息）、WARNING（警告）、ERROR（错误）、FITAL（致命）、OFF等几个级别，级别依次升高。级别高的Level会屏蔽级别低的信息。

 

注意：

在程序中使用Log4j之前，首先要将commons-logging.jar和logging-log4j-1.2.9.jar导入到classpath中，并将log4j.properties放于src根目录中。