tomcat中的日志開關文件（logging.properties）介紹

以tomcat-6.0.29為例：

http://www.ossez.com/thread-18138-1-1.html

#配置tomcat的日志輸出方式，這里表示文件輸出和控制台輸出
.handlers = 1catalina.org.apache.juli.FileHandler, java.util.logging.ConsoleHandler
catalina.org.apache.juli.FileHandler.level = FINE #日志級別
例：
1catalina.org.apache.juli.FileHandler.level = FINE #設置 catalina 日志的級別為： FINE
1catalina.org.apache.juli.FileHandler.level = OFF #禁用 catalina 日志的輸出
1catalina.org.apache.juli.FileHandler.level = ALL#輸出 catalina 所有的日志消息均輸出

catalina.org.apache.juli.FileHandler.directory = ${catalina.base}/logs #日志輸出目錄，此設置表示tomcat日志輸出到tomcat\logs目錄下

catalina.org.apache.juli.FileHandler.prefix = catalina. #日志輸出前綴，后面跟日期信息(yyyy-MM-dd) 
注：tomcat_6.0.29輸出4種不同的日志：catalina、localhost、manager、host-manager

java.util.logging.ConsoleHandler.level = FINE #控制台日志輸出級別
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter #控制台日志輸出格式化類，Formatter 為格式化 LogRecords 提供支持。

下面是每個日志文件的輸出級別和處理類
org.apache.catalina.core.ContainerBase.[Catalina].[localhost].level = INFO
org.apache.catalina.core.ContainerBase.[Catalina].[localhost].handlers = 2localhost.org.apache.juli.FileHandler

org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/manager].level = INFO
org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/manager].handlers = 3manager.org.apache.juli.FileHandler

org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/host-manager].level = INFO
org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/host-manager].handlers = 4host-manager.org.apache.juli.FileHandler

 

 

 

 

 

 

Tomcat 日志信息分 為 兩 類 ：

一是運行中的日志，它主要 記錄 運行的一些信息，尤其是一些異常錯誤日志信息 。
二是訪問 日志信息，它 記錄 的 訪問 的 時間、IP、訪問的資料等相關信息。

2.1  訪問日志的配置

默認 tomcat 不記錄訪問日志，如下方法可以使 tomcat 記錄訪問日志

編輯 ${catalina}/conf/server.xml 文件 . 注 :${catalina} 是 tomcat 的安裝目錄

把以下的注釋 (<!-- -->) 去掉即可。

1. <!--
2.         <Valve className="org.apache.catalina.valves.AccessLogValve"
3.          directory="logs"  prefix="localhost_access_log." suffix=".txt"
4.          pattern="common" resolveHosts="false"/>
5.   -->

復制代碼

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 項

修改 Tomcat 運行日志的等級

日志類型與級別

Tomcat 日志分為下面５類：

catalina 、 localhost 、 manager 、 admin 、 host-manager

每類日志的級別分為如下 7 種：

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

日志級別的設定方法

修改 conf/logging.properties 中的內容，設定某類日志的級別

示例：

設置 catalina 日志的級別為： FINE

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

禁用 catalina 日志的輸出：

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

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

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

使用 log4j 記錄應用程序日志或系統日志。

使用 Log4j 輸出詳細系統日志信息，快速診斷啟動故障。

此例可彌補 tomcat 啟動異常時輸出的錯誤信息不足的問題，使用 commons-logging 和 log4j 搭配輸出詳盡的日志信息 。

以 window 環境下 tomcat5.5.27 為例：

tomcat 解壓目錄為：

E: \tomcat5.5

設置環境變量：

CATALINA_HOME=E: \tomcat5.5

下載 log4j 與 commons-logging

Log4j 下載地址：

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

Commons-logging 下載地址：

http://apache.freelamp.com/commo ... gging-1.1.1-bin.zip

本例將 commons-logging-1.1.1.jar 與 log4j-1.2.15.jar 放在 %TOMCAT_HOME%\bin 目錄下（可根據需要放置在其位置）

在 %TOMCAT_HOME%\bin 目錄下新建兩個文件 commons-logging.properties 、 log4j.properties

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

1. org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JLogger
3. log4j.properties 文件內容如下：
5. log4j.rootLogger=WARN,stdout,file
7. ## 日志直接輸出到控制台 ###
9. log4j.appender.stdout=org.apache.log4j.ConsoleAppender
11. log4j.appender.stdout.Target=System.out
13. log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
15. log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %l - %m%n
17. ## 日志輸出到文件 SystemOut.log ###
19. log4j.appender.file=org.apache.log4j.FileAppender
21. log4j.appender.file.File=E: /tomcat5.5/ logs/SystemOut.log
23. log4j.appender.file.Append=false
25. log4j.appender.file.layout=org.apache.log4j.PatternLayout
27. log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} %l - %m%n

復制代碼

該配置文件可詳細參照：

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

修改 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

通 過 startup.bat 啟 動 就會用 log4j 來 輸 出啟 動 日志了 。

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

應用程序中使用 log4j 使用方法

從如下網址下 載 log4j ：

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

創 建 Java 工程。

添加 log4j.jar 到工程的 編譯 路徑下 。

創建名稱 為 log4j.properties 的文件，寫入如下內容：

1. ### direct log messages to stdout ###
3. log4j.appender.stdout=org.apache.log4j.ConsoleAppender
5. log4j.appender.stdout.Target=System.out
7. log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
9. log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n
11. log4j.rootLogger=debug, stdout

復制代碼

創 建 類 並添加如下內容：

import org.apache.log4j.Logger;

1. public class LogClass {
3.         private static org.apache.log4j.Logger log = Logger
5.                         .getLogger (LogClass. class );
9.         public static void main(String[] args) {
11.                 log .trace( "Trace" );
13.                 log .debug( "Debug" );
15.                 log .info( "Info" );
17.                 log .warn( "Warn" );
19.                 log .error( "Error" );
21.                 log .fatal( "Fatal" );
23.         }
25. }

復制代碼

編譯 運行，可在控制台中看到如下內容 ：

1. 10:38:24,797 DEBUG LogClass:11 - Debug
3. 10:38:24,812  INFO LogClass:12 - Info
5. 10:38:24,812  WARN LogClass:13 - Warn
7. 10:38:24,812 ERROR LogClass:14 - Error
9. 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/ ... /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