Debian 上 Tomcat 日志管理的高效实践
一 日志目录与组件梳理
- 日志默认位置取决于安装方式：通过 APT 安装通常在 /var/log/tomcat/；手动解压安装通常在 /opt/tomcat/logs/。核心文件与作用如下：
- catalina.out：标准输出/错误合并日志（默认不滚动，易膨胀）。
- catalina.YYYY-MM-DD.log：Catalina 引擎按日期分割日志。
- localhost.YYYY-MM-DD.log：Tomcat 内部组件日志。
- manager/host-manager.YYYY-MM-DD.log：管理应用日志。
- access_log.YYYY-MM-DD.txt：访问日志（需通过 Valve 开启）。
二 减少同步 I/O 与日志量
- 调整日志级别：在 conf/logging.properties 将全局或特定包日志级别提升到 WARNING/ERROR，减少低级别（如 DEBUG/TRACE）输出。示例：
- 全局：.level = INFO
- 包级：org.apache.catalina.core.level = WARNING
- 启用异步日志：将 ConsoleHandler 替换为 AsyncFileHandler，降低同步写带来的线程阻塞。示例：
- handlers = 1catalina.org.apache.juli.AsyncFileHandler, …, java.util.logging.ConsoleHandler
- 精简或关闭访问日志：在 conf/server.xml 中按需关闭或简化访问日志，避免高并发下大量磁盘写入。
- 关闭：将 AccessLogValve 的 enabled=“false”
- 简化：使用 common/combined 或精简 pattern，关闭 resolveHosts 以减少 DNS 查询。
三 日志轮转与清理
- 使用 logrotate（推荐）：为 Tomcat 日志创建 /etc/logrotate.d/tomcat，示例：
- /var/log/tomcat/*.log {
- daily
- rotate 7
- compress
- delaycompress
- missingok
- notifempty
- create 640 tomcat tomcat
- sharedscripts
- postrotate
- /bin/kill -HUP
cat /var/run/tomcat.pid 2>/dev/null 2>/dev/null || true
- endscript
- }
- 说明：按天轮转、保留 7 天、压缩旧日志；使用 copytruncate 可避免重启，但存在极小概率丢行风险；使用 postrotate + HUP 可安全通知 Tomcat 重新打开日志文件。
- 使用 cronolog 分割 catalina.out（适合必须保留单一控制台输出流）：
- 安装：apt/yum 安装或源码编译，确保 /usr/local/sbin/cronolog 可用。
- 修改 bin/catalina.sh：
- 将 CATALINA_OUT 改为带日期的格式：如 $CATALINA_BASE/logs/catalina.out.%Y-%m-%d
- 将启动行改为通过管道写入 cronolog，例如：
- org.apache.catalina.startup.Bootstrap “$@” start 2>&1
|/usr/local/sbin/cronolog “$CATALINA_OUT” >> /dev/null &
- 重启 Tomcat 后验证是否生成 catalina.YYYY-MM-DD.out 文件。
四 访问日志与输出路径优化
- 访问日志配置要点（server.xml）：
- 典型 Valve：
- <Valve className=“org.apache.catalina.valves.AccessLogValve”
- directory=“logs”
- prefix=“localhost_access_log”
- suffix=“.txt”
- pattern=“%h %l %u %t “%r” %s %b”
- resolveHosts=“false”/>
- 建议：生产环境按需开启；高并发场景优先使用 combined 或精简 pattern，避免复杂字段解析带来的性能损耗。
- 输出路径与权限：
- 在 logging.properties 明确 directory=${catalina.base}/logs，确保运行用户（如 tomcat）对该目录具备写权限。
- 避免将 catalina.out 长期重定向到不受控位置；若必须重定向，确保轮转与清理策略同步到位。
五 分析与容量规划建议
- 快速排查命令：
- 实时查看：tail -f /var/log/tomcat/catalina.out
- 关键字过滤：grep -i “error” /var/log/tomcat/catalina.out -A 5
- 大文件分页：less /var/log/tomcat/catalina.out
- 集中化与长期分析：
- 小规模可用 grep/awk/sed 做统计；中大规模建议接入 ELK Stack（Elasticsearch、Logstash、Kibana） 或 Graylog，实现检索、可视化与告警。
- 容量与性能联动：
- 日志级别、访问日志开关与轮转策略直接影响 磁盘 I/O 与 文件句柄；结合业务峰值设置合理的 rotate 天数与压缩策略，并监控 磁盘使用率 与 I/O 等待。
- 变更配置后先在测试环境验证，再灰度上线，避免影响线上稳定性。
