idea2021.1版本SpringBoot项目日志的说明及使用

Posted 小志的博客

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了idea2021.1版本SpringBoot项目日志的说明及使用相关的知识,希望对你有一定的参考价值。

目录

一、log4j与logback的关系

  • log4j与logback两个框架的作者是同一个人,Logback旨在作为流行的log4j项目的后续版本,从而恢复log4j离开的位置。
  • slf4j(Simple Logging Facade for Java) 则是一个日志门面框架,提供了日志系统中常用的接口,logback 和 log4j 则对slf4j 进行了实现。

二、为什么使用logback

  • Logback 是log4j 框架的作者开发的新一代日志框架,它效率更高、能够适应诸多的运行环境,同时天然支持SLF4J。
  • Logback的定制性更加灵活,同时也是spring boot的内置日志框架。

三、SpringBoot项目对logback的使用

3.1、添加依赖

  • maven依赖中添加spring-boot-starter-logging依赖包。

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-logging</artifactId>
    </dependency>
    
  • 但是实际开发中我们不需要直接添加spring-boot-starter-logging依赖,因为spring-boot-starter中包含了 spring-boot-starter-logging,该依赖内容就是 Spring Boot 默认的日志框架 Logback+SLF4J。而 spring-boot-starter-web 包含了spring-boot-starter,所以我们只需要引入web组件即可:

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    

3.2、默认配置

  • 默认情况下Spring Boot将日志输出到控制台,不会写到日志文件。如下图所示:

  • 如果要编写除控制台输出之外的日志文件,则需在application.yml中设置logging.file.path或logging.path.name属性

四、logback-spring.xml详解

4.1、logback-spring.xml的概述

  • Spring Boot官方推荐优先使用带有-spring的文件名作为你的日志配置(如使用logback-spring.xml,而不是logback.xml),命名为logback-spring.xml的日志配置文件,将xml放至 src/main/resource下面。
  • 也可以使用自定义的名称,比如logback-config.xml,只需要在application.yml文件中使用logging.config=classpath:logback-config.xml指定即可。

4.2、logback-spring.xml中的三个主要类

  • Logback基于三个主要类:Logger,Appender和Layout。这三种类型的组件协同工作,使开发人员能够根据消息类型和级别记录消息,并在运行时控制这些消息的格式以及报告的位置。

  • 如下配置是一个最基本的xml配置:

    <configuration>
     
      <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
          <pattern>%dHH:mm:ss.SSS [%thread] %-5level %logger36 - %msg%n</pattern>
        </encoder>
      </appender>
     
      <logger name="chapters.configuration" level="INFO"/>
     
      <root level="DEBUG">          
        <appender-ref ref="STDOUT" />
      </root>  
      
    </configuration>
    

4.3、日志级别

  • 日志级别依次为【从高到低】:FATAL > ERROR > WARN > INFO > DEBUG > TRACE

4.4、< configuration>元素

  • logback-spring.xml配置文件的基本结构可以描述为元素,包含零个或多个< appender>元素、零个或多个< logger>元素、最多一个< root>元素(也可以没有)。

  • 基本结构图解如下:

4.5、< logger>元素

  • < logger>元素只接受一个必需的name属性,一个可选的level属性和一个可选的additivity属性,允许值为true或false。level属性的值允许一个不区分大小写的字符串值TRACE、DEBUG、INFO、WARN、ERROR、ALL或OFF。
  • 元素可以包含零个或多个< appender-ref>元素,这样引用的每个appender都被添加到指定的logger中。

4.6、< root>元素

  • < root>元素配置根记录器。它支持单个属性,即level属性。它不允许任何其他属性,因为additivity标志不适用于根记录器。此外,由于根记录器已被命名为“ROOT”,因此它也不允许使用name属性。
  • level属性的值可以是不区分大小写的字符串TRACE、DEBUG、INFO、WARN、ERROR、ALL或OFF之一,< root>元素可以包含零个或多个< appender-ref>元素; 这样引用的每个appender都被添加到根记录器中。

4.7、< appender>元素

  • appender使用< appender>元素配置,该元素采用两个必需属性name和class。name属性指定appender的名称,而class属性指定要实例化的appender类的完全限定名称。

  • < appender>元素可以包含零个或一个< layout>元素,零个或多个< encoder>元素以及零个或多个< filter>元素.

  • 在logback中,输出目标称为appender,addAppender方法将appender添加到给定的记录器logger。给定记录器的每个启用的日志记录请求都将转发到该记录器中的所有appender以及层次结构中较高的appender。换句话说,appender是从记录器层次结构中附加地继承的。具体如下图所示:

  • Appender是一个接口,它有许多子接口和实现类,具体如下图所示:

  • 其中最重要的两个Appender为:ConsoleAppender 、RollingFileAppender。

4.7.1、ConsoleAppender

  • ConsoleAppender,如名称所示,将日志输出到控制台上。

4.7.2、RollingFileAppender

  • RollingFileAppende是FileAppender的一个子类,扩展了FileAppender,具有翻转日志文件的功能。例如,RollingFileAppender 可以记录到名为log.txt文件的文件,并且一旦满足某个条件,就将其日志记录目标更改为另一个文件。

4.7.3、滚动策略

  • TimeBasedRollingPolicy:可能是最受欢迎的滚动策略。它根据时间定义翻转策略,例如按天或按月。实际上,TimeBasedTriggeringPolicy实现了RollingPolicy和TriggeringPolicy接口。
  • SizeAndTimeBasedRollingPolicy:按日期归档文件同时限制每个日志文件的大小,logback 提供了 SizeAndTimeBasedRollingPolicy ,它是TimeBasedRollingPolicy的一个子类,实现了基于时间和日志文件大小的翻滚策略。

4.8、< encoder>元素

  • encoder中最重要就是pattern属性,它负责控制输出日志的格式,这里给出一个我自己写的示例:

  • 词语解释

    语法解释
    %dyyyy-MM-dd HH:mm:ss.SSS日期
    %-5level日志级别
    %highlight()颜色,info为蓝色,warn为浅红,error为加粗红,debug为黑色
    %thread打印日志的线程
    %15.15()如果记录的线程字符长度小于15(第一个)则用空格在左侧补齐,如果字符长度大于15(第二个),则从开头开始截断多余的字符
    %logger日志输出的类名
    %-40.40()如果记录的logger字符长度小于40(第一个)则用空格在右侧补齐,如果字符长度大于40(第二个),则从开头开始截断多余的字符
    %cyan颜色
    %msg日志输出内容
    %n换行符

4.9、< filter>元素

  • filter中最重要的两个过滤器为:LevelFilter、ThresholdFilter。

  • LevelFilter 根据精确的级别匹配过滤事件。如果事件的级别等于配置的级别,则筛选器接受或拒绝该事件,具体取决于onMatch和onMismatch属性的配置。例如下面配置将只打印INFO级别的日志,其余的全部禁止打印输出:

    <configuration>
      <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
          <level>INFO</level>
          <onMatch>ACCEPT</onMatch>
          <onMismatch>DENY</onMismatch>
        </filter>
        <encoder>
          <pattern>
            %-4relative [%thread] %-5level %logger30 - %msg%n
          </pattern>
        </encoder>
      </appender>
      <root level="DEBUG">
        <appender-ref ref="CONSOLE" />
      </root>
    </configuration>
    
  • ThresholdFilter 过滤低于指定阈值的事件。对于等于或高于阈值的事件,ThresholdFilter将在调用其decision()方法时响应NEUTRAL,例如下面的配置将拒绝所有低于INFO级别的日志,只输出INFO以及以上级别的日志:

    <configuration>
      <appender name="CONSOLE"
        class="ch.qos.logback.core.ConsoleAppender">
        <!-- deny all events with a level below INFO, that is TRACE and DEBUG -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
          <level>INFO</level>
        </filter>
        <encoder>
          <pattern>
            %-4relative [%thread] %-5level %logger30 - %msg%n
          </pattern>
        </encoder>
      </appender>
      <root level="DEBUG">
        <appender-ref ref="CONSOLE" />
      </root>
    </configuration>
    

五、详细的logback-spring.xml示例

  • logback-spring.xml配置文件完整实例代码,具体如下所示:

    <?xml version="1.0" encoding="UTF-8"?>
    <configuration debug="true">
     
        <!-- appender是configuration的子节点,是负责写日志的组件。 -->
        <!-- ConsoleAppender:把日志输出到控制台 -->
        <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
            <!-- 默认情况下,每个日志事件都会立即刷新到基础输出流。 这种默认方法更安全,因为如果应用程序在没有正确关闭appender的情况下退出,则日志事件不会丢失。
             但是,为了显着增加日志记录吞吐量,您可能希望将immediateFlush属性设置为false -->
            <!--<immediateFlush>true</immediateFlush>-->
            <encoder>
                <!-- %37():如果字符没有37个字符长度,则左侧用空格补齐 -->
                <!-- %-37():如果字符没有37个字符长度,则右侧用空格补齐 -->
                <!-- %15.15():如果记录的线程字符长度小于15(第一个)则用空格在左侧补齐,如果字符长度大于15(第二个),则从开头开始截断多余的字符 -->
                <!-- %-40.40():如果记录的logger字符长度小于40(第一个)则用空格在右侧补齐,如果字符长度大于40(第二个),则从开头开始截断多余的字符 -->
                <!-- %msg:日志打印详情 -->
                <!-- %n:换行符 -->
                <!-- %highlight():转换说明符以粗体红色显示其级别为ERROR的事件,红色为WARN,BLUE为INFO,以及其他级别的默认颜色。 -->
                <pattern>%dyyyy-MM-dd HH:mm:ss.SSS %highlight(%-5level) --- [%15.15(%thread)] %cyan(%-40.40(%logger40)) : %msg%n</pattern>
                <!-- 控制台也要使用UTF-8,不要使用GBK,否则会中文乱码 -->
                <charset>UTF-8</charset>
            </encoder>
        </appender>
     
        <!-- info 日志-->
        <!-- RollingFileAppender:滚动记录文件,先将日志记录到指定文件,当符合某个条件时,将日志记录到其他文件 -->
        <!-- 以下的大概意思是:1.先按日期存日志,日期变了,将前一天的日志文件名重命名为XXX%日期%索引,新的日志仍然是project_info.log -->
        <!--             2.如果日期没有发生变化,但是当前日志的文件大小超过10MB时,对当前日志进行分割 重命名-->
        <appender name="info_log" class="ch.qos.logback.core.rolling.RollingFileAppender">
            <!--日志文件路径和名称-->
            <File>logs/project_info.log</File>
            <!--是否追加到文件末尾,默认为true-->
            <append>true</append>
            <filter class="ch.qos.logback.classic.filter.LevelFilter">
                <level>ERROR</level>
                <onMatch>DENY</onMatch><!-- 如果命中ERROR就禁止这条日志 -->
                <onMismatch>ACCEPT</onMismatch><!-- 如果没有命中就使用这条规则 -->
            </filter>
            <!--有两个与RollingFileAppender交互的重要子组件。 第一个RollingFileAppender子组件,即RollingPolicy:负责执行翻转所需的操作。
             RollingFileAppender的第二个子组件,即TriggeringPolicy:将确定是否以及何时发生翻转。 因此,RollingPolicy负责什么和TriggeringPolicy负责什么时候.
            作为任何用途,RollingFileAppender必须同时设置RollingPolicyTriggeringPolicy,但是,如果其RollingPolicy也实现了TriggeringPolicy接口,则只需要显式指定前者。-->
            <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
                <!-- 日志文件的名字会根据fileNamePattern的值,每隔一段时间改变一次 -->
                <!-- 文件名:logs/project_info.2017-12-05.0.log -->
                <!-- 注意:SizeAndTimeBasedRollingPolicy中 %i和%d令牌都是强制性的,必须存在,要不会报错 -->
                <fileNamePattern>logs/project_info.%d.%i.log</fileNamePattern>
                <!-- 每产生一个日志文件,该日志文件的保存期限为30, ps:maxHistory的单位是根据fileNamePattern中的翻转策略自动推算出来的,例如上面选用了yyyy-MM-dd,则单位为天
                如果上面选用了yyyy-MM,则单位为月,另外上面的单位默认为yyyy-MM-dd-->
                <maxHistory>30</maxHistory>
                <!-- 每个日志文件到10mb的时候开始切分,最多保留30天,但最大到20GB,哪怕没到30天也要删除多余的日志 -->
                <totalSizeCap>20GB</totalSizeCap>
                <!-- maxFileSize:这是活动文件的大小,默认值是10MB,测试时可改成5KB看效果 -->
                <maxFileSize>10MB</maxFileSize>
            </rollingPolicy>
            <!--编码器-->
            <encoder>
                <!-- pattern节点,用来设置日志的输入格式 ps:日志文件中没有设置颜色,否则颜色部分会有ESC[0:39em等乱码-->
                <pattern>%dyyyy-MM-dd HH:mm:ss.SSS %-5level --- [%15.15(%thread)] %-40.40(%logger40) : %msg%n</pattern>
                <!-- 记录日志的编码:此处设置字符集 - -->
                <charset>UTF-8</charset>
            </encoder>
        </appender>
     
        <!-- error 日志-->
        <!-- RollingFileAppender:滚动记录文件,先将日志记录到指定文件,当符合某个条件时,将日志记录到其他文件 -->
        <!-- 以下的大概意思是:1.先按日期存日志,日期变了,将前一天的日志文件名重命名为XXX%日期%索引,新的日志仍然是project_error.log -->
        <!--             2.如果日期没有发生变化,但是当前日志的文件大小超过10MB时,对当前日志进行分割 重命名-->
        <appender name="error_log" class="ch.qos.logback.core.rolling.RollingFileAppender">
            <!--日志文件路径和名称-->
            <File>logs/project_error.log</File>
            <!--是否追加到文件末尾,默认为true-->
            <append>true</append>
            <!-- ThresholdFilter过滤低于指定阈值的事件。 对于等于或高于阈值的事件,ThresholdFilter将在调用其decision()方法时响应NEUTRAL。 但是,将拒绝级别低于阈值的事件 -->
            <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
                <level>ERROR</level><!-- 低于ERROR级别的日志(debug,info)将被拒绝,等于或者高于ERROR的级别将相应NEUTRAL -->
            </filter>
            <!--有两个与RollingFileAppender交互的重要子组件。 第一个RollingFileAppender子组件,即RollingPolicy:负责执行翻转所需的操作。
            RollingFileAppender的第二个子组件,即TriggeringPolicy:将确定是否以及何时发生翻转。 因此,RollingPolicy负责什么和TriggeringPolicy负责什么时候.
           作为任何用途,RollingFileAppender必须同时设置RollingPolicyTriggeringPolicy,但是,如果其RollingPolicy也实现了TriggeringPolicy接口,则只需要显式指定前者。-->
            <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
                <!-- 活动文件的名字会根据fileNamePattern的值,每隔一段时间改变一次 -->
                <!-- 文件名:logs/project_error.2017-12-05.0.log -->
                <!-- 注意:SizeAndTimeBasedRollingPolicy中 %i和%d令牌都是强制性的,必须存在,要不会报错 -->
                <fileNamePattern>logs/project_error.%d.%i.log</fileNamePattern>
                <!-- 每产生一个日志文件,该日志文件的保存期限为30, ps:maxHistory的单位是根据fileNamePattern中的翻转策略自动推算出来的,例如上面选用了yyyy-MM-dd,则单位为天
                如果上面选用了yyyy-MM,则单位为月,另外上面的单位默认为yyyy-MM-dd-->
                <maxHistory>30</maxHistory>
                <!-- 每个日志文件到10mb的时候开始切分,最多保留30天,但最大到20GB,哪怕没到30天也要删除多余的日志 -->
                <totalSizeCap>20GB</totalSizeCap>
                <!-- maxFileSize:这是活动文件的大小,默认值是10MB,测试时可改成5KB看效果 -->
                <maxFileSize>10MB</maxFileSize>
            </rollingPolicy>
            <!--编码器-->
            <encoder>
                <!-- pattern节点,用来设置日志的输入格式 ps:日志文件中没有设置颜色,否则颜色部分会有ESC[0:39em等乱码-->
                <pattern>%dyyyy-MM-dd HH:mm:ss.SSS %-5level --- [%15.15(%thread)] %-40.40(%logger40) : %msg%n</pattern>
                <!-- 记录日志的编码:此处设置字符集 - -->
                <charset>UTF-8</charset>
            </encoder>
        </appender>
     
        <!--给定记录器的每个启用的日志记录请求都将转发到该记录器中的所有appender以及层次结构中较高的appender(不用在意level值)。
        换句话说,appender是从记录器层次结构中附加地继承的。
        例如,如果将控制台appender添加到根记录器,则所有启用的日志记录请求将至少在控制台上打印。
        如果另外将文件追加器添加到记录器(例如L),则对LL'子项启用的记录请求将打印在文件和控制台上。
        通过将记录器的additivity标志设置为false,可以覆盖此默认行为,以便不再添加appender累积-->
        <!-- configuration中最多允许一个root,别的logger如果没有设置级别则从父级别root继承 -->
        <root level="INFO">
            <appender-ref ref="STDOUT" /以上是关于idea2021.1版本SpringBoot项目日志的说明及使用的主要内容,如果未能解决你的问题,请参考以下文章

    Python工程师Java之路(t)SpringBoot极速极简入门代码

    Python工程师Java之路(t)SpringBoot极速极简入门代码

    IntelliJ IDEA 2021.1的新增功能, 版本更新说明

    终于来了,IDEA 2021.1版本正式发布,完美支持WSL 2

    IntelliJ IDEA 2021.1激活破解教程(亲测激活至 2099 年,长期更新)

    Intellij IDEA2021.1创建Java web项目(超详细)