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）。
• 输出目标
  • 控制台适合开发/排障，生产以文件为主，配合滚动与保留策略，便于审计与回溯。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！