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，配置路径时请以实际环境为准。

最新问答