Ubuntu Tomcat日志如何查看与分析

Ubuntu Tomcat日志查看与分析

一 日志位置与类型

• 常见日志目录为：$CATALINA_HOME/logs（Tomcat安装目录下的 logs），或发行版包安装的 /var/log/tomcat。
• 关键日志文件与作用如下：

• 如何确认目录：
  • 查看环境变量：echo $CATALINA_HOME
  • 若为系统包安装，常见路径为：/var/log/tomcat
• 访问日志路径与命名可在 conf/server.xml 的 AccessLogValve 中通过 directory/prefix/suffix 配置。

二 快速查看与过滤

• 实时查看：
  • tail -f $CATALINA_HOME/logs/catalina.out
  • 若使用 systemd 管理：sudo journalctl -u tomcat.service -f
• 分页浏览：
  • less $CATALINA_HOME/logs/catalina.out（支持搜索：/关键字，n/N 跳转）
• 关键字过滤：
  • 错误关键字：grep -i "error\|exception\|fail" $CATALINA_HOME/logs/catalina.out
  • 某天日志：grep "^2025-03-26" $CATALINA_HOME/logs/catalina.out
• 统计与排查：
  • 统计错误行数：grep -i "error" $CATALINA_HOME/logs/catalina.out | wc -l
  • 按时间窗口提取（catalina.out 每行以日期开头时）：
    sed -n '/^2025-03-26/,/^2025-03-27/p' $CATALINA_HOME/logs/catalina.out > catalina_20250326.out
• 访问日志快速分析（示例）：
  • Top 10 客户端 IP：awk '{print $1}' $CATALINA_HOME/logs/localhost_access_log.*.txt | sort | uniq -c | sort -nr | head
  • 统计 5xx 响应：awk '$9 >= 500 {print $9}' $CATALINA_HOME/logs/localhost_access_log.*.txt | sort | uniq -c | sort -nr
  • 平均响应时间（单位：毫秒，按请求行末的时间字段计算）：
    awk -F'"' '{sum+=$NF; n++;} END {print "avg ms:", sum/n}' $CATALINA_HOME/logs/localhost_access_log.*.txt

三 定位常见问题的思路

• 启动失败或刚启动即退出：优先查看 catalina.out（是否有 OutOfMemoryError、类冲突、端口占用等），并配合 catalina.yyyy-MM-dd.log 的启动阶段日志。
• 应用报错但页面无信息：查看 localhost.yyyy-MM-dd.log（应用初始化异常、未捕获异常堆栈）。
• 访问异常或性能问题：查看 localhost_access_log.yyyy-MM-dd.txt（状态码分布、慢请求、异常流量）。
• 管理后台问题：查看 manager.log / host-manager.log。
• 端口与进程检查：
  • 进程：ps aux | grep tomcat
  • 端口：ss -ltnp | grep 8080 或 netstat -tulpen | grep 8080
• 配置核对：检查 conf/server.xml（连接器、编码、Valve 配置等）与应用的 web.xml / logback/log4j 配置是否一致。
• 编码问题：若日志或页面出现乱码，确认 server.xml 中 Connector 的 URIEncoding=“UTF-8”，并检查系统 locale（如 locale、export LANG=en_US.UTF-8）。

四 日志轮转与清理

• 使用 logrotate（推荐）：创建 /etc/logrotate.d/tomcat，示例：

  /opt/tomcat/logs/catalina.out {
      daily
      rotate 7
      compress
      missingok
      notifempty
      copytruncate
  }
  

  说明：按天轮转、保留 7 天、压缩归档；copytruncate 适用于持续写入的 catalina.out。
• 使用 cronolog 按日期分割访问日志：在 server.xml 的 AccessLogValve 中使用类似 prefix="localhost_access_log." suffix=".txt" pattern="common" directory="logs" rotatable="true"/> 的方式由外部工具按日期生成新文件。
• 集中采集与展示：通过 Rsyslog imfile 将 Tomcat 日志发送到 ELK/Graylog 等集中平台，便于检索、告警与可视化。

五 日志级别与输出控制

• 调整 JUL（java.util.logging） 级别：编辑 $CATALINA_HOME/conf/logging.properties，例如将某些处理器或根日志级别调整为 WARNING/ERROR 以减少输出，或为特定包设置 FINE/DEBUG 以输出更详细日志：

  handlers = 1catalina.org.apache.juli.FileHandler, java.util.logging.ConsoleHandler
  java.util.logging.ConsoleHandler.level = INFO
  java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
  # 示例：将某包日志级别调为 FINE
  com.example.level = FINE
  

• 应用自身日志框架（如 Log4j2/Logback）请在应用的 log4j2.xml / logback.xml 中独立配置，避免与 JUL 配置冲突。