Debian Tomcat日志记录频率如何调整

Debian Tomcat 日志记录频率调整指南

一 概念澄清

• “频率”通常包含三层含义：
  • 日志事件的产生频率：由日志级别（如 SEVERE/WARNING/INFO/FINE）控制，级别越高产生的日志越少。
  • 文件切割频率：按时间或大小把日志切分成新文件，例如 daily/hourly 或按 size。
  • 日志保留策略：保留最近 N 天或 N 个历史文件，配合压缩与清理。

二 调整日志级别以减少或增加日志产生

• 编辑配置文件 $CATALINA_BASE/conf/logging.properties，为不同 Logger/Handler 设置级别；保存后重启 Tomcat 生效。
• 常用级别从低到高：FINEST < FINER < FINE < CONFIG < INFO < WARNING < SEVERE < OFF。
• 示例（减少控制台与 Catalina 输出，仅保留较高优先级）：
  • 全局或按包调高阈值
    • org.apache.catalina.level = WARNING
    • org.apache.catalina.startup.level = WARNING
  • 调整具体 Handler 的级别
    • 1catalina.org.apache.juli.FileHandler.level = WARNING
    • java.util.logging.ConsoleHandler.level = WARNING
  • 如需更细粒度，可针对应用包设置：
    • com.yourorg.level = DEBUG/INFO
• 说明：Tomcat 默认使用 JULI 日志体系，常见日志文件包括 catalina、localhost、manager、host-manager 等，均可在 logging.properties 中独立配置级别与输出方式。

三 调整文件切割频率与保留策略

• 访问日志 AccessLog（按时间切割）
  • 编辑 conf/server.xml 中的 AccessLogValve，通过 rotatable 与 maxDays 控制按天轮转与保留天数；也可自定义 pattern。
  • 示例：
    • <Valve className=“org.apache.catalina.valves.AccessLogValve” directory=“logs” prefix=“localhost_access_log” suffix=“.txt” rotatable=“true” maxDays=“30” pattern=“%h %l %u %t “%r” %s %b” />
• catalina.out 与 JULI 文件（系统级 logrotate）
  • 创建或编辑 /etc/logrotate.d/tomcat，为 catalina.out 或 /var/log/tomcat/*.log 设置切割频率与保留策略。
  • 按天切割并保留 7 天（示例）：
    • /var/log/tomcat/*.log {
      • daily
      • missingok
      • rotate 7
      • compress
      • notifempty
      • create 640 tomcat adm
      • copytruncate }
  • 按小时切割（示例）：
    • /var/log/tomcat/*.log {
      • hourly
      • missingok
      • rotate 24
      • compress
      • notifempty
      • create 640 tomcat adm
      • copytruncate }
  • 说明：
    • daily/hourly 决定切割频率；rotate N 决定保留份数；compress 启用压缩；copytruncate 适用于被进程持续持有的文件（如 catalina.out），避免重启；create 指定新文件权限与属主。
    • 测试与生效：执行 sudo logrotate -f /etc/logrotate.d/tomcat 强制轮转一次；logrotate 通常由 /etc/cron.daily/logrotate 每日自动调用。

四 常用场景配置示例

• 场景 A：降低日志量（生产常用）
  • 将全局与控制台级别调至 WARNING；保留访问日志 30 天；JULI 与 catalina.out 按天轮转并保留 7 天。
• 场景 B：问题排查期（临时高频）
  • 将相关 Logger 调至 FINE/FINER；访问日志保留 90 天；JULI 文件按天轮转并保留 30 天。
• 场景 C：按小时切割高流量服务
  • 访问日志与 JULI 文件均设为 hourly，保留 24 份；结合压缩与合适的 rotate 值控制磁盘占用。

五 注意事项

• 修改 logging.properties 后需重启 Tomcat 才能生效；调整 server.xml 的 Valve 通常也需重启。
• catalina.out 是标准输出/错误的聚合，默认不自动切割；使用 copytruncate 可避免重启，但在极端高并发下存在极小概率丢行，务必在维护窗口验证。
• 切割频率与保留周期需结合磁盘容量与合规要求设定；建议启用 compress 并定期清理历史文件。
• 若使用包管理器安装的 Tomcat，日志目录可能为 /var/log/tomcat；若手动安装，常见为 $CATALINA_BASE/logs，配置路径时请以实际环境为准。