Log4j (2010-07-18 22:31:17)

转载▼

标签： 

杂谈

分类： 工作随笔

一、 Log4j的架构 
Log4j系统的三大板块：日志写入器、日志输出终端、日志布局模式。 
 
Logger类是日志包的核心，Logger的名称是大小写敏感的，并且名称之间有继承关系。子名由父名做前缀，用点号“.”分隔，如x.y是x.y.z的父亲Logger。 

Logger系统中有个根logger，是所有logger的祖先，它总是存在的，并且不可以通过名字获取，可以通过Logger.getRootLogger()来获取。获取Logger对象的方法很多，可以参考API文档，在某对象中，用该对象所属的类作为参数，调用Logger.getLogger(Class clazz)以获取logger对象被认为是目前所知最理智的命名logger方法。 
二、 Log4j的日志级别（Level） 
每个logger都有一个日志级别，用来控制日志的输出。未分配级别的logger将自动继承它最近的父logger的日志级别。Logger的由低到高级别如下： 
ALL<DEBUG<INFO<WARN<ERROR<FATAL<OFF 
三、 Log4j的输出终端（Appender接口） 
Log4j提供了以下几个实现： 

1. org.apache.log4j.ConsoleAppender(控制台)   
2. org.apache.log4j.FileAppender(文件)   
3. org.apache.log4j.DailyRollingFileAppender(每天都产生一个日志文件)   
4. org.apache.log4j.RollingFileAppender(文件大小达到指定尺寸时产生一个新的日志文件，文件名称上会自动添加数字序号。)   
5. org.apache.log4j.WriterAppender(将日志信息以流的格式发送到任意指定的地方)  

默认情况下，子logger将继承父logger的所有appenders。 
四、 Log4j的输出布局模式（Layout接口） 
Log4j提供Layout有以下几种： 

1. org.apache.log4j.HTMLLayout（以HTML表格形式布局）   
2. org.apache.log4j.PatternLayout（可以灵活地指定布局模式）   
3. org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串）   
4. org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等信息）  

Log4j采用类似C语言中的printf函数的打印格式格式化日志信息。打印参数如下： 

1. %m：输出代码中指定的消息。   
2. %p：输出优先级。   
3. %r：输入自应用启动到输出该log信息耗费的毫秒数。   
4. %c：输出所属的类目，通常就是所在类的全名。   
5. %t：输出产生该日志线程的线程名。   
6. %n：输出一个回车换行符。Windows平台为“\r\n”，UNIX为“\n”。   
7. %d：输出日志时间点的日期或时间，默认格式为ISO8601，推荐使用“%d{ABSOLUTE}”，这个输出格式形如：“2007-05-07 18:23:23,500”，符合中国人习惯。   
8. %l：输出日志事件发生的位置，包括类名、线程名，以及所在代码的行数。  

五、 Log4j的配置 

在实际使用中，Log4j一般是通过配置文件配置使用的。配置文件有两种，Java properties和XML文件。一般都选用properties文件来配置，因为简洁易读。下面只介绍Java properties的配置方式。 
对Log4j的配置就是对rootLogger和子Logger的配置。主要的配置项为：rootLogger、输出终端、输出布局模式，所有的配置项都必须以log4j开头。 
配置文件的示例 

1. ##Log4J的配置之简单使它遍及于越来越多的应用中了   
2.   
3. ##Log4J配置文件实现了输出到控制台、文件、回滚文件、发送日志邮件、输出到数据库日志表、自定义标签等全套功能。择其一二使用就够用了。   
4.   
5. ##此文件（log4j.properties）内容来自网络。   
6. log4j.rootLogger = DEBUG, CONSOLE,A1   
7. log4j.addivity.org.apache = true  
8.   
9. # 应用于控制台   
10. log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender   
11. log4j.appender.Threshold = DEBUG   
12. log4j.appender.CONSOLE.Target = System.out   
13. log4j.appender.CONSOLE.layout = org.apache.log4j.PatternLayout   
14. log4j.appender.CONSOLE.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n   
15. #log4j.appender.CONSOLE.layout.ConversionPattern = [start] % d {DATE} [DATE] % n % p[PRIORITY] % n % x[NDC] % n % t[THREAD] n % c[CATEGORY] % n % m[MESSAGE] % n % n   
16.   
17. #应用于文件   
18. log4j.appender.FILE = org.apache.log4j.FileAppender   
19. log4j.appender.FILE.File = file.log   
20. log4j.appender.FILE.Append = false  
21. log4j.appender.FILE.layout = org.apache.log4j.PatternLayout   
22. log4j.appender.FILE.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n   
23. # Use this layout for LogFactor 5 analysis   
24.   
25. # 应用于文件回滚   
26. log4j.appender.ROLLING_FILE = org.apache.log4j.RollingFileAppender   
27. log4j.appender.ROLLING_FILE.Threshold = ERROR   
28. log4j.appender.ROLLING_FILE.File = rolling.log   
29. log4j.appender.ROLLING_FILE.Append = true  
30. log4j.appender.ROLLING_FILE.MaxFileSize = 10KB   
31. log4j.appender.ROLLING_FILE.MaxBackupIndex = 1  
32. log4j.appender.ROLLING_FILE.layout = org.apache.log4j.PatternLayout   
33. log4j.appender.ROLLING_FILE.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n   
34.   
35. #应用于socket   
36. log4j.appender.SOCKET = org.apache.log4j.RollingFileAppender   
37. log4j.appender.SOCKET.RemoteHost = localhost   
38. log4j.appender.SOCKET.Port = 5001  
39. log4j.appender.SOCKET.LocationInfo = true  
40. # Set up for Log Facter 5  
41. log4j.appender.SOCKET.layout = org.apache.log4j.PatternLayout   
42. log4j.appender.SOCET.layout.ConversionPattern = [start] % d {DATE} [DATE] % n % p[PRIORITY] % n % x[NDC] % n % t[THREAD] % n % c[CATEGORY] % n % m[MESSAGE] % n % n   
43.   
44. # Log Factor 5 Appender   
45. log4j.appender.LF5_APPENDER = org.apache.log4j.lf5.LF5Appender   
46. log4j.appender.LF5_APPENDER.MaxNumberOfRecords = 2000  
47.   
48. # 发送日志给邮件   
49. log4j.appender.MAIL = org.apache.log4j.net.SMTPAppender   
50. log4j.appender.MAIL.Threshold = FATA   
51. log4j.appender.MAIL.BufferSize = 10  
52. log4j.appender.MAIL.From = [e-mail]   
53. log4j.appender.MAIL.SMTPHost = www.wusetu.com   
54. log4j.appender.MAIL.Subject = Log4J Message   
55. log4j.appender.MAIL.To = [e-mail]   
56. log4j.appender.MAIL.layout = org.apache.log4j.PatternLayout   
57. log4j.appender.MAIL.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n   
58.   
59.   
60. # 用于数据库   
61. log4j.appender.DATABASE = org.apache.log4j.jdbc.JDBCAppender   
62. log4j.appender.DATABASE.URL = jdbc:mysql: // localhost:3306/test   
63. log4j.appender.DATABASE.driver = com.mysql.jdbc.Driver   
64. log4j.appender.DATABASE.user = root   
65. log4j.appender.DATABASE.password =   
66. log4j.appender.DATABASE.sql = INSERT INTO LOG4J (Message) VALUES ( ' [framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n ' )   
67. log4j.appender.DATABASE.layout = org.apache.log4j.PatternLayout   
68. log4j.appender.DATABASE.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n   
69. log4j.appender.A1 = org.apache.log4j.DailyRollingFileAppender   
70. log4j.appender.A1.File = SampleMessages.log4j   
71. log4j.appender.A1.DatePattern = yyyyMMdd - HH ' .log4j '  
72. log4j.appender.A1.layout = org.apache.log4j.xml.XMLLayout   
73.   
74. #自定义Appender   
75. log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender   
76. log4j.appender.im.host = mail.cybercorlin.net   
77. log4j.appender.im.username = username   
78. log4j.appender.im.password = password   
79. log4j.appender.im.recipient = [e-mail]   
80. log4j.appender.im.layout = org.apache.log4j.PatternLayout   
81. log4j.appender.im.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n   
82.   
83. # 结束  

If you come across a problem like this when starting Tomcat:

log4j:WARN No appenders could be found for logger (org.apache.struts.util.PropertyMessageResources).
log4j:WARN Please initialize the log4j system properly.

Solution:

To confiigure tomcat to use log4j, do the following : 

1) add your log4j-config.xml file to <tomcat_home>/conf directory
2) add the following property definition to <tomcat_home>/bin/catalina.bat