如何设置Tomcat日志级别

如何设置Tomcat日志级别

Tomcat的日志级别设置主要通过修改logging.properties配置文件实现，该文件位于<Tomcat安装目录>/conf目录下，用于控制日志输出的级别、处理器及格式。以下是具体操作步骤：

1. 找到Tomcat日志配置文件

Tomcat的核心日志配置文件为conf/logging.properties，所有日志级别的调整均在此文件中进行。此外，conf/server.xml可辅助配置访问日志等参数，但非日志级别的核心配置文件。

2. 理解Tomcat日志级别

Tomcat采用Java标准日志框架（java.util.logging），支持的日志级别从低到高依次为：

• OFF：关闭所有日志记录（生产环境慎用）；
• SEVERE：记录严重错误（如系统崩溃）；
• WARNING：记录潜在问题（如内存不足警告）；
• INFO：记录常规运行信息（如服务启动/停止，默认级别）；
• CONFIG：记录配置信息（如加载的配置文件）；
• FINE：记录详细调试信息（如请求处理细节）；
• FINER：记录更详细的调试信息（如SQL执行日志）；
• FINEST：记录最详细的调试信息（如线程堆栈跟踪）。

建议：生产环境推荐使用INFO或WARNING级别，避免因FINE及以上级别产生过多日志影响性能；开发或排查问题时可临时调整为FINE或FINER。

3. 修改logging.properties文件

(1) 设置根日志级别

找到文件顶部的.level配置项，修改其值为目标级别（如INFO、FINE）。例如，将根日志级别设置为INFO：

.level = INFO

(2) 设置特定组件/包的日志级别

针对特定组件（如Catalina容器、数据库驱动、应用包）单独调整日志级别，格式为：
<组件全限定名>.level = <级别>
常见组件示例：

• Catalina容器（记录Tomcat核心运行信息）：

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

• 数据库驱动（记录JDBC执行日志，排查SQL问题）：

  java.sql.level = FINE
  

• 应用包（替换com.yourapp为你的应用包名）：

  com.yourapp.level = FINER
  

(3) 配置日志处理器

日志处理器决定日志的输出位置（控制台、文件等），需确保处理器级别不低于组件级别。常见处理器配置：

• 控制台处理器（输出到Tomcat启动/停止的控制台窗口）：

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

• 文件处理器（输出到logs目录下的文件，如catalina.out）：

  1catalina.org.apache.juli.FileHandler.level = INFO
  1catalina.org.apache.juli.FileHandler.directory = ${catalina.base}/logs
  1catalina.org.apache.juli.FileHandler.prefix = catalina.
  

(4) 示例配置

以下是一个完整的logging.properties示例，设置根级别为INFO，Catalina容器级别为FINE，数据库驱动级别为FINE，并输出到控制台和文件：

# 根日志级别
.level = INFO

# 控制台处理器
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

# Catalina容器文件处理器
1catalina.org.apache.juli.FileHandler.level = INFO
1catalina.org.apache.juli.FileHandler.directory = ${catalina.base}/logs
1catalina.org.apache.juli.FileHandler.prefix = catalina.

# 数据库驱动日志级别
java.sql.level = FINE

4. 重启Tomcat使配置生效

修改logging.properties后，必须重启Tomcat才能应用新配置。根据操作系统执行以下命令：

• Windows：

  <Tomcat安装目录>\bin\shutdown.bat
  <Tomcat安装目录>\bin\startup.bat
  

• Linux/macOS：

  $CATALINA_HOME/bin/shutdown.sh
  $CATALINA_HOME/bin/startup.sh
  

5. 验证日志级别设置

重启后，检查<Tomcat安装目录>/logs目录下的日志文件（如catalina.out、localhost.log），确认日志输出是否符合预期。例如，若将Catalina容器级别设置为FINE，应能看到详细的请求处理日志（如Servlet初始化、请求转发等信息）。

注意事项

• 生产环境谨慎降低级别：FINE及以上级别会产生大量日志，可能占用磁盘空间并影响Tomcat性能；
• 针对性调整：仅对需要调试的组件（如特定应用包、数据库驱动）降低日志级别，而非全局设置；
• 结合其他工具：如需更强大的日志管理（如日志轮转、远程传输），建议集成Log4j或Logback等第三方日志框架。