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)