Logback - 日志框架

引言
在当今的企业级应用开发中，日志管理是一个不可或缺的部分。它不仅帮助我们进行错误跟踪，还能有效监控应用程序的运行状态，为性能优化提供数据支撑。Spring Boot作为一个简化Spring应用开发的框架，自带了强大的日志管理功能。在Spring Boot的众多日志管理技术中，Logback由于其高效性能和灵活配置而广受欢迎。

Logback简介

Logback是由log4j创始人Ceki Gülcü领导开发的日志组件，它是SLF4J的一个实现，也是log4j的一个强大替代品。Logback被设计用来更快的速度，更小的内存占用以及更多的灵活配置进行日志记录。
其中包括三个模块：

• logback-core：核心模块，提供了关键的通用机制；
• logback-classic：可以看作是 log4j 的改进版，实现了简单的日志门面 SLF4J；
• logback-access：主要用来和 Servlet 容器交互，比如说 Tomcat，提供了一些 HTTP 访问的功能

spring-boot-starter-* =>spring-boot-starter =>spring-boot-starter-logging
spring-boot-starter-logging 启动器依赖，默认集成的是 logback 日志，可以在项目的 application.yml 中添加日志相关配置，也可以直接指定日志配置文件进行配置。
Commons Logging => SLF4J/Log4j => Log4j2 => Logback。

Spring Boot与Logback的整合

非 springboot 项目

导入依赖

<dependency>
    <groupId>ch.qos.logbackgroupId>
    <artifactId>logback-classicartifactId>
dependency>

springboot 项目

任何一个 spring-boot-starter-* 都会默认导入一个 spring-boot-starter-logging 启动器依赖，因此只要当前项目的依赖中有starter，无需显式引入。

<dependency>
   <groupId>org.springframework.bootgroupId>
   <artifactId>spring-boot-starter-loggingartifactId>
dependency>

Spring Boot默认支持Logback，并已经带有一系列的自动配置。当我们在classpath下添加了logback-spring.xml或logback.xml配置文件时，Spring Boot会使用Logback作为默认的日志框架。

日志级别

• TRACE - 这是最详细的日志级别，用于跟踪程序执行的每一个步骤，适合进行调试。
• DEBUG - 提供较细粒度的信息，有助于开发者诊断问题。
• INFO - 用于记录程序的主要运行状态和信息，如启动和关闭。
• WARN - 表示可能出现潜在问题的警告信息。
• ERROR - 记录严重的错误信息，可能会导致程序退出。

// 使用slf4j门面，若不特殊指定，以下的示例都是这一段代码
@SpringBootTest
public class LogBackTest {
    private final static Logger logger = LoggerFactory.getLogger(LogBackTest.class);
    @Test
    public void test() {
       logger.trace("=============奇遇少年");
       logger.debug("=============奇遇少年");
       logger.info("=============奇遇少年");
       logger.warn("=============奇遇少年");
       logger.error("=============奇遇少年");
    }
}

生成日志文件

编写测试类

@SpringBootTest
public class LogBackTest {
    private final static Logger logger = LoggerFactory.getLogger(LogBackTest.class);
    @Test
    public void test() {
        for (int i = 0; i < 100000000; i++) {
            logger.trace("=============奇遇少年");
            logger.debug("=============奇遇少年");
            logger.info("=============奇遇少年");
            logger.warn("=============奇遇少年");
            logger.error("=============奇遇少年");
        }

    }
}

方式一、application.yml中配置

# 输出到控制台的配置
log:
  path: /tmp/log
logging:
  pattern:
    # 输出格式配置
    console: ' %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n'
  logback:
    rollingpolicy:
      file-name-pattern: ${log.path}/奇遇少年-%d{yyyy-MM-dd}.%i.gz
      max-file-size: 10MB
      max-history: 6
  file:
    name: ${log.path}/yu.log

大于10MB 日志文件会进行压缩

方式二：logback-spring.xml

spring:
  profiles:
    active: pro #开发或正式环境

<configuration>
    
    
    <property name="dev_pattern"
              value="%d{yyyy-MM-dd HH:mm:ss} | [%-5level] [%thread] %c{36} %M %L -- %msg %n">property>
    
    <property name="pro_pattern"
              value="%d{yyyy-MM-dd HH:mm:ss} | [%-5level] [%thread] %c{36} %M %L -> %msg %n">property>

    <property name="log_dir" value="/tmp/log">property>


    
    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <springProfile name="dev">
                <pattern>${dev_pattern}pattern>
            springProfile>
            <springProfile name="pro">
                <pattern>${pro_pattern}pattern>
            springProfile>
        encoder>
        <target>System.errtarget>
    appender>


    
    <appender name="roll_file" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${log_dir}/yu.logfile>

        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${log_dir}/奇遇少年-%d{yyyy-MM-dd}.%i.gzfileNamePattern>
            
            <maxHistory>30maxHistory>
            
            <maxFileSize>10MBmaxFileSize>
        rollingPolicy>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <springProfile name="dev">
                <pattern>${dev_pattern}pattern>
            springProfile>
            <springProfile name="pro">
                <pattern>${pro_pattern}pattern>
            springProfile>

        encoder>
    appender>


    <root level="all">
        <appender-ref ref="console"/>
        <appender-ref ref="roll_file"/>
    root>
configuration>

自定义配置文件名

自定义配置文件名，则需要在application.yml中申明：

logging:
  config: classpath:yu.xml #自定义的配置文件名

结语

Logback作为一个现代的日志框架，为Spring Boot应用提供了极致的性能和极度的灵活性。通过合理配置Logback，我们可以很好地控制日志输出，并以此帮助我们更好地理解和监控应用运行时的状态和行为。然而，任何强大的工具都需要谨慎使用，过多的日志记录会影响应用性能，不足的记录又可能导致问题难以追踪。成熟的开发人员会根据应用的具体情况，做出合理的日志管理方案。

---

希望本文能够为你在Spring Boot应用中使用Logback提供一些有价值的参考。