优化Ubuntu Tomcat日志记录的方法

优化Ubuntu Tomcat日志记录的方法

1. 调整日志级别，减少不必要的日志输出

日志级别决定了Tomcat记录日志的详细程度，默认的INFO级别会生成大量常规操作日志，增加磁盘占用和查找成本。可根据需求调整为更高级别：

WARNING：仅记录警告及以上级别的日志（如资源不足、配置问题），适合生产环境日常运行；
ERROR：仅记录错误级别的日志（如应用崩溃、数据库连接失败），进一步减少日志量；
FATAL：仅记录致命错误（如JVM崩溃），适合极端性能敏感场景。
修改路径：Tomcat安装目录下的conf/logging.properties文件，调整核心日志记录器的级别（如org.apache.catalina.level、org.apache.catalina.startup.level）。修改后需重启Tomcat使配置生效。

2. 配置日志轮转，防止日志文件无限增长

日志轮转可自动分割、压缩旧日志，避免单个日志文件过大占用磁盘空间。推荐使用系统自带的logrotate工具：

创建或编辑/etc/logrotate.d/tomcat配置文件，添加以下内容（以Tomcat 9为例）：

/var/log/tomcat9/*.log {
    daily                # 每天轮转一次
    missingok            # 日志文件丢失时不报错
    rotate 7             # 保留最近7个轮转文件
    compress             # 压缩旧日志（节省空间）
    notifempty           # 日志为空时不轮转
    create 640 tomcat adm # 新日志文件权限及属主（需根据实际Tomcat用户调整）
    sharedscripts        # 多个日志文件匹配时只执行一次postrotate
    postrotate
        if [ -f /var/run/tomcat9.pid ]; then
            sudo kill -USR1 `cat /var/run/tomcat9.pid` # 通知Tomcat重新打开日志文件
        fi
    endscript
}

测试配置：运行sudo logrotate -f /etc/logrotate.d/tomcat，检查是否有错误；logrotate默认每天自动运行（可通过/etc/logrotate.conf调整频率）。

3. 启用异步日志记录，提升应用性能

同步日志记录会阻塞应用线程，直到日志写入磁盘，影响高并发场景下的性能。Tomcat 8及以上版本支持异步日志（AsyncFileHandler）：

修改conf/logging.properties文件，将默认的ConsoleHandler或FileHandler替换为AsyncFileHandler，例如：

handlers = 1catalina.org.apache.juli.AsyncFileHandler, 2localhost.org.apache.juli.AsyncFileHandler, 3manager.org.apache.juli.AsyncFileHandler, 4host-manager.org.apache.juli.AsyncFileHandler
1catalina.org.apache.juli.AsyncFileHandler.level = FINE
1catalina.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
1catalina.org.apache.juli.AsyncFileHandler.prefix = catalina.
1catalina.org.apache.juli.AsyncFileHandler.rotatable = true
1catalina.org.apache.juli.AsyncFileHandler.maxDays = 30

异步日志通过队列将日志写入操作交给后台线程处理，减少应用线程的等待时间，提升吞吐量。

4. 配置Tomcat访问日志，记录用户请求详情

访问日志可记录用户的HTTP请求信息（如IP、URL、响应状态、耗时），用于分析用户行为、排查性能问题。需在conf/server.xml中配置AccessLogValve：

<Valve className="org.apache.catalina.valves.AccessLogValve"
       directory="logs"               # 日志目录（相对于Tomcat根目录）
       prefix="localhost_access_log"  # 日志文件前缀
       suffix=".txt"                  # 日志文件后缀
       rotatable="true"               # 启用轮转
       maxDays="30"                   # 保留30天
       pattern="%h %l %u %t "%r" %s %b" /> # 日志格式（包含IP、用户、时间、请求、状态码、响应大小）

pattern常用变量说明：%h（客户端IP）、%r（请求行，如GET /index.html HTTP/1.1）、%s（响应状态码）、%b（响应大小，单位字节）。

5. 限制特定组件的日志输出，聚焦关键信息

某些组件（如启动过程、第三方库）的详细日志可能干扰问题排查，可通过logging.properties限制其日志级别：

示例：将org.apache.catalina.startup（启动日志）设置为WARNING，减少启动时的冗余信息：
```
org.apache.catalina.startup.level = WARNING
```
示例：将第三方库（如org.hibernate）的日志级别设置为ERROR，避免过多的SQL调试日志：
```
org.hibernate.level = ERROR
```
针对特定组件的日志限制，可快速定位核心问题，减少日志噪音。

6. 结合日志分析工具，提升日志价值

原始日志数据难以直接用于分析，可使用工具进行集中管理和可视化：

基础工具：使用grep、awk、tail -f等命令行工具快速查找关键字（如grep "ERROR" /var/log/tomcat9/catalina.out）；
高级工具：使用ELK Stack（Elasticsearch+Logstash+Kibana）或Graylog搭建日志分析平台，实现日志的集中存储、实时搜索、可视化 dashboard（如展示错误日志趋势、用户请求耗时分布）；
监控集成：将日志与Prometheus、Grafana等监控工具结合，通过日志中的指标（如错误率、响应时间）触发告警，提前发现系统问题。