Ubuntu Java日志级别如何设置合理

Ubuntu上Java日志级别合理设置指南

一核心原则与级别选择

明确目标：区分生产与开发/排障场景，生产以可读性+稳定性为先，排障期可临时提升细节。
级别从高到低常用为：SEVERE > WARNING > INFO > CONFIG > FINE > FINER > FINEST（JUL）；或 FATAL > ERROR > WARN > INFO > DEBUG > TRACE（Log4j/Logback）。只有“大于等于”设定级别的事件才会被输出。
推荐基线：生产将Root设为INFO；仅对问题模块临时调到DEBUG/TRACE；第三方框架保持WARN/ERROR避免刷屏。
性能提示：日志参数拼接代价高，优先使用延迟求值（如 JUL 的 logger.info(() -> "msg " + expensive())）。

二按常见日志框架的配置要点

若不确定用哪种框架，先查看依赖：包含 slf4j-api 多为门面，底层常见 Logback；包含 log4j-core 为 Log4j2；无第三方依赖多为 JUL。
通用做法：用配置文件管理级别，避免改代码；必要时通过启动参数或 JMX/管理接口动态调整。

表：常见框架在 Ubuntu 的推荐做法与示例

JUL（java.util.logging）

推荐：控制台WARNING，文件INFO；排障时把 Logger 与 Handler 都调到FINE/FINER。

示例：

文件：创建 /opt/app/logging.properties

handlers=java.util.logging.ConsoleHandler,java.util.logging.FileHandler
.level=INFO
java.util.logging.ConsoleHandler.level=WARNING
java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter
java.util.logging.FileHandler.pattern=/var/log/myapp/app.log
java.util.logging.FileHandler.limit=10485760
java.util.logging.FileHandler.count=10
java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter

启动：java -Djava.util.logging.config.file=/opt/app/logging.properties -jar app.jar

Logback（SLF4J 常用实现）

推荐：控制台INFO，滚动文件INFO；问题包单独设为DEBUG。

示例：src/main/resources/logback.xml

<configuration>
  <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder><pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder>
  </appender>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>/var/log/myapp/app.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>/var/log/myapp/app.%d{yyyy-MM-dd}.gz</fileNamePattern>
      <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder>
  </appender>
  <logger name="com.example" level="DEBUG" additivity="false"><appender-ref ref="CONSOLE"/></logger>
  <root level="INFO"><appender-ref ref="CONSOLE"/><appender-ref ref="FILE"/></root>
</configuration>

Log4j2

推荐：控制台INFO，滚动文件INFO；排障期 Root 或问题包调到DEBUG。

示例：src/main/resources/log4j2.xml

<Configuration status="WARN">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
    </Console>
    <RollingFile name="RollingFile" fileName="/var/log/myapp/app.log"
                 filePattern="/var/log/myapp/app-%d{yyyy-MM-dd}-%i.log.gz">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
      <Policies><SizeBasedTriggeringPolicy size="10MB"/></Policies>
      <DefaultRolloverStrategy max="10"/>
    </RollingFile>
  </Appenders>
  <Loggers>
    <Logger name="com.example" level="DEBUG" additivity="false"><AppenderRef ref="Console"/></Logger>
    <Root level="INFO"><AppenderRef ref="Console"/><AppenderRef ref="RollingFile"/></Root>
  </Loggers>
</Configuration>

说明：以上示例均为最小可用配置，可按需增加 MDC、异步 Appender、过滤器等。

三 Ubuntu系统层面的落地与运维

文件与目录权限：日志目录（如 /var/log/myapp）建议归属运行用户（如 myapp:myapp），权限 0755/0644，确保进程可写且安全隔离。

日志轮转：

应用内轮转：Logback/Log4j2 已支持按时间/大小滚动，避免单文件过大。

系统级轮转：为落盘文件补充 logrotate（/etc/logrotate.d/myapp）

/var/log/myapp/*.log {
  daily
  rotate 30
  compress
  missingok
  notifempty
  create 0644 myapp myapp
  sharedscripts
  postrotate
    systemctl reload myapp.service >/dev/null 2>&1 || true
  endscript
}

服务化运行：使用 systemd 时，将日志写入 journald 并通过 StandardOutput=journal 或 StandardError=journal 输出；如需落盘，仍建议应用内文件日志+logrotate。
动态调级：生产不建议频繁改配置；可用 JMX（Logback/Log4j2）、或暴露 HTTP 管理端点，在排障窗口临时下调级别，恢复后回到基线。

四快速排障与常见坑

级别不生效的快速排查
- JUL：同时检查 Logger 级别与Handler 级别，最终生效的是两者中“更高”的那个；若需输出 FINE/FINER，务必把 Handler 也调到相同级别。
- 框架差异：Log4j/Logback 只需调整 Logger/Root 级别；第三方库保持 WARN 避免噪声。
性能与成本
- 避免字符串拼接，优先延迟求值；高吞吐场景考虑异步日志（AsyncAppender/Async）。
输出目标
- 控制台适合开发/排障，生产以文件为主，配合滚动与保留策略，便于审计与回溯。

最新问答

相关标签