SpringBoot整合Logback日志框架配置全解析

java1234

共 4051字,需浏览 9分钟

 ·

2020-11-06 02:53

点击上方蓝色字体,选择“标星公众号”

优质文章,第一时间送达

  作者 |  天乔巴夏丶

来源 |  urlify.cn/bY3aUf

66套java从入门到精通实战课程分享

本篇要点

  • 介绍什么是Logback

  • 介绍SpringBoot中对logging默认的配置

  • 介绍自定义logback-spring.xml的注意点

一、Logback日志框架介绍

SpringBoot使用 Commons Logging 进行所有内部日志的记录,但默认配置也提供了对常用日志的支持,如 Java Util Logging,Log4J2,和Logback. 每种logger都可以通过配置使用控制台或文件输出日志内容。

Logback是log4j框架的作者开发的新一代日志框架,它效率更高、能够适应诸多的运行环境,同时天然支持SLF4J。

二、SpringBoot与Logback

假设你使用starter启动创建SpringBoot应用,则默认已经导入了spring-boot-starter-logging的依赖,相继也就导入了logback所需要的依赖。

1、默认日志格式

于是,当我们启动SpringBoot应用时,控制台将会显示INFO级别的日志输出。

可以看到,输出内容如下:

  • 日期和时间,精确到毫秒级别。

  • 日志级别:INFO,【日志级别默认从高到低:ERROR,WARN,INFO,DEBUG,TRACE】。

  • 进程ID

  • 分隔符:来标识实际日志消息的开始。

  • 线程名:用方括号括起来(在控制台输出时可能被截断)。

  • 日志记录器名称:这通常是源类名称(通常缩写)。

  • 日志信息

logback是没有FATAL级别的,它对应的就是ERROR。

2、控制台输出

默认的日志配置就是将日志信息显示到控制台,默认情况下,将会显示INFO级别以上的日志信息。你还可以通过使用--debug标志启动debug模式。 

$ java -jar myapp.jar --debug

使用IDEA操作可以编辑Program arguments:--debug。

在application.properties中配置debug=true同样也可以将日志级别调整到DEBUG。

3、文件输出

默认情况下,SpringBoot的日志只会输出到控制台,如果你还想输出到文件中,你需要配置logging.file.namelogging.file.path两个属性。

下面这个表格展示如何组合使用logging.*来达到理想的效果:

logging.file.namelogging.file.pathExampleDescription
(none)(none)
只会输出到控制台
指定文件(none)my.log写入指定的日志文件在当前项目目录下
(none)指定目录log在当前项目下的log目录,写入spring.log文件

日志文件达到10 MB时会触发滚动策略【切分】,默认情况下会记录INFO以上级别的信息。可以使用logging.file.max-size属性更改大小限制。除非已设置logging.file.max-history属性,否则默认情况下将保留最近7天的轮转日志文件。可以使用logging.file.total-size-cap限制日志归档文件的总大小。当日志归档的总大小超过该阈值时,将删除备份。要在应用程序启动时强制清除日志存档,请使用logging.file.clean-history-on-start属性。

4、日志级别

可以使用logging.level设置所有受支持的日志记录器的级别。

logging.level.root=warn
logging.level.org.springframework.web=debug
logging.level.org.hibernate=error

5、日志组

使用logging.group能够将相关的logger组合在一起统一管理日志级别等配置。使用方法如下:

假设定义了group为tomcat:

logging.group.tomcat=org.apache.catalina, org.apache.coyote, org.apache.tomcat

一旦这样定义之后,就可以仅仅通过一行配置,完成相关三个logger的级别配置:

logging.level.tomcat=TRACE

SpringBoot预定义了两个开箱即用的日志组:

NameLoggers
weborg.springframework.core.codecorg.springframework.httporg.springframework.weborg.springframework.boot.actuate.endpoint.weborg.springframework.boot.web.servlet.ServletContextInitializerBeans
sqlorg.springframework.jdbc.coreorg.hibernate.SQLorg.jooq.tools.LoggerListener
# pre-defined
logging.level.web=debug
logging.level.sql=debug

6、自定义log配置

由于日志服务一般都在ApplicationContext创建前就初始化了,它并不是必须通过Spring的配置文件控制。因此通过系统属性和传统的Spring Boot外部配置文件依然可以很好的支持日志控制和管理。

你可以根据你的日志系统,按照下面表格的定义规则,选择定义对应的日志配置:

Logging SystemCustomization
Logbacklogback-spring.xmllogback-spring.groovylogback.xml, or logback.groovy
Log4j2log4j2-spring.xml or log4j2.xml
JDK (Java Util Logging)logging.properties

SpringBoot官方推荐使用带有-spring的文件名作为配置,如logback-spring.xml而不是logback.xml

这样命名的好处在于:因为标准的logback.xml配置文件加载得太早,所以不能在其中使用扩展,需要使用logback-spring.xml

当然上面是默认的命名规则,如果你想自定义xml的名称,自定义路径,可以通过logging.config属性配置:logging.config=classpath:logging-config.xml

三、logback-spring.xml自定义注意事项

接下来分享一份配置十分详细的logback.xml配置,参照注释,应该就能够掌握xml的定义。

"1.0" encoding="UTF-8"?>
"true" scanPeriod="10 seconds" debug="false">
    
    
    
    
    logback
    
    "log.path" value="log" />
    "console_log_pattern"
              value="%black(%contextName-) %red(%d{yyyy-MM-dd HH:mm:ss}) %green([%thread]) %highlight(%-5level) %boldMagenta(%logger{36}) - %gray(%msg%n)"/>
    "charset" value="UTF-8"/>
    
    "console" class="ch.qos.logback.core.ConsoleAppender">
        
        
         "ch.qos.logback.classic.filter.ThresholdFilter">
             DEBUG
         
        
            ${console_log_pattern}
        

    

    
    "info_file" class="ch.qos.logback.core.rolling.RollingFileAppender">
        "ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            ${log.path}/roll_info/logback.%d{yyyy-MM-dd}.log
        
        
            ${console_log_pattern}
            ${charset}
        

        
        "ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            
            ${log.path}/info/log-info-%d{yyyy-MM-dd}.%i.log
            "ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                100MB
            
            
            15
        
        
        "ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
            10MB
        
        
        "ch.qos.logback.classic.filter.LevelFilter">
            INFO
            ACCEPT
            DENY
        
    
    
    "warn_file" class="ch.qos.logback.core.rolling.RollingFileAppender">
    
    
    "error_file" class="ch.qos.logback.core.rolling.RollingFileAppender">
    

    
    "info">
        "console" />
        "info_file" />
        "warn_file"/>
        "error_file"/>
    

    
    
    "com.hyh.logback.web.LogTestController" level="WARN" additivity="false">
        "console"/>
        "warn_file"/>
        "error_file"/>
    

    
    
    "dev">
        
        "com.hyh.logback.web" level="DEBUG">
            "console"/>
        
        
        "INFO">
            "console"/>
        
    

最终的效果,会在项目路径下生成日志文件:/log/info/log-info-2020-11-01.0.log,并且日志文件的策略也在xml中定义。

控制台打印信息,如下图所示:

配置文件下载

本文内容均为对优秀博客及官方文档总结而得,原文地址均已在文中参考阅读处标注。最后,文中的代码及配置文件详细样例已经全部上传至Gitee:https://gitee.com/tqbx/springboot-samples-learn

参考阅读

  • 嘟嘟:默认日志logback配置解析

  • SpringBoot官方文档:Log Format

  • Logback官方文档




粉丝福利:实战springboot+CAS单点登录系统视频教程免费领取

???

?长按上方微信二维码 2 秒
即可获取资料



感谢点赞支持下哈 

浏览 30
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报