原文链接:http://blog.csdn.net/sbfivwsll/article/details/7897719
log4j简介:
Log4j是Apache的一个开放源代码项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI组件、甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等;我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是,这些可以通过一个配置文件来灵活地进行配置,而不需要修改应用的代码。
log4j定义配置文件
日志信息的优先级,从高到低有:OFF (关闭),FATAL (致命),ERROR(错误) ,WARN(警告) ,INFO(信息) ,DEBUG(调试) ,ALL(打开所有的日志,我的理解与DEBUG级别好像没有什么区别得)。
Log4j建议只使用FATAL ,ERROR ,WARN ,INFO ,DEBUG这五个级别。
Log4j的配置文件支持两种方式:properties与xml方式,这两种方法写法不一样,但是所表示的意义都是一样的。
| Properties配置 | Xml配置 |
配置文件加载方式 | org.apache.log4j.PropertyConfigurator.configure* | org.apache.log4j.xml.DOMConfigurator.configureAndWatch |
日志名称的配置及输出方式 | #配置以log4j.apaender开头,后边跟上配置的名字,等号后边是日志的输出类(即日志的输出方式),将在后边介绍日志的输出类。 log4j.appender.logName1=org.apache.log4j.ConsoleAppender log4j.appender.logName1.option1=XXX ... log4j.appender.logName1.optionN=XXX | <?xmlversion="1.0"encoding="UTF-8"?> <!DOCTYPElog4j:configurationPUBLIC"-//APACHE//DTD LOG4J 1.2//EN""log4j.dtd"> <log4j:configuration> <!-- name为配置的名字,class为日志的输出类(即日志的输出方式) --> <appender name="logName1" class="org.apache.log4j.ConsoleAppender"> <param name="option1" value="XXX"/> ... <param name="optionN" value="XXX"/> </appender> </log4j:configuration> 外边的xml根节点都是固定的形式,log4j的所有配置都写在log4j:configuartion根节点的里边,后边的将不再写该根节点配置信息。 |
日志的输出方式常用的有以下几种: org.apache.log4j.ConsoleAppender ----控制台 org.apache.log4j.FileAppender ----指定的文件中 org.apache.log4j.DailyRollingFileAppender ----按天生成指定的文件。 org.apache.log4j.RollingFileAppender ----按配置的文件大小生记录到指定的文件中(文件到达一定的大小,自动备份,新建一份) 各种输出方式的选项如下: 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: 指定可以产生的滚动文件的最大数 |
日志的布局方式 | log4j.appender.appenderName.layout=packages.layoutClass log4j.appender.f.layout.ConversionPattern=%d %r %l %t [%p] - %m%n | <appendername="fileLog"class="org.apache.log4j.DailyRollingFileAppender"> <paramname="file"value="logs/a.log"/> <paramname="threshold"value="warm"/> <layout class="org.apache.log4j.PatternLayout"> <param name="ConversionPattern" value="%d %r %l %t [%p] - %m%n"/> </layout> </appender> |
Log4j提供的layout常用的有以下几种: org.apache.log4j.HTMLLayout,以HTML表格形式布局 org.apache.log4j.PatternLayout,可以灵活地指定布局模式 org.apache.log4j.SimpleLayout,包含日志信息的级别和信息字符串 org.apache.log4j.TTCCLayout,包含日志产生的时间、线程、类别等等信息 例如: log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout 配置格式化信息,其语法为 : log4j.appender.appenderName.layout.ConversionPattern= XXX XXX XXX log4j提供的打印参数如下: -X号: 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字符,就从左边交远销出的字符截掉。 例如: log4j.appender. CONSOLE.layout.ConversionPattern=%d{yyyyMMdd-HH:mm:ss} %t %c %m%n |
根配置方式 | #配置log4j根节点信息,第一个是日志输出级别,可以根据上边的几个日志的优先级来设置修改;后边是该根节点使用的日志配置名字,可以配置多个,以逗号分隔; #这里可能会看到rootCategory,它与rootLogger是相等的,前者是以前老版本的写法,后者是新版本的写法 log4j.rootLogger=debug[,logName1[,logName2]...] | <root> <level value="warn"/><!--日志级别,原则同左边 --> <appender-ref ref="logName1"/> <appender-ref ref="logName2"/><!--这里可以配置多个引用 --> </root> |