Debian系统Tomcat日志配置指南

一、Tomcat日志概述

Tomcat的日志分为核心日志（5类）和访问日志两类：

• 核心日志：包括catalina（Catalina引擎日志）、localhost（Tomcat内部代码日志）、manager（Tomcat管理应用日志）、host-manager（虚拟主机管理日志），默认通过logging.properties文件配置。
• 访问日志：记录HTTP请求详情（如客户端IP、请求方法、响应状态码），默认关闭，需通过server.xml文件启用。

二、准备工作

1. 确认Tomcat安装路径：
   Debian系统下，Tomcat通常安装在/usr/share/tomcatX（X为版本号，如9），$CATALINA_BASE指向/var/lib/tomcatX（日志、webapps等目录所在位置）。可通过以下命令确认：

   sudo systemctl status tomcatX 

   输出中的“Main PID”路径即为$CATALINA_BASE。

2. 检查日志目录权限：
   确保Tomcat用户（通常为tomcat）对日志目录有读写权限：

   sudo mkdir -p $CATALINA_BASE/logs sudo chown -R tomcat:tomcat $CATALINA_BASE/logs sudo chmod -R 755 $CATALINA_BASE/logs 

三、配置核心日志（logging.properties）

logging.properties文件位于$CATALINA_BASE/conf目录，主要配置日志级别、处理器（输出位置）、格式等。

1. 修改日志级别

日志级别从高到低为：SEVERE > WARNING > INFO > CONFIG > FINE > FINER > FINEST（ALL表示输出所有日志，OFF表示禁用）。

• 全局日志级别（适用于所有组件）：
  找到.level配置项，修改为所需级别（如INFO或FINE）：

  .level = INFO 

• 特定组件日志级别（如catalina、org.apache.catalina.authenticator）：
  添加或修改对应配置，细化日志输出范围：

  org.apache.catalina.core.ContainerBase.[Catalina].[localhost].level = FINE org.apache.catalina.authenticator.level = FINE 

2. 配置日志处理器

处理器决定日志的输出位置（控制台、文件）和格式。默认处理器为AsyncFileHandler（异步文件输出），需修改其属性：

• 日志目录：将directory设置为$CATALINA_BASE/logs（推荐），避免权限问题：

  1catalina.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs 

• 日志文件前缀：prefix定义文件名前缀（如catalina.）：

  1catalina.org.apache.juli.AsyncFileHandler.prefix = catalina. 

• 日志保留时间：maxDays设置日志文件保留天数（如90天）：

  1catalina.org.apache.juli.AsyncFileHandler.maxDays = 90 

• 日志编码：encoding设置为UTF-8，避免中文乱码：

  1catalina.org.apache.juli.AsyncFileHandler.encoding = UTF-8 

• 控制台输出（可选）：若需在控制台查看日志，修改java.util.logging.ConsoleHandler配置：

  java.util.logging.ConsoleHandler.level = INFO java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter 

3. 应用配置

修改完成后，保存文件并重启Tomcat使配置生效：

sudo systemctl restart tomcatX 

四、配置访问日志（server.xml）

访问日志记录HTTP请求详情，默认关闭。需编辑$CATALINA_BASE/conf/server.xml文件，在<Host>标签内添加或取消注释AccessLogValve配置：

1. 启用访问日志

找到<Host>标签（通常位于server.xml末尾），添加以下内容：

<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"/> 

2. 关键参数说明

• directory：日志文件存放目录（推荐${catalina.base}/logs）。
• prefix：日志文件名前缀（如localhost_access_log）。
• suffix：日志文件名后缀（如.txt）。
• pattern：日志格式，常用选项：
  • %h：客户端IP地址（resolveHosts="false"时）。
  • %t：请求时间（格式：EEE MMM dd HH:mm:ss yyyy）。
  • %r：请求的第一行（方法+URI+协议，如GET /index.html HTTP/1.1）。
  • %s：响应状态码（如200、404）。
  • %b：发送的字节数（不包括HTTP头，0则显示-）。
  • %{User-Agent}i：客户端浏览器信息（需用%{xxx}i引用请求头）。
• resolveHosts：是否将IP转换为域名（false表示直接使用IP，提升性能）。

3. 示例pattern

若需记录更详细的访问信息（如引用页、用户代理），可将pattern修改为：

pattern="%h %l %u %t "%r" %s %b "%{Referer}i" "%{User-Agent}i"" 

4. 应用配置

保存server.xml文件，重启Tomcat使访问日志生效：

sudo systemctl restart tomcatX 

五、验证日志配置

1. 查看核心日志：
   使用tail命令实时查看catalina日志（默认路径：${catalina.base}/logs/catalina.out）：

   tail -f $CATALINA_BASE/logs/catalina.out 

   若配置了文件处理器，可查看catalina.日期.log文件。

2. 查看访问日志：
   访问Tomcat应用（如http://localhost:8080），然后查看访问日志（路径：${catalina.base}/logs/localhost_access_log.日期.txt）：

   tail -f $CATALINA_BASE/logs/localhost_access_log.txt 

   日志内容应包含客户端IP、请求时间、请求方法、响应状态码等信息。

六、日志轮转（可选，推荐）

为防止日志文件过大，可使用logrotate工具定期轮转日志。

1. 安装logrotate

Debian系统默认安装logrotate，若未安装，可通过以下命令安装：

sudo apt-get install logrotate 

2. 创建Tomcat日志轮转配置

创建/etc/logrotate.d/tomcat文件，添加以下内容：

$CATALINA_BASE/logs/catalina.out { daily rotate 14 compress delaycompress missingok notifempty copytruncate } $CATALINA_BASE/logs/*.log { daily rotate 14 compress delaycompress missingok notifempty sharedscripts postrotate systemctl reload tomcatX >/dev/null 2>&1 || true endscript } 

3. 参数说明

• daily：每天轮转一次。
• rotate 14：保留14个备份（超过则删除）。
• compress：压缩旧日志（使用gzip）。
• copytruncate：复制日志文件后清空原文件（避免重启Tomcat）。
• postrotate：轮转后重新加载Tomcat（确保日志继续输出到新文件）。

4. 测试轮转配置

手动触发轮转，检查是否生效：

sudo logrotate -vf /etc/logrotate.d/tomcat 

验证$CATALINA_BASE/logs目录下是否生成压缩的旧日志文件（如catalina.out.1.gz）。

通过以上步骤，您可完成Debian系统下Tomcat日志的配置，实现日志级别调整、访问日志启用、日志轮转等功能，有效监控Tomcat运行状态。