随笔-314  评论-209  文章-0  trackbacks-0
 在项目的开发过程中,系统对日志的要求很细,而且要求分类清楚。所以还是采用了Log4J。

      在强调可重用组件开发的今天,除了自己从头到尾开发一个可重用的日志操作类外,Apache为我们提供了一个强有力的日志操作包-Log4j。

      Log4j是Apache的一个开放源代码项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI组件、甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等;我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是,这些可以通过一个配置文件来灵活地进行配置,而不需要修改应用的代码。

      此外,通过Log4j其他语言接口,您可以在C、php、C++、.Net、PL/SQL程序中使用Log4j,其语法和用法与在Java程序中一样,使得多语言分布式系统得到一个统一一致的日志组件模块。而且,通过使用各种第三方扩展,您可以很方便地将Log4j集成到J2EE、JINI甚至是SNMP应用中。

      Log4j配置文件详细说明(*.properties和*.xml)
      
属性文件Properties

properties属性文件

编号 配置项 配置项描述 示例
1 log4j.threshold 阈值项 log4j.threshold = error
2 log4j.rootLogger 根日志属性项 log4j.rootLogger = info,stdout1,stdout2
3 log4j.category. 子日志属性项(旧) log4j.category.com.eos = NULL,stdout1
4 log4j.logger. 子日志属性项(新) log4j.logger.com.eos.log = debug,stdout2
5 log4j.additivity. appender是否继承设置 log4j.additivity.com.eos = false
6 log4j.appender. 输出目的地定义项 log4j.appender.stdout2 = org.apache.log4j.ConsoleAppender
7 log4j.appender.A.layout 输出格式定义项 log4j.appender.stdout2.layout = org.apache.log4j.PatternLayout

xml文件

编号 配置项 配置项描述 示例
1 threshold 阈值项
2 root 根日志属性项
    
    
  

3 priority 级别项(旧)
4 level 级别项(新)
5 category 子日志属性项(旧)
6 logger 子日志属性项(新)
7 appender-ref 输出端控制项
8 additivity appender是否继承设置
9 appender 输出目的地定义项
10 layout 输出格式定义项

详细说明(只针对Log4j常用的,用户可以自定义)Appender
Appender继承关系
Appender基本种类
org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
· ConsoleAppender选项
Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
Target=System.err:默认情况下是:System.out,指定输出控制台
· FileAppender 选项
Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt:指定消息输出到mylog.txt文件。
Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
· DailyRollingFileAppender 选项
Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt:指定消息输出到mylog.txt文件。
Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
DatePattern='.'yyyy-ww:每周滚动一次文件,即每周产生一个新的文件。当然也可以指定按月、周、
天、时和分。即对应的格式如下:
1)'.'yyyy-MM: 每月
2)'.'yyyy-ww: 每周
3)'.'yyyy-MM-dd: 每天
4)'.'yyyy-MM-dd-a: 每天两次
5)'.'yyyy-MM-dd-HH: 每小时
6)'.'yyyy-MM-dd-HH-mm: 每分钟
n 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:指定可以产生的滚动文件的最大数。

详细说明(只针对Log4j,用户可以自定义)Layout
Log4j的Layout基本种类
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
· HTMLLayout选项
LocationInfo=true:默认值是false,输出java文件名称和行号
Title=my app file: 默认值是 Log4J Log Messages.      
n PatternLayout 选项
log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
这里需要说明的就是日志信息格式中几个符号所代表的含义:

%X: 信息输出时左对齐;
%p: 输出日志信息优先级,即DEBUG,INFO,WARN,ERROR,FATAL,
%d: 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,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字符, 就从左边交远销出的字符截掉。
· XMLLayout 选项
LocationInfo=true:默认值是false,输出java文件和行号

日志配置文件内容范例  
log4j.properties

  1. log4j.rootLogger=DEBUG, CONSOLE    
  2. #DEBUG, CONSOLE,FILE,ROLLING_FILE,MAIL,DATABASE    
  3. #log4j.threshold=WARN
  4. log4j.logger.org.apache=INFO, FILE 
  5. log4j.additivity.org.apache=false    
  6.   
  7. ###################    
  8. # Console Appender    
  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=%d [%p] - %m%n    
  15.   
  16.   
  17. #####################    
  18. # File Appender    
  19. #####################    
  20. log4j.appender.FILE=org.apache.log4j.FileAppender    
  21. log4j.appender.FILE.File=file.log    
  22. log4j.appender.FILE.Append=false    
  23. log4j.appender.FILE.layout=org.apache.log4j.PatternLayout    
  24. log4j.appender.FILE.layout.ConversionPattern=%d [%p] - %m%n    
  25.   
  26.   
  27. ########################    
  28. # Rolling File    
  29. ########################    
  30. log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender    
  31. log4j.appender.ROLLING_FILE.Threshold=ERROR    
  32. log4j.appender.ROLLING_FILE.File=rolling.log    
  33. log4j.appender.ROLLING_FILE.Append=true    
  34. log4j.appender.ROLLING_FILE.MaxFileSize=10KB    
  35. log4j.appender.ROLLING_FILE.MaxBackupIndex=1    
  36. log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout    
  37. log4j.appender.ROLLING_FILE.layout.ConversionPattern=%d [%p] - %m%n    
  38.   
  39.   
  40. ####################    
  41. # Socket Appender    
  42. ####################    
  43. log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender    
  44. log4j.appender.SOCKET.RemoteHost=localhost    
  45. log4j.appender.SOCKET.Port=5001    
  46. log4j.appender.SOCKET.LocationInfo=true    
  47. # Set up for Log Facter 5    
  48. log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout    
  49. log4j.appender.SOCET.layout.ConversionPattern=%d [%p] - %m%n    
  50.   
  51.   
  52. ########################    
  53. # Log Factor 5 Appender    
  54. ########################    
  55. log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender    
  56. log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000    
  57.   
  58.   
  59. ########################    
  60. # SMTP Appender    
  61. #######################    
  62. log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender    
  63. log4j.appender.MAIL.Threshold=FATAL    
  64. log4j.appender.MAIL.BufferSize=10    
  65. log4j.appender.MAIL.From=wuyh@primeton.com    
  66. log4j.appender.MAIL.SMTPHost=mail.primeton.com    
  67. log4j.appender.MAIL.Subject=Log4J Message    
  68. log4j.appender.MAIL.To=test@primeton.com    
  69. log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout    
  70. log4j.appender.MAIL.layout.ConversionPattern=%d [%p] - %m%n    
  71.   
  72.   
  73. ########################    
  74. # JDBC Appender    
  75. #######################    
  76. log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender    
  77. log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test    
  78. log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver    
  79. log4j.appender.DATABASE.user=root    
  80. log4j.appender.DATABASE.password=    
  81. log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES (%d [%p] - %m%n)    
  82. log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout    
  83. log4j.appender.DATABASE.layout.ConversionPattern=%d [%p] - %m%n    
  84.   
  85.   
  86. log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender    
  87. log4j.appender.A1.File=SampleMessages.log4j    
  88. log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'    
  89. log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout    
  90.   
  91. ###################    
  92. #自定义Appender    
  93. ###################    
  94. log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender    
  95.   
  96. log4j.appender.im.host = mail.cybercorlin.net    
  97. log4j.appender.im.username = username    
  98. log4j.appender.im.password = password    
  99. log4j.appender.im.recipient = wuyh@primeton.com    
  100.   
  101. log4j.appender.im.layout=org.apache.log4j.PatternLayout    
  102. log4j.appender.im.layout.ConversionPattern =%d [%p] - %m%n   


#注意:在属性配置文件中,属性值的第一个一定是级别,输出端可有可无,以逗号分割。(而xml文件格式没有这种限制)

log4j.xml
  1. < xml version="1.0" encoding="UTF-8" >    
  2. <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">    
  3. <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" debug="false" threshold="null">    
  4.   
  5.   
  6. <appender class="org.apache.log4j.ConsoleAppender" name="CONSOLE">    
  7. <param name="Target" value="System.out"/>    
  8. <param name="Threshold" value="INFO"/>    
  9. <layout class="org.apache.log4j.PatternLayout">    
  10. <param name="ConversionPattern" value="%d [%p] - %m%n "/>    
  11. </layout>    
  12. <filter class="org.apache.log4j.varia.DenyAllFilter"/>    
  13. <errorHandler class="org.apache.log4j.varia. FallbackErrorHandler"/>    
  14. </appender>    
  15.   
  16. <appender class="org.apache.log4j.FileAppender" name="FILE">    
  17. <param name="File" value="file.log"/>    
  18. <param name="Append" value="false"/>    
  19. <param name="Threshold" value="INFO"/>    
  20. <layout class="org.apache.log4j.PatternLayout">    
  21. <param name="ConversionPattern" value="%d [%p] - %m%n "/>    
  22. </layout>    
  23. </appender>    
  24.   
  25. <appender class="org.apache.log4j.RollingFileAppender" name="ROLLING_FILE">    
  26. <param name="Threshold" value="INFO"/>    
  27. <param name="File" value="rolling.log"/>    
  28. <param name="Append" value="false"/>    
  29. <param name="MaxFileSize" value="10KB"/>    
  30. <param name="MaxBackupIndex" value="1"/>    
  31. <layout class="org.apache.log4j.PatternLayout">    
  32. <param name="ConversionPattern" value="%d [%p] - %m%n "/>    
  33. </layout>    
  34. </appender>    
  35.   
  36. <logger additivity="false" name="com.eos">    
  37. <level value="info"/>    
  38. <appender-ref ref="CONSOLE"/>    
  39. </logger>    
  40.   
  41. <category additivity="true" name="com.eos.log">    
  42. <priority value="warn"/>    
  43. </category>    
  44.   
  45. <root>    
  46. <priority value="info"/>    
  47. <appender-ref ref="CONSOLE"/>    
  48. </root>    
  49. </log4j:configuration>   

posted on 2008-05-21 10:35 xzc 阅读(3983) 评论(1)  编辑  收藏 所属分类: Log4j

评论:
# re: 系统日志分类别输出至日志文件[Log4j应用][未登录] 2008-06-13 20:06 | xzc
输出到文件 RollingFileAppender的扩展,可以提供一种日志的备份功能。
log4j.appender.R=org.apache.log4j.RollingFileAppender


日志文件的名称
log4j.appender.R.File=log4j.log
日志文件的大小
log4j.appender.R.MaxFileSize=100KB
保存一个备份文件
log4j.appender.R.MaxBackupIndex=1

log4j.appender.R.layout=org.apache.log4j.TTCCLayout

在文件后面继续写

log4j.appender.ROLLING_FILE.Append=true

设置配置文件的编码

log4j.appender.ROLLING_FILE.encoding=UTF-8
  回复  更多评论
  

只有注册用户登录后才能发表评论。


网站导航: