温馨提示×

Debian如何配置Tomcat日志

小樊
53
2026-07-13 08:58:18
栏目: 智能运维

在 Debian 上配置 Tomcat 日志,主要涉及 logging.propertiesserver.xml 以及可选的 logrotate。下面按常见场景说明。


一、Tomcat 日志类型说明

Tomcat 常见日志有 4 类:

  1. catalina.out

    • 标准输出和错误输出
    • 默认不轮转,容易变大
  2. catalina.{date}.log

    • Tomcat 运行日志(启动、关闭等)
  3. localhost.{date}.log

    • 应用级异常日志
  4. access log(访问日志)

    • 类似 Nginx access.log

二、Tomcat 日志配置文件位置

Debian 常见路径(以 Tomcat 9 为例):

/etc/tomcat9/
/usr/share/tomcat9/
/var/log/tomcat9/
/var/lib/tomcat9/

日志配置主要文件:

/etc/tomcat9/logging.properties

三、配置 logging.properties(核心)

编辑:

sudo nano /etc/tomcat9/logging.properties

1️⃣ 修改日志级别

常见级别(由低到高):

FINEST < DEBUG < INFO < WARN < ERROR < FATAL

示例(只显示 INFO 及以上):

.level = INFO
org.apache.catalina.level = INFO
org.apache.juli.level = INFO

2️⃣ 配置日志文件大小 & 轮转(JULI)

Tomcat 使用 JULI(Java Utility Logging Implementation)

示例:

1catalina.org.apache.juli.AsyncFileHandler.limit = 10485760
1catalina.org.apache.juli.AsyncFileHandler.count = 10
1catalina.org.apache.juli.AsyncFileHandler.pattern = /var/log/tomcat9/catalina.%g.log

说明:

  • limit:单个日志大小(字节,10MB)
  • count:保留文件数
  • %g:轮转编号

四、配置 access log(访问日志)

编辑 server.xml

sudo nano /etc/tomcat9/server.xml

<Host> 中添加:

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

✅ 常用参数:

  • pattern:日志格式(可改成 combined)
  • maxDays:保留天数
  • rotatable:是否按天轮转

五、处理 catalina.out(非常重要)

Debian 默认 catalina.out 不会自动切割,容易撑满磁盘。

✅ 方法 1:使用 logrotate(推荐)

创建配置:

sudo nano /etc/logrotate.d/tomcat9

内容示例:

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

测试:

sudo logrotate -d /etc/logrotate.d/tomcat9

✅ 方法 2:禁用 catalina.out(不推荐)

修改 systemd 服务:

sudo systemctl edit tomcat9

添加:

[Service]
StandardOutput=null
StandardError=journal

⚠️ 会丢失部分输出日志


六、重启 Tomcat

sudo systemctl restart tomcat9

查看日志:

tail -f /var/log/tomcat9/catalina.out

七、常见问题排查

1️⃣ 日志不生效?

  • 确认修改的是 /etc/tomcat9/logging.properties
  • 重启 Tomcat
  • 检查文件权限
sudo chown -R tomcat9:tomcat9 /var/log/tomcat9

2️⃣ 想用 Log4j / Logback?

  • Tomcat 本身不推荐替换 JULI
  • Web 应用内可单独使用 Logback

八、总结(推荐配置)

✅ 生产环境建议:

  • 使用 logging.properties 控制级别
  • 开启 access log
  • 使用 logrotate 管理 catalina.out
  • 日志保留 7–30 天

如果你愿意,可以告诉我:

  • Tomcat 版本(8 / 9 / 10)
  • 系统安装 还是 解压版
  • 是否用于 生产环境

我可以给你一份 可直接使用的完整配置

0