如何提升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.propertiesorg.apache.catalina.level = WARNINGorg.apache.catalina.startup.level = WARNING1catalina.org.apache.juli.AsyncFileHandler.level = WARNING1catalina.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs1catalina.org.apache.juli.AsyncFileHandler.prefix = catalina.2localhost.org.apache.juli.AsyncFileHandler.level = WARNING3manager.org.apache.juli.AsyncFileHandler.level = WARNING4host-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 {dailymissingokrotate 30compressdelaycompresscopytruncatenotifempty}

• 应用侧使用 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 或脚本按日期重定向。