如何配置Tomcat的访问日志

一、启用Tomcat访问日志（核心配置）
Tomcat的访问日志通过server.xml中的AccessLogValve组件实现，默认情况下该组件可能被注释。需编辑${catalina.base}/conf/server.xml（${catalina.base}为Tomcat安装目录），找到<Host>标签，在其内部添加或取消注释以下配置：

<Valve className="org.apache.catalina.valves.AccessLogValve" 
       directory="logs" 
       prefix="localhost_access_log" 
       suffix=".txt" 
       pattern="%h %l %u %t \"%r\" %s %b" 
       resolveHosts="false"/>

• 关键属性说明：
  • directory：日志存储目录（相对路径为Tomcat的logs目录，绝对路径如/var/log/tomcat更推荐）；
  • prefix：日志文件名前缀（如localhost_access_log）；
  • suffix：日志文件名后缀（如.txt，可改为.log）；
  • pattern：日志格式（详见下文“二、自定义日志格式”）；
  • resolveHosts：是否解析客户端主机名（false表示仅记录IP，提升性能）。

二、自定义日志格式（pattern属性详解）
pattern通过占位符定义日志内容，常见占位符及含义如下：

• %h：远程客户端IP地址；
• %l：远程逻辑用户名（通常为-，无实际意义）；
• %u：认证后的远程用户（未认证则为-）；
• %t：请求时间（格式为[day/month/year:hour:minute:second zone]，如[10/Oct/2025:14:30:00 +0800]）；
• "%r"：HTTP请求行（包含方法、URI、协议，如"GET /index.html HTTP/1.1"）；
• %s：HTTP响应状态码（如200、404）；
• %b：响应大小（字节，未发送内容则为-）；
• %D：处理请求耗时（毫秒）；
• %{User-Agent}i：客户端浏览器信息（需指定i表示请求头）。

常用组合示例：

• 基础格式（默认）：%h %l %u %t \"%r\" %s %b（记录IP、时间、请求、状态码、响应大小）；
• 包含耗时：%h %l %u %t \"%r\" %s %b %D（增加处理时间）；
• 包含浏览器信息：%h %l %u %t \"%r\" %s %b \"%{User-Agent}i\"（增加浏览器类型）。

三、调整日志存储路径与文件名
通过directory和prefix属性可自定义日志存储位置及文件名：

• 修改存储路径：将directory设置为绝对路径（如directory="/var/log/tomcat"），需确保Tomcat进程对该目录有写入权限（可通过chown -R tomcat:tomcat /var/log/tomcat赋权）；
• 修改文件名：prefix可改为业务相关的名称（如prefix="myapp_access_log"），suffix可改为.log（如suffix=".log"），便于分类管理。

四、设置日志级别（可选，辅助排查问题）
访问日志的详细程度可通过logging.properties（位于conf目录）调整，但需注意：AccessLogValve的日志级别默认为INFO，无需额外配置即可输出完整日志。若需调整其他组件的日志级别（如org.apache.catalina），可添加或修改以下内容：

org.apache.catalina.level = FINE  # 设置为FINE可输出更详细的运行日志（如请求处理细节）
handlers = 1catalina.org.apache.juli.AsyncFileHandler, ...  # 异步日志处理器（提升性能）

修改后需重启Tomcat使配置生效。

五、启用日志轮转（避免日志过大）
为防止日志文件占用过多磁盘空间，可通过logrotate工具实现自动轮转（以Debian/Ubuntu为例）：

1. 创建/etc/logrotate.d/tomcat配置文件，内容如下：

   /var/log/tomcat/*.log {
       daily                   # 每天轮转
       rotate 30               # 保留30天日志
       compress                # 压缩旧日志（如.gz格式）
       missingok               # 日志不存在时不报错
       notifempty              # 日志为空时不轮转
       create 0644 tomcat tomcat  # 新日志文件权限及所有者
       sharedscripts           # 所有日志轮转完成后执行脚本
       postrotate
           systemctl restart tomcat >/dev/null 2>&1 || true
       endscript
   }
   

2. 测试配置是否正确：logrotate -d /etc/logrotate.d/tomcat（模拟轮转）；
3. 手动触发轮转：logrotate -f /etc/logrotate.d/tomcat。

六、验证配置生效

1. 重启Tomcat服务：systemctl restart tomcat（或./bin/shutdown.sh && ./bin/startup.sh）；
2. 查看日志文件：tail -f /var/log/tomcat/localhost_access_log.txt（根据实际路径调整）；
3. 发起测试请求（如用浏览器访问http://localhost:8080），确认日志中是否有对应的访问记录。