快捷導(dǎo)航

Tomcat日志文件名的命名規(guī)范詳解

更新時(shí)間：2025年09月09日 08:48:23 作者：vortex5

Tomcat日志分為Catalina（全局事件）、Access（HTTP請(qǐng)求）、應(yīng)用級(jí)及Manager日志,命名規(guī)則包含日期格式（yyyy-MM-dd）、分隔符和擴(kuò)展名（.log/.txt）,配置文件可調(diào)整命名,需注意大小寫敏感、輪轉(zhuǎn)壓縮及時(shí)區(qū)設(shè)置,避免GET參數(shù)泄露賬號(hào)密碼

1. 核心日志類型及命名規(guī)范

(1) Catalina 日志（引擎級(jí)日志）

文件名：catalina.<yyyy-MM-dd>.log
說明：記錄 Tomcat 啟動(dòng)、關(guān)閉、嚴(yán)重錯(cuò)誤等全局事件。
示例：catalina.2025-09-07.log

(2) Access 日志（訪問日志）

文件名：localhost_access_log.<yyyy-MM-dd>.txt
說明：記錄所有 HTTP 請(qǐng)求（需配置 <Valve> 啟用）。
示例：localhost_access_log.2025-09-07.txt

如果認(rèn)證采用GET傳參，可能泄露賬號(hào)密碼！

(3) 應(yīng)用級(jí)日志（Host/Context 日志）

文件名：localhost.<yyyy-MM-dd>.log
說明：記錄特定 Web 應(yīng)用（如 localhost 虛擬主機(jī)）的錯(cuò)誤。
示例：localhost.2025-09-07.log

(4) Manager/Host-Manager 日志

文件名：manager.<yyyy-MM-dd>.log / host-manager.<yyyy-MM-dd>.log
說明：記錄 Tomcat 管理應(yīng)用的日志。

2. 命名規(guī)則詳解

日期格式：固定為 <yyyy-MM-dd>（ISO 8601 格式，區(qū)分大小寫）。
分隔符：點(diǎn)號(hào) . 分隔名稱組件，日期前后無額外符號(hào)。

擴(kuò)展名：

默認(rèn)日志為 .log（如 catalina.2025-09-07.log）。
訪問日志為 .txt（如 localhost_access_log.2025-09-07.txt）。

3. 配置自定義命名

通過修改 conf/logging.properties 或 server.xml 可調(diào)整命名規(guī)則：

示例：修改 Access 日志命名

<Valve className="org.apache.catalina.valves.AccessLogValve"
       directory="logs"
       prefix="access_log"
       suffix=".log"
       pattern="%h %l %u %t &quot;%r&quot; %s %b"
       fileDateFormat="yyyy-MM-dd.HH" />  <!-- 按小時(shí)分割 -->

效果：生成 access_log.2025-09-07.14.log（小時(shí)級(jí)分割）。

示例：修改 Catalina 日志命名

在 logging.properties 中：

java.util.logging.FileHandler.pattern = %h/tomcat/logs/catalina-%g.log

效果：生成 catalina-0.log、catalina-1.log（按輪轉(zhuǎn)編號(hào)）。

4. 關(guān)鍵注意事項(xiàng)

大小寫敏感：Linux 系統(tǒng)嚴(yán)格區(qū)分 catalina.2025-09-07.log 與 Catalina.2025-09-07.log。
輪轉(zhuǎn)機(jī)制：默認(rèn)按天分割，歷史日志會(huì)被壓縮為 .gz（如 catalina.2025-09-06.log.gz）。
時(shí)區(qū)影響：日期基于系統(tǒng)時(shí)區(qū)，需確保服務(wù)器時(shí)區(qū)配置正確（如 Asia/Shanghai）。