Tomcat日志在Debian中的管理 - 问答

Debian 上 Tomcat 日志管理实践

一日志位置与常见类型

日志默认位于 $CATALINA_BASE/logs，其中 $CATALINA_BASE 为 Tomcat 安装基目录；若未单独设置，通常与 $CATALINA_HOME 一致。Debian 常见安装路径包括 /var/log/tomcat、/var/log/tomcat9 或 /opt/tomcat/logs。常见日志文件与作用如下：
- catalina.out：标准输出与错误输出（常被标准输出重定向到此文件）。
- catalina.YYYY-MM-DD.log：Tomcat 启动、关闭等引擎日志。
- localhost.YYYY-MM-DD.log：本地主机应用日志。
- manager.YYYY-MM-DD.log、host-manager.YYYY-MM-DD.log：管理应用日志。
- 访问日志（Access Log）：需在 conf/server.xml 中通过 AccessLogValve 启用与配置。

二查看与实时分析

常用命令：
- 实时查看：tail -f /var/log/tomcat9/catalina.out
- 关键字过滤：tail -f /var/log/tomcat9/catalina.out | grep “ERROR”
- 历史检索：grep -i “exception” /var/log/tomcat9/catalina.out
- 多文件检索：grep -R “timeout” /var/log/tomcat9/
建议将日志目录加入 logrotate 管理并设置合适的保留周期，避免磁盘被历史日志占满。

三日志轮转方案

推荐方案是使用系统自带的 logrotate 管理 Tomcat 日志（含 catalina.out 与按日期切分的 catalina.*.log 等）。示例配置如下（按实际路径调整）：

示例 A（针对 catalina.out，使用 copytruncate 避免重启/信号）：

/var/log/tomcat9/catalina.out {
    daily
    rotate 7
    compress
    missingok
    notifempty
    copytruncate
    create 640 tomcat adm
}

示例 B（针对按日期切分的日志，使用 USR1 通知重新打开日志文件）：

/var/log/tomcat9/*.log {
    daily
    rotate 30
    compress
    missingok
    notifempty
    sharedscripts
    postrotate
        if [ -f /var/run/tomcat9.pid ]; then
            /bin/kill -USR1 $(cat /var/run/tomcat9.pid)
        fi
    endscript
}

操作步骤与验证：
- 创建或编辑配置文件：/etc/logrotate.d/tomcat9
- 手动测试：sudo logrotate -f /etc/logrotate.d/tomcat9
- 说明：
  - copytruncate 通过复制后清空原文件实现轮转，优点是无需通知 Tomcat；缺点是可能丢失轮转瞬间写入的少量日志。
  - 使用 postrotate + kill -USR1 需要 Tomcat 支持“重新打开日志文件”的信号处理（多数发行包与标准配置支持），优点是文件句柄不中断；若进程不支持，可改用 copytruncate。

四日志级别与访问日志配置

调整日志级别（JULI，编辑 conf/logging.properties）：
- 全局级别示例：.level = INFO
- 按包/类调整示例：
```
1catalina.org.apache.juli.AsyncFileHandler.level = FINE
org.apache.catalina.core.ContainerBase.[Catalina].[localhost].level = DEBUG
java.util.logging.ConsoleHandler.level = WARNING
```
- 修改后需重启 Tomcat 生效：sudo systemctl restart tomcat9。
启用与配置访问日志（编辑 conf/server.xml，在 Engine/Host 内添加或修改 Valve）：
```
<Valve className="org.apache.catalina.valves.AccessLogValve"
       directory="logs"
       prefix="access_log"
       suffix=".txt"
       pattern="%h %l %u %t "%r" %s %b"
       resolveHosts="false"/>
```
- 常用 pattern：
  - common：%h %l %u %t “%r” %s %b
  - combined：在 common 基础上增加 Referer 与 User-Agent。

五备份归档与集中化

本地归档脚本示例（压缩并清理 30 天前日志）：

#!/usr/bin/env bash
LOG_PATH="/var/log/tomcat9"
BACKUP_PATH="/opt/backups/tomcat"
DATE=$(date +%F)
mkdir -p "$BACKUP_PATH"
tar czf "$BACKUP_PATH/tomcat_logs_$DATE.tar.gz" -C "$LOG_PATH" .
find "$LOG_PATH" -name "*.gz" -mtime +30 -delete

通过 crontab 每日执行（示例：0 2 * * * /opt/scripts/backup_tomcat_logs.sh）。

集中化与分析：
- 使用 ELK Stack（Elasticsearch/Logstash/Kibana） 或 Graylog 收集、检索与可视化日志。
- 结合日志告警规则，对 ERROR、OutOfMemoryError 等进行主动通知。

0 赞

0 踩