Tomcat日志在Debian中的管理方法

Debian 下 Tomcat 日志管理实操指南

一 日志位置与类型

• 日志默认位于 $CATALINA_BASE/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：管理应用日志。
  • 访问日志（若启用）通常为 localhost_access_log.YYYY-MM-DD.txt，由 AccessLogValve 生成。
• 快速查看常用命令：
  • 实时查看：tail -f $CATALINA_BASE/logs/catalina.out
  • 关键字过滤：grep -i “error” $CATALINA_BASE/logs/catalina.out
  • 分页查看：less $CATALINA_BASE/logs/catalina.out
• 注意：$CATALINA_BASE 为实例基目录，未显式设置时通常与 $CATALINA_HOME 一致。

二 日志轮转与保留策略

• 推荐方式一（系统级）：使用 logrotate 管理所有 .log（含 catalina.out）
  1. 新建配置：sudo nano /etc/logrotate.d/tomcat
  2. 示例配置（按实际路径调整）：

     /var/log/tomcat/*.log {
         daily
         missingok
         rotate 7
         compress
         notifempty
         create 640 tomcat adm
     }
     

  3. 测试与生效：
     • 强制执行一次：sudo logrotate -f /etc/logrotate.d/tomcat
     • 日常由 cron 的 daily 任务自动调用（检查 /etc/cron.daily/logrotate 是否存在）。
• 推荐方式二（针对 catalina.out 的稳妥做法）：使用 copytruncate

  $CATALINA_BASE/logs/catalina.out {
      daily
      rotate 7
      compress
      missingok
      notifempty
      copytruncate
      create 640 tomcat adm
  }
  

• 说明：
  • copytruncate 通过“复制后清空”避免重启或信号干预，适合 catalina.out 这类被长期占用的输出流。
  • 若你的 Tomcat 以 systemd 管理且使用 journald 捕获 stdout/stderr，也可将 catalina.out 输出到 journal，再由 journald 的 journalctl 与 systemd-journald 的日志轮转策略管理（需额外配置，此处不展开）。

三 日志级别与格式配置

• 调整日志级别（JUL 配置）
  • 编辑：$CATALINA_BASE/conf/logging.properties
  • 示例：提升本地主机日志级别以便排错

    1catalina.org.apache.juli.AsyncFileHandler.level = FINE
    org.apache.catalina.core.ContainerBase.[Catalina].[localhost].level = FINE
    

  • 使配置生效：重启 Tomcat（如使用 systemd：sudo systemctl restart tomcat）。
• 自定义日志格式
  • ConsoleHandler 示例（简洁单行）：

    java.util.logging.ConsoleHandler.formatter = org.apache.juli.OneLineFormatter
    

  • 也可编写自定义 Formatter 并在配置中指定其全限定类名，以实现完全自定义格式。

四 访问日志配置

• 在 $CATALINA_BASE/conf/server.xml 的 Engine/Host 内添加或修改 AccessLogValve，示例：

  <Valve className="org.apache.catalina.valves.AccessLogValve"
         directory="${catalina.base}/logs"
         prefix="localhost_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
• 修改后重启 Tomcat 生效。

五 备份归档与集中化分析

• 备份归档（示例脚本）
  • 打包当日日志并清理 30 天前历史：

    #!/usr/bin/env bash
    LOG_PATH="/opt/tomcat/logs"
    BACKUP_PATH="/home/backup/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 -e 加入每日执行计划（如：0 0 * * * /path/to/backup_tomcat_logs.sh）。
• 集中化分析
  • 使用 ELK Stack（Elasticsearch/Logstash/Kibana） 或 Graylog 收集、检索与可视化日志，结合告警规则实现异常快速响应。