Tomcat日志文件名的命名规范详解

1. 核心日志类型及命名规范

(1) Catalina 日志（引擎级日志）

• 文件名：catalina.<yyyy-MM-dd>.log
• 说明：记录 Tomcat 启动、关闭、严重错误等全局事件。
• 示例：catalina.2025-09-07.log

(2) Access 日志（访问日志）

• 文件名：localhost_access_log.<yyyy-MM-dd>.txt
• 说明：记录所有 HTTP 请求（需配置 <Valve> 启用）。
• 示例：localhost_access_log.2025-09-07.txt

如果认证采用GET传参，可能泄露账号密码！

(3) 应用级日志（Host/Context 日志）

• 文件名：localhost.<yyyy-MM-dd>.log
• 说明：记录特定 Web 应用（如 localhost 虚拟主机）的错误。
• 示例：localhost.2025-09-07.log

(4) Manager/Host-Manager 日志

• 文件名：manager.<yyyy-MM-dd>.log / host-manager.<yyyy-MM-dd>.log
• 说明：记录 Tomcat 管理应用的日志。

2. 命名规则详解

• 日期格式：固定为 <yyyy-MM-dd>（ISO 8601 格式，区分大小写）。
• 分隔符：点号 . 分隔名称组件，日期前后无额外符号。

扩展名：

• 默认日志为 .log（如 catalina.2025-09-07.log）。
• 访问日志为 .txt（如 localhost_access_log.2025-09-07.txt）。

3. 配置自定义命名

通过修改 conf/logging.properties 或 server.xml 可调整命名规则：

示例：修改 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" />  <!-- 按小时分割 -->

• 效果：生成 access_log.2025-09-07.14.log（小时级分割）。

示例：修改 Catalina 日志命名

在 logging.properties 中：

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

• 效果：生成 catalina-0.log、catalina-1.log（按轮转编号）。

4. 关键注意事项

• 大小写敏感：Linux 系统严格区分 catalina.2025-09-07.log 与 Catalina.2025-09-07.log。
• 轮转机制：默认按天分割，历史日志会被压缩为 .gz（如 catalina.2025-09-06.log.gz）。
• 时区影响：日期基于系统时区，需确保服务器时区配置正确（如 Asia/Shanghai）。

5. 验证配置

检查 conf/server.xml 和 conf/logging.properties 中的以下参数：

• directory：日志存储路径（默认 logs/）。
• prefix/suffix：文件名前缀/后缀。
• rotatable：是否启用按天分割（默认 true）。

通过以上规范，可确保日志文件名清晰、唯一，且便于自动化工具解析和归档。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

最新评论