logback-spring.xml文件，带详细注释

logback-spring.xml文件，带详细注释

<?xml version="1.0" encoding="UTF-8"?>
<!-- 日志级别从低到高分为 TRACE < DEBUG < INFO < WARN < ERROR < FATAL，如果
设置为 WARN，则低于 WARN 的信息都不会输出 -->
<!-- scan:当此属性设置为 true 时，配置文件如果发生改变，将会被重新加载，默认值为
true -->
<!-- scanPeriod:设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认
单位是毫秒。当 scan 为 true 时，此属性生效。默认的时间间隔为 1 分钟。 -->
<!-- debug:当此属性设置为 true 时，将打印出 logback 内部日志信息，实时查看 logback
运行状态。默认值为 false。通常不打印 -->
<configuration scan="true" scanPeriod="10 seconds">
    <!--appender：日志追加器-->

    <!--输出到控制台的日志追加器-->
    <!-- ch.qos.logback.core.ConsoleAppender 表示控制台输出 -->
    <appender name="CONSOLE"
              class="ch.qos.logback.core.ConsoleAppender">
        <!--此日志 appender 是为开发使用，只配置最底级别，控制台输出的日志级别是大于或等于此级别的日志信息-->

        <!--定义过滤级别，debug以上才打印-->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>debug</level>
        </filter>

        <!--
            encoder定义日志输出的格式

            %d表示日期时间
            %-5p表示级别从左显示5个字符宽度. %p表示日志级别,-表示左对齐,5表示最多可以输出5个字符
            %thread表示线程名
            %logger{60} 表示logger名字最长60个字符，否则按照句点分割。
            [%file : %line] 表示哪个文件,哪一行
            %msg：日志消息
            %n是换行符
        -->
        <encoder>
            <Pattern>
                %date [%-5p] [%thread] %logger{60} [%file : %line] %msg%n
            </Pattern>
            <!-- 设置字符集 -->
            <charset>UTF-8</charset>
        </encoder>
    </appender>


    <!--滚动文件追加器-->
    <!-- 滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件 -->
    <appender name="FILE"
              class="ch.qos.logback.core.rolling.RollingFileAppender">

        <!--设置文件路径-->
        <File>D:/log/springboot-logback.log</File>
        <encoder>
            <pattern>
                %date [%-5p] %thread %logger{60} [%file : %line] %msg%n
            </pattern>
        </encoder>

        <!--
        当发生滚动时，决定 RollingFileAppender 的行为，涉及文件移动和重命名
        TimeBasedRollingPolicy： 最常用的滚动策略，它根据时间来制定滚动策略，既负责滚动也负责出发滚动。
        -->
        <rollingPolicy
                class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 添加.gz 历史日志会启用压缩 大大缩小日志文件所占空间 -->

            <!--滚动时产生的文件的存放位置及文件名称 %d{yyyy-MM-dd}：按天进行日志滚动-->
            <fileNamePattern>
                D:/log/springboot-logback.log.%d{yyyy-MM-dd}.log
            </fileNamePattern>
            <maxHistory>30</maxHistory><!-- 保留 30 天日志 -->
            <!--
            可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件。假设设置每天滚动，
            且maxHistory是30，则只保存最近30天的文件，删除之前的旧文件。注意，删除旧文件是，
            那些为了归档而创建的目录也会被删除。
            -->
        </rollingPolicy>

    </appender>


    <!--
        logger主要用于存放日志对象，也可以定义日志类型、级别
        name：表示匹配的logger类型前缀，也就是包的前半部分
        level：要记录的日志级别，包括 TRACE < DEBUG < INFO < WARN < ERROR
        additivity：作用在于children-logger是否使用 rootLogger配置的appender进行输出，
        false：表示只用当前logger的appender-ref，true：
        表示当前logger的appender-ref和rootLogger的appender-ref都有效
    -->

    <!-- 打印哪个目录下的日志,我的controller,service,mapper层的代码都在com.hyc.springboot包下-->
    <logger name="com.hyc.springboot" level="DEBUG" />

    <!--
       root与logger是父子关系，没有特别定义则默认为root，任何一个类只会和一个logger对应，
       要么是定义的logger，要么是root，判断的关键在于找到这个logger，然后判断这个logger的appender和level。
   -->
    <!--如果root标签指定了日志级别那么以根日志为准,如果没有则以当前追加器日志级别为准-->
    <!--如果root没有指定日志级别,root默认值级别是debug,这时如果追加器日志级别为trace,最终日志级别为debug:
        root指定级别    追加器appender指定级别   最终日志级别
        trace               trace                   trace
        debug               trace                   debug
        info                debug                   info
        未指定(默认为debug)   trace                   debug
    -->
    <root level="INFO">
        <!--ref='',CONSOLE和FILE就是上面定义的两个追加器appender的名字name-->
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
    </root>
</configuration>