jboss日志输出设置
如果不进行优化配置,JBOSS下的项目查错将非常麻烦,在JBOSS4.2.2GA版本中,默认将所有的DEBUG信息都输了个遍,刚运行JBOSS,Server.log的日志就差不多1M了,再停掉JBOSS,什么正事都没做,都己经生成很多LOG了。
LOG太多确实一点用也没有,本来这些LOG最大的功能是方便查错的,但如果生成N行的LOG,从中找到你想要的,我还不如把程序检查一遍算了!因此,在不同的应用场合下,配置好你的LOG,才能让项目更加顺利地进行哦!
本文针对的是JBOSS4的LOG4J配置,其它的请参阅相应的文章。
JBOSS4的LOG4J配置默认放在Deploy目录的conf/目录下,比如现在我将ear放到jboss的default目录下,那么log4j的文件就是jboss/server/default/conf/jboss-log4j.xml,找到它,我们再分析一下它里面的内容吧。
首先是第一段,一个FILE的appender,代码如下
Xml代码
1.<!--Atime/datebasedrollingappender-->
2.<appendername="FILE"class="org.jboss.logging.appender.DailyRollingFileAppender">
3.<errorHandlerclass="org.jboss.logging.util.OnlyOnceErrorHandler"/>
4.<paramname="File"value="${jboss.server.log.dir}/server.log"/>
5.<paramname="Append"value="false"/>
6.
7.<!--Rolloveratmidnighteachday-->
8.<paramname="DatePattern"value="'.'yyyy-MM-dd"/>
9.
10.<!--Rolloveratthetopofeachhour
11.<paramname="DatePattern"value="'.'yyyy-MM-dd-HH"/>
12.-->
13.
14.<layoutclass="org.apache.log4j.PatternLayout">
15.<!--Thedefaultpattern:DatePriority[Category]Message/n-->
16.<paramname="ConversionPattern"value="%d%-5p[%c]%m%n"/>
17.
18.<!--Thefullpattern:DateMSPriority[Category](Thread:NDC)Message/n
19.<paramname="ConversionPattern"value="%d%-5r%-5p[%c](%t:%x)%m%n"/>
20.-->
21.</layout>
22.</appender>
上面这一段就是JBOSS默认输出到log/server.log文件的基本配置,它的name是FILE,这是自己定的,在其它地方会用这引name引用到它,然后appender的类型是DailyRollingFileAppender,意思是每天生成一个新的server.log文件,此时有人就会问,怎么每天都是server.log,那么昨天的岂不覆盖掉了?别担心,这种事情开发者早就想到了,它里面会有一些参数去设置它,自动让你前一天的log改其它名,当然appender的类型还有好几种,本文最后面有参考,根据你的项目的需要去设置它。
中间第一个参数是log文件的输出地址,大家明白的了,改动一下就行了。
第二个参数<paramname="Append"value="false"/>,意思是运行jboss时,要不要覆盖之前的log,这在开发调试时很有用,你设成false后,每次你重新运行jboss,新生成的log都覆盖了旧的,这样找起来比较方便,也不用自己专门去删除它,但如果是正式使用了,可以根据需要将成设成true,这样所有的日志都会被保存起来了,隔一段时间,你就可以找到之前任一时候的log信息哦。
上面讲到了有一些参数设置文件换前一天的log的文件名的,大家可以注意到配置的中间有个DatePattern,这个就是设置你前一天的log将会被改成什么名,它在每天晚上的午夜进行,很自动吧,你看它后面的'.'yyyy-MM-dd,你就会知道前一天的log的文件名将会被换成什么样的了!这里不进行填鸭!它还可以表现得更狠一下,每小时生成一个log怎么样,你想怎么样就怎么样,学学去配它吧。
再往下,有一个PatternLayout,这个是输出文本的样式,这个是文本的,不过它还有得换哦,可以换成网页形式的日志(看起来会爽点),还有另外几个,大家有空可以玩玩,不过这个PatternLayout是最常用,也是最专业的,想成为专业人士,就用它吧!呵呵,开玩笑的,其它几个也很专业,甚至更专业!
刚接触log4j的人会不太理解PatternLayout的作用,不过你用过之后,就知它是多么强悍的了,日志显示的形式随你心意改变,可以输出很多信息,如类名,类行号,详细时间,日志正文,还有日志级别等。
再往下有个ConversionPattern的参数,它是配置log的显示格式的,它的详细格式使用在本文后面会贴出,有需要就去看看,不过用它默认的都挺好的了。
好了,之前介绍了一个默认的FILE Appender,还有一个CONSOLE的Appender,不用介绍了吧,就是显示在jboss控制台的日志样式,在此我们就不详谈了。
除了这两个默认的,还可以自定义Appender哦,比如你项目有不同类型的日志输出到不同的log日志中,或者你不想改动默认的log配置,另找高明,反正就是很个性化啦,生成多少个不同的log都行!
在这里我拷贝了一个FILE的的appender,然后作了小小改动,就可以生成我自定义的log了,代码如下
Xml代码
1.<!--Atime/datebasedrollingappender-->
2.<appendername="MYAPPENDER"class="org.jboss.logging.appender.DailyRollingFileAppender">
3.<errorHandlerclass="org.jboss.logging.util.OnlyOnceErrorHandler"/>
4.<paramname="File"value="${jboss.server.log.dir}/mylog.log"/>
5.<paramname="Append"value="false"/>
6.
7.<!--Rolloveratmidnighteachday-->
8.<paramname="DatePattern"value="'.'yyyy-MM-dd"/>
9.
10.<!--Rolloveratthetopofeachhour
11.<paramname="DatePattern"value="'.'yyyy-MM-dd-HH"/>
12.-->
13.
14.<layoutclass="org.apache.log4j.PatternLayout">
15.<!--Thedefaultpattern:DatePriority[Category]Message/n-->
16.<!--<paramname="ConversionPattern"value="%d%-5p[%c]%m%n"/>-->
17.
18.<!--Thefullpattern:DateMSPriority[Category](Thread:NDC)Message/n-->
19.<paramname="ConversionPattern"value="%d%-5r%-5p[%c](%t:%x)%m%n"/>
20.
21.</layout>
22.</appender>
它将会在log目录生成一个mylog.log文件,不过有一点需要注意,在没有其它代码引用这些appender之前,它什么也不会干的,怎么引用还得往下看。
在jboss-log4j.xml文件里靠下的地方,有很多下面这类代码
Xml代码
1.<!--Limittheorg.jbosscategorytoINFOasitsDEBUGisverbose-->
2.<categoryname="org.jboss">
3.<priorityvalue="INFO"/>
4.</category>
它是干嘛用的?它就是log4j的强悍之一,它检测到是org.jboss输出的信息的话,就限制DEBUG的信息输出,之前说过jboss的log信息超多,因为它默认将所有Debug信息都输出来了,这些jboss的debug信息对于我们这些平民百姓来说,没啥用,你加上我上面这一段,所有的JBOSS DEBUG信息都不会输出来的了,试试吧,其它的category你怎么改?讲一个我的经验给你们吧,你运行过jboss,然后停掉它,打开server.log,会看到很多的log信息,像下面这种
2008-10-1816:00:59,203DEBUG[org.apache.resource.deployment.RARDeployment]Requiredlicensetermsexist,viewMETA-INF/ra.xmlin.../deploy/jboss-ha-local-jdbc.rar
看上面粗体部份,它是由类org.apache.resource.deployment.RARDeployment产生的log,你如果看到很多,你觉得没用,又或者你看到是DEBUG信息,你也不想要,就写一段category吧,将类的前面部分截取一段,写进category的name属性里,比如上面这类log,你不想看到它,你就这样写
Xml代码
1.<!--Limittheorg.apachecategorytoINFOasitsDEBUGisverbose-->
2.<categoryname="org.apache">
3.<priorityvalue="INFO"/>
4.</category>
这样所有org.apache属下的类的debug log都不会再输出来了,你还可以更狠一点,写下面这段
Xml代码
1.<categoryname="org.apache">
2.<priorityvalue="ERROR"/>
3.</category>
这样org.apache下的普通INFO信息也不会输出了,只有错误的信息才会被输出!
至于其它的log信息,你就运行多几次jboss,每次根据server.log,找到你不想要的,再加多一些category,这样你的server.log就会变得非常精简的了,试试吧,一劳永逸,以后log就有得控制了,调试查错也更方便了。
到了这里,事情还没完呢,最后一点了。
之前我们自定义了一个appender,我们要用它来输出自己的项目的log,我们只是定义好了这个appender,还没用上它,它暂时还是不会起作用的(它会生成文件,但是没log往里面写),项目的log,还是只会在server.log里出现,不会写进你自定义的log里。下面我们干最后一点,完成所有工作。
写多一个category,name填上自己项目对应的,比如com.mycompany,然后在<priorityvalue="xxx"/>后面加多一行<appender-refref="MYAPPENDER"/>,如下
Xml代码
1.<!--SelfDefineAppender-->
2.<categoryname="com.mycompany">
3.<priorityvalue="INFO"/>
4.<appender-refref="MYAPPENDER"/>
5.</category>
配置好了,下面贴一段代码中使用log的代码中,怎么用不讲了,很简单的,
Java代码
1.publicclassTestLog4j
2.{
3.publicstaticvoidmain(String[]args)
4.{
5.Loggerlogger=Logger.getLogger(TestLog4j.class);
6.logger.debug("debug");
7.logger.error("error");
8.logger.info("info");
9.}
10.}
下面,贴出一些常用的配置参考文档
1\日志输出级别,共有5级:
FATAL0
ERROR3
WARN4
INFO6
DEBUG7
2\Log4j提供的appender有以下几种:
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
3\Log4j提供的layout有以下几种:
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
4\Log4J采用类似C语言中的printf函数的打印格式格式化日志信息,如下:
%m输出代码中指定的消息
%p输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
%r输出自应用启动到输出该log信息耗费的毫秒数
%c输出所属的类目,通常就是所在类的全名
%t输出产生该日志事件的线程名
%n输出一个回车换行符,Windows平台为“/r/n”,Unix平台为“/n”
%d输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyyMMMddHH:mm:ss,SSS},输出类似:2002年10月18日22:10:28,921
%l输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java:10)