如何优化Tomcat日志的记录级别

如何优化Tomcat日志记录级别

优化Tomcat日志记录级别需围绕调整级别阈值、精简日志输出、提升性能、规范管理四大核心目标展开，以下是具体操作步骤及注意事项：

1. 调整日志级别阈值，过滤冗余信息

Tomcat采用java.util.logging框架，支持SEVERE（严重错误）、WARNING（警告）、INFO（一般信息）、CONFIG（配置）、FINE（详细调试）、FINER（更详细调试）、FINEST（最详细调试）七级日志。默认级别多为INFO，会产生大量非必要日志（如容器启动、请求响应等）。可根据环境需求调整：

生产环境：将全局日志级别设为WARNING或ERROR，仅记录错误和警告信息，减少日志体积。例如，在conf/logging.properties中修改根日志级别：
```
.level = WARNING
```
特定组件：针对不需要详细日志的组件（如org.apache.catalina.startup启动类、org.apache.coyote HTTP连接器），单独提高其日志级别至WARNING或ERROR。例如：
```
org.apache.catalina.startup.level = WARNING
org.apache.coyote.level = WARNING
```
这样可避免启动过程或HTTP请求的冗余日志占用空间。

2. 启用异步日志记录，提升系统性能

同步日志记录会阻塞主线程，影响Tomcat处理请求的性能（尤其是高并发场景）。从Tomcat 8开始，可使用AsyncFileHandler替代默认的FileHandler或ConsoleHandler，将日志写入操作放入异步线程池，减少主线程等待时间。
修改conf/logging.properties中的处理器配置，将java.util.logging.ConsoleHandler或org.apache.juli.FileHandler替换为org.apache.juli.AsyncFileHandler：

handlers = 1catalina.org.apache.juli.AsyncFileHandler, java.util.logging.ConsoleHandler
1catalina.org.apache.juli.AsyncFileHandler.level = INFO
1catalina.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
1catalina.org.apache.juli.AsyncFileHandler.prefix = catalina.

注意：异步日志可能会增加少量内存开销（用于缓冲日志），但整体性能提升显著。

3. 配置日志轮转策略，防止磁盘空间耗尽

日志文件长期积累会导致磁盘空间不足，需通过**轮转（Rotating）**机制定期归档、压缩旧日志。常用两种方式：

Tomcat原生配置：在conf/logging.properties中为处理器设置maxDays（保留天数）和limit（单文件大小），例如：
```
1catalina.org.apache.juli.FileHandler.maxDays = 30
1catalina.org.apache.juli.FileHandler.limit = 10MB
```
此配置会保留30天内的日志，超过大小的日志会自动分割为新文件。
Linux Logrotate工具：通过系统级工具实现更灵活的轮转（如按天/周轮转、压缩、删除旧日志）。创建/etc/logrotate.d/tomcat文件，添加以下内容：
```
/path/to/tomcat/logs/catalina.out {
    daily
    rotate 30
    compress
    missingok
    notifempty
    copytruncate
}
```
该配置表示：每天轮转catalina.out日志，保留30份压缩文件，若日志为空则不轮转，轮转时不中断Tomcat服务。

4. 禁用不必要的日志输出

关闭访问日志：若无需记录HTTP请求详情（如生产环境仅需错误日志），可在conf/server.xml中注释AccessLogValve配置：

<!-- 
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
       prefix="localhost_access_log" suffix=".txt"
       pattern="%h %l %u %t "%r" %s %b" />
-->

限制第三方组件日志：如数据库驱动（java.sql）、JAR扫描器（org.apache.tomcat.util.scan）等，将级别设为WARNING或ERROR，避免无关日志干扰。例如：
```
java.sql.level = WARNING
org.apache.tomcat.util.scan.StandardJarScanFilter.level = WARNING
```

5. 使用专业日志框架（可选，进阶优化）

Tomcat原生日志框架功能有限，若需要更灵活的日志格式、分布式日志收集、实时分析等功能，建议切换至Log4j 2或Logback。步骤如下：

将Log4j 2或Logback的jar包（如log4j-core-2.x.jar、logback-classic-1.x.jar）复制到lib目录；
删除原生日志依赖（如javax.servlet.jsp.jstl-api-1.2.1.jar中的JUL依赖）；

添加框架配置文件（如log4j2.xml或logback.xml）到conf目录，配置日志级别、输出格式、处理器等。例如，Log4j 2的log4j2.xml可配置异步日志、滚动策略、日志格式：

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

切换框架后，需重启Tomcat使配置生效。

注意事项

测试环境与生产环境差异：测试环境可保留FINE或FINER级别以方便调试，生产环境务必设置为WARNING及以上，避免日志泄露敏感信息。
重启生效：修改logging.properties或server.xml后，需重启Tomcat才能应用新配置。
监控日志变化：调整级别后，需定期检查日志文件是否按预期过滤，避免遗漏关键信息（如错误日志）。

通过以上步骤，可有效优化Tomcat日志记录级别，实现减少磁盘占用、提升性能、聚焦关键信息的目标。