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 "%r" %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
)。
通过以上规范,可确保日志文件名清晰、唯一,且便于自动化工具解析和归档。