Logback配置详解

1、Java日志体系(目前常用)

  • slf4j:由log4j的作者开发,本身不替供日志具体实现,只对外提供接口或门面。
  • logback:slf4j的作者开发的的slf4j的实现,优于log4j。
  • log4j2:由Apache开发,参考了logback,并做了一些优化。
  • jdk自带的JUL(java.util.logging)和Apache的JCL(Jakarta Commons Logging)好像不太常用了。

2、slf4j和常用日志实现组件的适配

  • slf4j + logback:slf4j-api.jar + logback-classic.jar + logback-core.jar
  • slf4j + log4j:slf4j-api.jar + slf4j-log4j12.jar + log4j.jar

3、logback的模块

  • logback-core:其它两个模块的基础模块。
  • logback-classic:它是log4j的一个改良版本,同时它完整实现了slf4j api。
  • logback-access:访问模块与Servlet容器集成提供通过Http来访问日志的功能。

4、logback的详细配置

<?xml version="1.0" encoding="UTF-8" ?>
<!--
debug 是否打印logback自身运行时的信息,通常是不需要的,所以要设置为false。
scan 配置文件发生改变是否自动加载。
scanPeriod 检测配置文件的时间间隔,默认为1 minute,默认单位为second。
xsd备份地址:http://static.harmonytqs.top/source/logback.xsd,防止别人的被墙了无法加载。
-->
<configuration
        xmlns="http://ch.qos.logback/xml/ns/logback"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://ch.qos.logback/xml/ns/logback https://raw.githubusercontent.com/enricopulatzo/logback-XSD/master/src/main/xsd/logback.xsd"
        debug="false"
        scan="true"
        scanPeriod="2 minute">

    <!--定义日志输出位置-->
    <property name="log.filepath" value="D:\\My Projects\\IDEA\\JavaSE\\log\\src\\main\\resources\\log"/>

    <!--定义日志展示格式
        %d{yyyy-MM-dd HH-mm-ss} 日期时间
        [%thread] 线程名称
        %-5level 格式化占位5个,打印日志级别,因为要保持缩进。
        %logger{100} 打印是在哪个类(全类名)里面记录的日志,{100}表示打印类名的长度最大为100
        %msg 日志信息
        %n 换行-->
    <property name="log.pattern" value="%d{yyyy-MM-dd HH-mm-ss} [%thread] %-5level %logger{100} %msg%n"/>

    <!--控制台日志-->
    <appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <!--日志输出格式-->
            <pattern>${log.pattern}</pattern>
        </encoder>
    </appender>

    <!--不同级别的日志的输出媒介
        级别:trace < debug < info < warn < error
        一般只需记录debug、info、error三个级别的日志,且需放在不同的文件中。-->

    <!--debug日志
        RollingFileAppender:滚动日志,可以按天、按月生成日志文件-->
    <appender name="debugAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!--文件路径-->
        <file>${log.filepath}/debug.log</file>
        <!--定义滚动策略
            TimeBasedRollingPolicy:基于时间的滚动策略-->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--设置每分钟生成文件,{yyyy-MM-dd_HH-mm}写到哪一级就按哪一级精确生成日志文件。
            例如:每天生成一个日志文件就应该写成 {yyyy-MM-dd}
            如果文件名以.gz结尾,logback为自动压缩日志文件,不需要压缩的话不写即可。-->
            <fileNamePattern>${log.filepath}/debug-%d{yyyy-MM-dd_HH-mm}.log.gz</fileNamePattern>
            <!--设置保存日志文件的最大数量-->
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <!--日志格式-->
            <pattern>${log.pattern}</pattern>
        </encoder>

        <!--过滤器:过滤指定级别的日志-->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>DEBUG</level>
            <!--如果是debug级别的日志,记录-->
            <onMatch>ACCEPT</onMatch>
            <!--如果不是debug级别的日志,忽略-->
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>

    <!--info日志-->
    <appender name="infoAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${log.filepath}/info.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${log.filepath}/info-%d{yyyy-MM-dd_HH-mm}.log.gz</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>${log.pattern}</pattern>
        </encoder>

        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>INFO</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>

    <!--error日志-->
    <appender name="errorAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${log.filepath}/error.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${log.filepath}/error-%d{yyyy-MM-dd_HH-mm}.log.gz</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>${log.pattern}</pattern>
        </encoder>

        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>

    <!--根日志记录器,所有包下面的日志都会别记录-->
    <root level="INFO">
        <appender-ref ref="consoleAppender"/>
    </root>

    <!--配置记录日志的包,只有该包下面的类的日志才会别记录。
        level="DEBUG"指定日志记录的级别,不指定将自动继承根日志记录器。-->
    <logger name="top.harmonytqs" level="DEBUG">
        <appender-ref ref="debugAppender"/>
        <appender-ref ref="infoAppender"/>
        <appender-ref ref="errorAppender"/>
    </logger>

</configuration>

5、注意事项

  • 可以在日志记录器中配置filter,用于拒绝根记录器抛出的低级别的日志
<!--控制台日志-->
<appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
  <encoder>
      <!--日志输出格式-->
      <pattern>${log.pattern}</pattern>
  </encoder>
  <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
      <level>ERROR</level>
  </filter>
</appender>
<!--根日志记录器,所有包下面的日志都会别记录-->
<root level="INFO">
    <appender-ref ref="consoleAppender"/>
</root>

此时控制台只会打印ERROR级别的日志
Logback配置详解

上一篇:SpringBoot入门系列(十二)统一日志收集


下一篇:logback.xml