如何配置Debian上的Tomcat日志管理

Debian上Tomcat日志管理实操指南

一核心配置文件与目录

配置文件位置：$CATALINA_BASE/conf/logging.properties（JULI 日志系统）；访问日志在 $CATALINA_BASE/conf/server.xml 的中通过 AccessLogValve 配置。常见日志目录为 $CATALINA_BASE/logs，包含 catalina.out、catalina..log、localhost..log、localhost_access_log.*.txt 等。Debian 包安装的 Tomcat 可能使用系统服务单元（如 tomcat9），但日志路径与配置方式保持一致。建议始终以 $CATALINA_BASE 为准，避免与 $CATALINA_HOME 混淆。

二配置日志级别与输出格式

编辑 logging.properties，按需调整级别与格式。示例（开启更详细的文件日志，并使用单行格式）：

# 全局级别
.level = INFO

# 使用异步文件处理器（若文件句柄占用高或写压力大可优先）
handlers = 1catalina.org.apache.juli.AsyncFileHandler, \
           2localhost.org.apache.juli.AsyncFileHandler, \
           3manager.org.apache.juli.AsyncFileHandler, \
           4host-manager.org.apache.juli.AsyncFileHandler, \
           java.util.logging.ConsoleHandler

# 文件日志：按组件拆分
1catalina.org.apache.juli.AsyncFileHandler.level = FINE
1catalina.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
1catalina.org.apache.juli.AsyncFileHandler.prefix = catalina.
1catalina.org.apache.juli.AsyncFileHandler.suffix = .log

2localhost.org.apache.juli.AsyncFileHandler.level = FINE
2localhost.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
2localhost.org.apache.juli.AsyncFileHandler.prefix = localhost.
2localhost.org.apache.juli.AsyncFileHandler.suffix = .log

3manager.org.apache.juli.AsyncFileHandler.level = INFO
3manager.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
3manager.org.apache.juli.AsyncFileHandler.prefix = manager.
3manager.org.apache.juli.AsyncFileHandler.suffix = .log

4host-manager.org.apache.juli.AsyncFileHandler.level = INFO
4host-manager.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
4host-manager.org.apache.juli.AsyncFileHandler.prefix = host-manager.
4host-manager.org.apache.juli.AsyncFileHandler.suffix = .log

# 控制台日志：便于前台调试
java.util.logging.ConsoleHandler.level = FINE
java.util.logging.ConsoleHandler.formatter = org.apache.juli.OneLineFormatter

说明：

级别从低到高常用为 FINE < INFO < WARNING < SEVERE；生产建议 INFO/WARNING，排障可临时调到 FINE。
若更关注性能与文件句柄占用，优先使用 AsyncFileHandler；如需兼容老版本或简单场景，可用 FileHandler。

三配置访问日志

在 server.xml 的内启用或调整 AccessLogValve，示例（NCSA 扩展格式，便于分析）：
```
<Valve className="org.apache.catalina.valves.AccessLogValve"
       directory="${catalina.base}/logs"
       prefix="localhost_access_log"
       suffix=".txt"
       pattern="%h %l %u %t "%r" %s %b"
       resolveHosts="false"/>
```
常用 pattern：
- common：%h %l %u %t “%r” %s %b
- combined：在 common 基础上增加 Referer 与 User-Agent 提示：访问日志对磁盘与 I/O 有一定压力，生产环境请结合保留周期与压缩策略合理配置。

四日志轮转与保留策略

使用 logrotate 管理 catalina.out 与按日期滚动的组件日志，避免无限增长。

创建 /etc/logrotate.d/tomcat（路径按实际安装调整）：

# 轮转 catalina.out（被外部进程持续写入，使用 copytruncate）
/opt/tomcat/logs/catalina.out {
    daily
    rotate 14
    compress
    missingok
    notifempty
    copytruncate
}

# 轮转按日期命名的组件日志（JULI 已按日期滚动，仅做压缩与清理）
/opt/tomcat/logs/catalina.*.log
/opt/tomcat/logs/localhost.*.log
/opt/tomcat/logs/manager.*.log
/opt/tomcat/logs/host-manager.*.log {
    daily
    rotate 14
    compress
    missingok
    notifempty
    dateext
    dateformat -%Y%m%d
}

测试与生效：

sudo logrotate -d /etc/logrotate.d/tomcat   # 语法检查（dry-run）
sudo logrotate -f /etc/logrotate.d/tomcat   # 强制执行一次

说明：
- copytruncate 适合被外部进程持有的 catalina.out；若使用 systemd 的 StandardOutput/StandardError 重定向到文件，也可考虑用 copytruncate 或改为由服务自身轮转。
- dateext 让旧日志以日期后缀归档，便于追溯与清理。

五验证与运维建议

验证与查看：

tail -f $CATALINA_BASE/logs/catalina.out
tail -f $CATALINA_BASE/logs/localhost_access_log.*.txt
grep -i error $CATALINA_BASE/logs/catalina.*.log

变更生效：

修改 logging.properties 后，重启 Tomcat 使配置生效：

sudo systemctl restart tomcat9    # 包安装常见服务名
# 或
$CATALINA_BASE/bin/shutdown.sh
$CATALINA_BASE/bin/startup.sh

性能与合规建议：
- 生产环境避免长期 DEBUG/FINE；访问日志建议配合 压缩与合理保留周期。
- 集中化采集与分析可使用 ELK/Graylog 等方案，便于告警、检索与可视化。

最新问答

相关标签