Tomcat 日志概述[通俗易懂]

大家好，又见面了，我是你们的朋友全栈君。1    Tomcat 日志概述

Tomcat 日志信息分为两类：

一是运行中的日志，它主要记录运行的一些信息，尤其是一些异常错误日志信息。

二是访问日志信息，它记录的访问的时间， IP ，访问的资料等相关信息。

2    Tomcat 日志配置

2.1 访问日志的配置

默认 tomcat 不记录访问日志，如下方法可以使 tomcat 记录访问日志

编辑 ${catalina}/conf/server.xml 文件 . 注 :${catalina} 是 tomcat 的安装目录

把以下的注释 (<!– –>) 去掉即可。

<!–

        <Valve className=”org.apache.catalina.valves.AccessLogValve”

         directory=”logs” prefix=”localhost_access_log.” suffix=”.txt”

         pattern=”common” resolveHosts=”false”/>

–>

2.2 配置 tomcat 写出更详细的日志

通过对 2.1 示例中 pattern 项的修改，可以改变日志输出的内容。

该项值可以为： common 与 combined ，这两个预先设置好的格式对应的日志输出内容如下：

common 的值： %h %l %u %t %r %s %b

combined 的值： %h %l %u %t %r %s %b %{Referer}i %{User-Agent}i

pattern 也可以根据需要自由组合 , 例如 pattern=”%h %l”

对于各 fields 字段的含义请参照 :

http://tomcat.apache.org/tomcat-6.0-doc/config/valve.html 中的 Access Log Valve 项

3    修改 Tomcat 运行日志的等级

3.1 日志类型与级别

Tomcat 日志分为下面５类：

catalina 、 localhost 、 manager 、 admin 、 host-manager

每类日志的级别分为如下 7 种：

SEVERE (highest value) > WARNING > INFO > CONFIG > FINE > FINER > FINEST (lowest value)

3.2 日志级别的设定方法

修改 conf/logging.properties 中的内容，设定某类日志的级别

示例：

设置 catalina 日志的级别为： FINE

1catalina.org.apache.juli.FileHandler.level = FINE

禁用 catalina 日志的输出：

1catalina.org.apache.juli.FileHandler.level = OFF

输出 catalina 所有的日志消息均输出：

1catalina.org.apache.juli.FileHandler.level = ALL

4    使用 log4j 记录应用程序日志或系统日志

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

此例可弥补 tomcat 启动异常时输出的错误信息不足的问题，使用 commons-logging 和 log4j 搭配输出详尽的日志信息。

以 window 环境下 tomcat5.5.27 为例：

1、 tomcat 解压目录为：

E: /tomcat5.5

2、设置环境变量：

CATALINA_HOME=E: /tomcat5.5

3、下载 log4j 与 commons-logging

Log4j 下载地址：

http://logging.apache.org/log4j/1.2/download.html

Commons-logging 下载地址：

http://apache.freelamp.com/commons/logging/binaries/commons-logging-1.1.1-bin.zip

4、本例将 commons-logging-1.1.1.jar 与 log4j-1.2.15.jar 放在 %TOMCAT_HOME%/bin 目录下（可根据需要放置在其位置）

5、在 %TOMCAT_HOME%/bin 目录下新建两个文件 commons-logging.properties 、 log4j.properties

commons-logging.properties 文件内容如下：

org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JLogger

log4j.properties 文件内容如下：

log4j.rootLogger=WARN,stdout,file

## 日志直接输出到控制台 ###

log4j.appender.stdout=org.apache.log4j.ConsoleAppender

log4j.appender.stdout.Target=System.out

log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %l – %m%n

## 日志输出到文件 SystemOut.log ###

log4j.appender.file=org.apache.log4j.FileAppender

log4j.appender.file.File=E: /tomcat5.5/ logs/SystemOut.log

log4j.appender.file.Append=false

log4j.appender.file.layout=org.apache.log4j.PatternLayout

log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} %l – %m%n

该配置文件可详细参照：

http://www.minaret.biz/tips/tomcatLogging.html#log4j_properties

6、修改 catalina.bat 文件

将

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

替换为

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

7、通过 startup.bat 启动就会用 log4j 来输出启动日志了。

8、在 E: /tomcat5.5/ logs/SystemOut.log 文件中查看输出的日志

4.2 应用程序中使用 log4j 使用方法

1、从如下网址下载 log4j ：

http://logging.apache.org/log4j/1.2/download.html

2、创建 Java 工程。

3、添加 log4j.jar 到工程的编译路径下。

4、创建名称为 log4j.properties 的文件，写入如下内容：

### direct log messages to stdout ###

log4j.appender.stdout=org.apache.log4j.ConsoleAppender

log4j.appender.stdout.Target=System.out

log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L – %m%n

log4j.rootLogger=debug, stdout

5、创建类并添加如下内容：

import org.apache.log4j.Logger;

public class LogClass {

        private static org.apache.log4j.Logger log = Logger

                        .getLogger (LogClass. class );

        public static void main(String[] args) {

                log .trace( “Trace” );

                log .debug( “Debug” );

                log .info( “Info” );

                log .warn( “Warn” );

                log .error( “Error” );

                log .fatal( “Fatal” );

        }

}

6、编译运行，可在控制台中看到如下内容：

10:38:24,797 DEBUG LogClass:11 – Debug

10:38:24,812 INFO LogClass:12 – Info

10:38:24,812 WARN LogClass:13 – Warn

10:38:24,812 ERROR LogClass:14 – Error

10:38:24,812 FATAL LogClass:15 – Fatal

7、根据级别控制日志输出内容：

将 log4j.rootLogger= debug , stdout 变更为 log4j.rootLogger=Warn, stdout

输出内容如下：

10:41:15,488 WARN LogClass:13 – Warn

10:41:15,504 ERROR LogClass:14 – Error

10:41:15,504 FATAL LogClass:15 – Fatal

4.3 配置 log4j.properties 更改日志输出内容

1 、 log4j.rootCategory=INFO, stdout , R

此句为将等级为 INFO 的日志信息输出到 stdout 和 R 这两个目的地。等级可分为 OFF 、 FATAL 、 ERROR 、 WARN 、 INFO 、 DEBUG 、 ALL ，如果配置 OFF 则不打出任何信息，如果配置为 INFO 这样只显示 INFO, WARN, ERROR 的 log 信息，而 DEBUG 信息不会被显示。

2 、 log4j.appender.stdout=org.apache.log4j.ConsoleAppender

此句为定义名为 stdout 的输出端是哪种类型，可以是

Ø org.apache.log4j.ConsoleAppender （控制台），

Ø org.apache.log4j.FileAppender （文件），

Ø org.apache.log4j.DailyRollingFileAppender （每天产生一个日志文件），

Ø org.apache.log4j.RollingFileAppender （文件大小到达指定尺寸的时候产生一个新的文件）

Ø org.apache.log4j.WriterAppender （将日志信息以流格式发送到任意指定的地方）

3 、 log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

此句为定义名为 stdout 的输出端的 layout 是哪种类型

Ø org.apache.log4j.HTMLLayout （以HTML 表格形式布局），

Ø org.apache.log4j.PatternLayout （可以灵活地指定布局模式），

Ø org.apache.log4j.SimpleLayout （包含日志信息的级别和信息字符串），

Ø org.apache.log4j.TTCCLayout （包含日志产生的时间、线程、类别等等信息）

4 、 log4j.appender.stdout.layout.ConversionPattern= [QC] %p [%t] %C.%M(%L) | %m%n

如果使用 pattern 布局就要指定的打印信息的具体格式 ConversionPattern ，打印参数如下：

具体的设定参照：

http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/PatternLayout.html

Ø %m 输出代码中指定的消息

Ø %p 输出优先级，即 DEBUG ， INFO ， WARN ， ERROR ， FATAL

Ø %r 输出自应用启动到输出该 log 信息耗费的毫秒数

Ø %c 输出所属的类目，通常就是所在类的全名

Ø %t 输出产生该日志事件的线程名

Ø %n 输出一个回车换行符， Windows 平台为 “rn” ， Unix 平台为 “n”

Ø %d 输出日志时间点的日期或时间，默认格式为 ISO8601 ，也可以在其后指定格式，比如： %d{yyyy mm dd HH:mm:ss,SSS} ，输出类似： 2002 年 10 月 18 日 22 ： 10 ： 28 ， 921

Ø %l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。

Ø [QC] 是 log 信息的开头，可以为任意字符，一般为项目简称。

5       Log4j 相关资料

以下网址提供了 log4j 的介绍：

http://logging.apache.org/log4j/1.2/manual.html

以下网址提供的 log4j 的使用示例：

http://www.laliluna.de/log4j-tutorial.html

第二篇 eclipse下tomcat日志

在eclipse或myeclipse中使用tomcat启动项目可以在控制台输出相关日志，有时日志打印的多了查看的话很不方便，这时我们可以在我们使用的tomcat中直接配置log4j来将我们需要看的日志打印输出到指定的文件中，这样便于我们进行日志分析，下面就介绍一下如何在tomcat中配置log4j打印日志。

在目录（…\Tomcat5.5.1\common\lib）下加入如下jar包，没有的话就网上下两个吧…

commons-logging-1.0.3.jar
log4j-1.2.13.jar

在目录（…\Tomcat5.5.1\common\classes）下加入下面的文件，我们经常配置的，很熟悉…

log4j.properties

看一个实例的简单配置：

tomcat配置log4j输出日志到指定文件 - lfsyhuangaigang@126 - 信息技术提高班