随笔-314  评论-209  文章-0  trackbacks-0
系统日志分类别输出至日志文件[Log4j应用]
 在项目的开发过程中，系统对日志的要求很细，而且要求分类清楚。所以还是采用了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

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


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

log4j.xml
view plaincopy to clipboardprint?
  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 阅读(3986) 评论(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
  回复  更多评论
  

只有注册用户登录后才能发表评论。
网站导航:
 
Powered by: 博客园 模板提供：沪江博客 Copyright ©2024 xzc