Tomcat日志级别如何设置

Tomcat日志级别设置指南

一 核心概念与级别

• 日志体系分为两部分：一是 Tomcat 自身的运行日志（常见为 catalina、localhost、manager、host-manager），二是 访问日志 Access Log（记录 HTTP 请求）。
• 运行日志采用 JUL（java.util.logging），级别从低到高为：FINEST < FINER < FINE < CONFIG < INFO < WARNING < SEVERE，并支持 ALL / OFF。
• 访问日志不是 JUL 日志，使用 AccessLogValve 输出，常见格式为 common 或 combined，通过 pattern 自定义字段。

二 修改运行日志级别（JUL）

• 配置文件路径：$CATALINA_BASE/conf/logging.properties。
• 常用做法：
  1. 调整全局根日志级别（影响未单独配置的 logger）：
     .level = INFO（生产常用）；调试时可改为 FINE/FINER。
  2. 调整特定组件/包日志级别（示例）：
     1catalina.org.apache.juli.AsyncFileHandler.level = FINE
     2localhost.org.apache.juli.AsyncFileHandler.level = FINE
     org.apache.catalina.startup.level = FINE
     com.yourapp.level = DEBUG（应用自身包，便于定位业务问题）
  3. 同时调整处理器级别（否则处理器可能“拦截”更低级别日志）：
     java.util.logging.ConsoleHandler.level = FINE
     1catalina.org.apache.juli.AsyncFileHandler.level = FINE
  4. 可选：指定输出格式器（如 java.util.logging.SimpleFormatter 或 Tomcat 的 org.apache.juli.OneLineFormatter）。
  5. 使配置生效：重启 Tomcat（Linux 执行 $CATALINA_HOME/bin/shutdown.sh 与 startup.sh）。
  6. 验证：查看 $CATALINA_BASE/logs 下对应日志文件是否出现预期级别的日志。

三 配置访问日志级别与格式

• 访问日志不是通过 JUL 级别控制，而是通过 server.xml 中的 AccessLogValve 的 pattern 决定输出内容与“详略”。
• 启用与示例：
  • 编辑 $CATALINA_BASE/conf/server.xml，在 内添加或启用：
    <Valve className=“org.apache.catalina.valves.AccessLogValve”
    directory=“logs”
    prefix=“localhost_access_log”
    suffix=“.txt”
    pattern=“%h %l %u %t “%r” %s %b” />
  • 常用 pattern：
    • common：%h %l %u %t %r %s %b
    • combined：在 common 基础上增加 %{Referer}i、%{User-Agent}i
  • 提示：将 resolveHosts 设为 false 可避免 DNS 反查，提高性能；可按需调整 directory/prefix/suffix。

四 常见场景与建议

• 生产环境：根日志建议 INFO，仅对问题模块临时调到 FINE/FINER；访问日志使用 combined 便于排查来源与 UA。
• 启动阶段排错：可临时将 org.apache.catalina.startup、org.apache.catalina.core 相关 logger 调到 FINE，并开启 ConsoleHandler 观察控制台输出。
• 动态生效需求：JUL 级别通常在重启后生效；如需运行中热调整，可考虑将应用日志接入 Log4j/Logback 并使用其动态配置能力（Tomcat 自身运行日志仍以 JUL 为主）。