Tomcat 使用 Log4j 输出详细系统日志信息,快速诊断启动故障

Tomcat 启动时的系统日志默认是由 JdkLog14Logger 打印出来的,如

2008-7-7 11:19:34 org.apache.catalina.core.StandardEngine start
信息: Starting Servlet Engine: Apache Tomcat/5.0.28
2008-7-7 11:19:34 org.apache.catalina.core.StandardHost start
信息: XML validation disabled
2008-7-7 11:19:34 org.apache.catalina.core.StandardHost getDeployer
信息: Create Host deployer for direct deployment ( non-jmx )

那我们能不能用 Log4J 来输出这种系统日志呢?我们知道像 Apache 那样的大部分开源框架、组件都是用通用日志组件 (commons-logging) 来输出日志的,因此如果把 commons-logging 和 log4j 搭配使用就能输出十分详尽的日志信息。

尤其是碰到 Tomcat 几乎能令人抓狂的 Error filterStart ,如控制台下得到如下信息:

2007-3-13 17:43:46 org.apache.catalina.core.StandardContext start
严重: Error filterStart
2007-3-13 17:43:46 org.apache.catalina.core.StandardContext start
严重: Context startup failed due to previous errors

而茫然不知所措时,免不了会胡乱猜测,更容易使你的注意力集中在所有的 filter 本身上,其实有些冤枉 filter 了。至少网上针对这个问题有许多不明确的解,有配置文件问题的,有缺类少包的问题等,不一定能和你的实际问题对上号。

其实大可不必受如此之周折,解铃仍需寄铃人吗,由 Tomcat 给你落下的结,当然要 Tomcat 告诉你是怎么回事。很多人在自己的应用中会安放一个日志文件,却可能忽略掉 Tomcat 自身的日志文件,在 logs 目录下的 localhost_log.yyyy-MM-dd.txt 就事,记住只要碰到关于 Tomcat 本身启动的问题,查看其中当前的日志信息的话,问题就会坦荡荡荡显露在你的前面,基本也就能迎刃而解了。

前面讲过,commons-logging+log4j 可以输出极详尽的信息,那现在就来说说如何配置。很多人开发过程中是通过 MyEclipse 来启动 Tomcat 的,所有这里包括两种方法,分别介绍如下:

1. MyEclipse 启动 Tomcat 使用 Log4j 输出日志信息的配置

在 MyEclipse 的 Tomcat 服务器配置中的 Prepend to classpath 或者 Append to classpath 中加入

commons-logging-1.1.jar
log4j-1.2.13.jar
以及 log4j.properties 所在目录,如 D:\Tomcat\Tomcat 5.0.28-Test\bin

如图:

我是把 commons-logging-1.1.jar、log4j-1.2.13.jar 和 log4j.properties 都放在 %TOMCAT_HOME%\bin 目录下的,当然你也可以放在别处。

完了之后,通过 MyEclipse 启动 Tomcat 时就能看到让你眼花花的日志滚屏,请根据实际需要在log4j.properties 中屏蔽你不想关注的内容。所以像这种日志信息最好是记录在文件中,屏幕的缓冲区是有限且耗内存的。真正需要的时候你就可以从这个日志文件里读懂 Tomcat 的启动全过程。

如果你明白 commons-logging.properties 的功用,你也可以把这个文件放在与 log4j.properties 所在的目录下,可在其中指定其他 log 实现类,详见 commons-logging.properties 文件的内容。

2. startup.bat 启动 Tomcat 使用 Log4j 输出日志信息的配置

按前面推荐的做法,把 commons-logging-1.1.jar、log4j-1.2.13.jar 和 log4j.properties 都放在 %TOMCAT_HOME%\bin 目录下,然后修改 catalina.bat 文件,找到

set CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\bin\bootstrap.jar

行,在其后附上这两个包和 log4j.properties 所在目录到 classpath 上,修改后就是:

set CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\bin\bootstrap.jar;%CATALINA_HOME%\bin\commons-logging-1.1.jar;%CATALINA_HOME%\bin\log4j-1.2.13.jar;%CATALINA_HOME%\bin

保存,通过 startup.bat 启动就会用 log4j 来输出启动日志了,其他平台下的 Tomcat,请参照平台特性修改 catalina.sh 吧。

同样,你也可以应用 commons-logging.properties 指定其他的 log 实现,因为 Log4j 是它的默认实现,所以可省去。

用 Log4j 输出的启动日志形式如下:

15:36:37,859 org.apache.catalina.startup.Embedded.initNaming(Embedded.java:922) - Setting naming prefix=org.apache.naming
15:36:38,046 org.apache.catalina.startup.Catalina.createStartDigester(Catalina.java:350) - Digester for server.xml created 171
15:36:38,218 org.apache.catalina.core.NamingContextListener.<init>(NamingContextListener.java:83) - new NamingContextListener

许多你希望深入了解的内部细节都可以通过这样一份日志追踪到。

附上这两个属性文件的:log4j.properties 和 commons-logging.properties。

log4j.properties

commons-logging.properties

本文链接 https://yanbin.blog/tomcat-log4j-system-logs/, 来自 隔叶黄莺 Yanbin Blog

[版权声明] Creative Commons License 本文采用 署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0) 进行许可。

Subscribe
Notify of
guest

1 Comment
Inline Feedbacks
View all comments
Werther
15 years ago

Thanks you!