如何提高Tomcat日志记录效率

提升 Tomcat 日志记录效率的实用方案

一 核心优化策略

• 调高日志级别，减少无用输出：在生产将多数组件日志级别设为 WARNING/ERROR，仅对问题定位阶段临时开启 FINE/FINER。在 conf/logging.properties 中调整如 org.apache.catalina.level、各类 1catalina/2localhost/3manager/4host-manager 的级别。
• 启用异步日志，降低阻塞：自 Tomcat 8 起使用 JULI 异步文件处理器，将 ConsoleHandler 替换为 org.apache.juli.AsyncFileHandler，把日志 I/O 移出业务线程，显著减少请求排队。
• 精简或优化访问日志：在 conf/server.xml 的 AccessLogValve 中按需精简 pattern、启用 rotatable 与 maxDays，或直接关闭访问日志（权衡审计与性能）。
• 规范输出，避免 System.out/异常栈滥用：减少 System.out/printStackTrace，统一走日志框架；必要时仅保留关键路径的调试信息。
• 做好轮转与清理：用 logrotate/cronolog 做按日/按大小切分、压缩与保留策略，避免 catalina.out 与访问日志无限增长。
• 必要时引入成熟日志框架：在应用侧使用 Log4j2/Logback 替代 JULI，获得更灵活的异步、异步刷新与队列控制能力。

二 关键配置示例

• 调整运行日志级别（示例）

# conf/logging.properties
org.apache.catalina.level = WARNING
org.apache.catalina.startup.level = WARNING
1catalina.org.apache.juli.AsyncFileHandler.level = WARNING
1catalina.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
1catalina.org.apache.juli.AsyncFileHandler.prefix = catalina.
2localhost.org.apache.juli.AsyncFileHandler.level = WARNING
3manager.org.apache.juli.AsyncFileHandler.level = WARNING
4host-manager.org.apache.juli.AsyncFileHandler.level = WARNING

• 启用异步日志（示例）

# 将 ConsoleHandler 替换为 AsyncFileHandler（或新增 AsyncFileHandler 并加入 handlers）
handlers = 1catalina.org.apache.juli.AsyncFileHandler, \
           2localhost.org.apache.juli.AsyncFileHandler, \
           3manager.org.apache.juli.AsyncFileHandler, \
           4host-manager.org.apache.juli.AsyncFileHandler, \
           java.util.logging.ConsoleHandler

# 可按需关闭控制台输出
java.util.logging.ConsoleHandler.level = OFF

• 精简访问日志（示例）

# conf/server.xml
<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（示例）

# bin/catalina.sh（或 catalina.out 重定向）
if [ -z "$CATALINA_OUT" ]; then
  # 按日期切分示例（需确保目录可写）
  CATALINA_OUT="$CATALINA_BASE/logs/catalina.$(date +%Y-%m-%d).out"
  # 如确需关闭：CATALINA_OUT=/dev/null（不建议生产）
fi

• 使用 logrotate 管理日志（示例）

# /etc/logrotate.d/tomcat
/opt/tomcat/logs/catalina.*.out /opt/tomcat/logs/localhost_access_log.*.txt {
    daily
    missingok
    rotate 30
    compress
    delaycompress
    copytruncate
    notifempty
}

• 应用侧使用 Log4j2（示例）

<!-- Maven 依赖：org.apache.logging.log4j:log4j-core, log4j-api, log4j-slf4j-impl -->
<!-- log4j2.xml -->
<Configuration status="WARN">
  <Appenders>
    <RollingFile name="RollingFile" fileName="logs/app.log"
                 filePattern="logs/app-%d{yyyy-MM-dd}-%i.log.gz">
      <PatternLayout pattern="%d{ISO8601} [%t] %-5level %logger{36} - %msg%n"/>
      <Policies>
        <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
        <SizeBasedTriggeringPolicy size="100 MB"/>
      </Policies>
      <DefaultRolloverStrategy max="30"/>
    </RollingFile>
  </Appenders>
  <Loggers>
    <Root level="info">
      <AppenderRef ref="RollingFile"/>
    </Root>
  </Loggers>
</Configuration>

提示：修改配置前先备份，并在非生产环境验证；变更后观察 线程阻塞、磁盘 I/O、GC 停顿 等指标是否改善。

三 按场景的配置建议

四 验证与常见陷阱

• 验证要点
  • 观察 响应时延/P95/P99 与 线程池队列 是否下降；
  • 通过 iostat -x 1、vmstat 1 检查磁盘写放大与系统负载；
  • 使用 jstack 与 Async Profiler 确认日志路径不再是热点；
  • 核对日志是否按策略切分、压缩与清理。
• 常见陷阱
  • 仅关闭控制台输出但未切换到 AsyncFileHandler，仍会阻塞业务线程；
  • 访问日志 pattern 过于冗长或开启 resolveHosts，导致 DNS 查询与 I/O 放大；
  • 轮转策略不当（如无压缩/无保留），引发 磁盘占满 与性能抖动；
  • 应用大量 System.out/printStackTrace，难以异步且易刷盘；
  • 误用 cronolog 分割 catalina.out（更适合分割标准输出流），推荐使用 logrotate 或脚本按日期重定向。