Ubuntu Tomcat日志存储优化方法

Ubuntu Tomcat日志存储优化方法

一 核心策略与优先级

• 控制输出源头：调高不必要的日志级别，减少冗余输出。
• 规范访问日志：启用并按需切割与保留访问日志，避免单文件无限增长。
• 轮转与压缩：对catalina.out等持续写入文件使用logrotate按天/按大小切割并压缩归档。
• 异步与性能：在支持的版本中使用异步日志，降低同步写带来的性能抖动。
• 集中与长期留存：将关键日志接入Systemd Journal或集中式日志平台，便于检索与审计。

二 快速落地步骤

• 调整日志级别：编辑conf/logging.properties，将全局或特定包的级别调至WARNING/ERROR，减少低级别日志量。示例：
  • .level=INFO
  • java.util.logging.ConsoleHandler.level=WARNING
  • 针对特定包：com.example.level=ERROR
• 配置访问日志轮转：编辑conf/server.xml中的AccessLogValve，启用按日轮转并设置保留天数（如7天）。示例：
  • <Valve className=“org.apache.catalina.valves.AccessLogValve” directory=“logs” prefix=“localhost_access_log” suffix=“.txt” pattern=“%h %l %u %t “%r” %s %b” rotatable=“true” maxDays=“7”/>
• 配置 catalina.out 的 logrotate：创建**/etc/logrotate.d/tomcat**，示例：
  • /opt/tomcat/logs/catalina.out {
    • daily
    • rotate 14
    • compress
    • missingok
    • notifempty
    • copytruncate
    • su tomcat tomcat }
  • 说明：使用copytruncate可避免重启或信号干预；如采用“create …”方式，可在postrotate中发送信号（如 kill -USR1）通知重新打开日志文件。
• 验证与强制执行：
  • 语法/模拟：logrotate -d /etc/logrotate.d/tomcat
  • 强制执行：logrotate -f /etc/logrotate.d/tomcat
• 可选 异步日志：在logging.properties中将控制台/文件处理器替换为org.apache.juli.AsyncFileHandler（Tomcat 8+），提升高并发下的日志吞吐与响应。

三 关键配置示例

• logrotate 最小可用配置（按天轮转，保留14天，压缩归档，适配持续写入的 catalina.out）
  • /opt/tomcat/logs/catalina.out {
    • daily
    • rotate 14
    • compress
    • missingok
    • notifempty
    • copytruncate
    • su tomcat tomcat }
• 按大小触发轮转（当文件达到200MB即切割，同时保留按天策略）
  • /opt/tomcat/logs/catalina.out {
    • daily
    • rotate 15
    • compress
    • missingok
    • size 200M
    • copytruncate
    • dateext }
• 访问日志保留天数（server.xml）
  • <Valve className=“org.apache.catalina.valves.AccessLogValve” directory=“logs” prefix=“localhost_access_log” suffix=“.txt” pattern=“%h %l %u %t “%r” %s %b” rotatable=“true” maxDays=“7”/>
• 日志级别优化（logging.properties）
  • .level=INFO
  • java.util.logging.ConsoleHandler.level=WARNING
  • org.apache.catalina.core.ContainerBase.[Catalina].[localhost].level=WARNING

四 自动化与长期治理

• 利用系统计划任务：Ubuntu 默认通过**/etc/cron.daily/logrotate**每日调用 logrotate，无需额外定时任务。
• Systemd 方式（可选）：创建一次性服务单元执行 logrotate，便于纳入系统维护窗口或与其他单元联动。
• 清理与归档：对超过保留期的历史日志执行压缩归档或转移至对象存储/备份介质，释放本地磁盘空间。
• 集中化与审计：将 catalina.out、localhost_access_log 等接入Systemd Journal或集中式日志平台（如 ELK/EFK），统一检索、告警与合规留存。

五 注意事项与最佳实践

• 避免直接删除正在写入的catalina.out（可能导致句柄失效或短暂丢日志）；优先使用copytruncate或“create + 信号通知”方式。
• 合理设置保留周期与压缩：访问日志建议7–14天，业务日志可30–90天；启用compress降低占用。
• 权限与安全：logrotate 使用su tomcat tomcat确保按 Tomcat 运行身份创建/轮转文件，避免权限错配。
• 监控与告警：对日志目录容量设置磁盘告警，并定期抽检关键错误日志，防止因日志占满导致服务异常。