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