Linux Tomcat日志轮转配置指南

Linux Tomcat日志轮转配置指南

一方案总览与选择

使用系统自带的 logrotate：适合绝大多数场景，配置简单、稳定，支持按时间/大小切割、压缩与保留策略，系统通常通过 cron 每日自动执行。适用于 catalina.out 以及按文件切割的日志。
使用 cronolog：通过管道让 Tomcat 按时间自动创建新日志文件（如 catalina.2025-12-07.out），无需额外轮转工具，但对启动脚本有侵入性。
使用 Log4j 2 按日期滚动：在 Tomcat 10 或应用侧使用 Log4j 2 的 RollingFile，可精细控制按天/按大小滚动与保留天数。
以上三种方式可单独或组合使用，以满足不同日志文件的切割需求。

二使用 logrotate 管理 catalina.out（推荐）

创建配置文件
新建文件 /etc/logrotate.d/tomcat，按实际路径修改日志文件路径与用户组：
```
/usr/local/tomcat/logs/catalina.out {
    daily
    rotate 7
    compress
    missingok
    notifempty
    copytruncate
}
```
关键参数说明：
- daily：按天轮转；可改为 size 100M 等实现按大小触发。
- rotate 7：保留最近 7 个归档。
- compress：压缩归档，节省空间。
- missingok：日志不存在时不报错。
- notifempty：空文件不轮转。
- copytruncate：复制后截断原文件，避免重启应用（适合无法发信号的应用）。
测试与生效
- 调试：sudo logrotate -d /etc/logrotate.d/tomcat
- 强制执行：sudo logrotate -f /etc/logrotate.d/tomcat
自动执行
logrotate 默认由系统的 /etc/cron.daily/logrotate 每日调用，无需额外配置。
多实例与多文件
可统一匹配：/usr/local/tomcat*/logs/*.out { … }；或为每个实例/应用分别配置。
以上配置与用法适用于常见发行版与 Tomcat 版本。

三使用 cronolog 按时间自动切割 catalina.out

安装 cronolog（示例）

wget http://cronolog.org/download/cronolog-1.6.2.tar.gz
tar xzf cronolog-1.6.2.tar.gz
cd cronolog-1.6.2
./configure --prefix=/usr/local/cronolog
make && sudo make install

修改 Tomcat 启动脚本
编辑 bin/catalina.sh，找到类似行：
```
org.apache.catalina.startup.Bootstrap "$@" start >> "$CATALINA_BASE"/logs/catalina.out 2>&1 &
```
替换为（注意有两处需要修改）：
```
org.apache.catalina.startup.Bootstrap "$@" start 2>&1 | \
  /usr/local/cronolog/sbin/cronolog "$CATALINA_BASE"/logs/catalina.%Y-%m-%d.out >> /dev/null &
```
重启 Tomcat 后，将自动生成按日期命名的日志文件（如 catalina.2025-12-07.out）。
该方式无需 logrotate 即可按时间切割，但对脚本有侵入性，升级 Tomcat 时需留意变更。

四使用 Log4j 2 按日期滚动（Tomcat 10 或应用侧）

在应用或 conf/logging.properties 中配置 Log4j 2 的 RollingFile Appender，示例：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
  <Appenders>
    <RollingFile name="RollingFile"
                 fileName="logs/app.log"
                 filePattern="logs/app-%d{yyyy-MM-dd}.log.gz">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
      <Policies>
        <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
      </Policies>
      <DefaultRolloverStrategy max="30"/>
    </RollingFile>
  </Appenders>
  <Loggers>
    <Root level="info">
      <AppenderRef ref="RollingFile"/>
    </Root>
  </Loggers>
</Configuration>

要点：

filePattern 使用日期模式（如 %d{yyyy-MM-dd}）实现按天滚动。
TimeBasedTriggeringPolicy interval=“1” 表示每天滚动；modulate=“true” 使滚动边界对齐到自然日。
DefaultRolloverStrategy max=“30” 保留最近 30 天日志。
适用于需要应用内更细粒度日志策略的场景。

五验证与运维要点

验证与排错
- 调试配置：logrotate -d /etc/logrotate.d/tomcat（语法与执行计划检查）。
- 强制执行：logrotate -f /etc/logrotate.d/tomcat（立即切割，便于验证）。
权限与属主
- 确保 Tomcat 用户对日志目录与文件具备读写权限；在 logrotate 中使用 create 640 tomcat adm 可统一归档文件权限与属主。
信号与重启
- 若不使用 copytruncate，可在 postrotate 中向 Tomcat 进程发送信号（如 kill -USR1 或基于 /var/run/tomcat.pid 的 kill -HUP）以重新打开日志文件；使用 copytruncate 则可避免信号与重启。
多实例与通用脚本
- 多实例建议统一目录规范，使用通配符（如 /usr/local/tomcat/logs/*.out*）或编写通用脚本批量处理。
执行频率
- logrotate 通常由 /etc/cron.daily/logrotate 每日调用；如需调整频率，可修改系统的 cron 任务。
  以上要点可帮助快速定位问题并确保长期稳定运行。

最新问答

相关标签