Springboot--整合Logback 日志框架（Maven）

---

前言

在项目调试和运行中，都可能涉及到 日志的输出，本文对springboot 整合Logback 日志框架进行介绍。

---

一、Logback 日志框架介绍：

Logback 是一个灵活的日志框架，旨在替代传统的 Apache Log4j 框架。它是由 Ceki Gülcü 开发，并且支持 SLF4J 日志接口。Logback 由三个主要模块组成：

1. Logback Core：Logback 的核心模块，提供了日志事件处理和过滤的基本功能。Logger、Appender、Layout 和 Filter 等关键组件都在这个模块中定义。

2. Logback Classic：Logback 经典模块，是 Log4j 的改进版本，兼容 Log4j 的 API 和配置文件。Logback Classic 扩展了 Logback Core 模块，提供了更多功能和灵活性。

3. Logback Access：Logback 访问模块，用于记录 HTTP 请求的访问日志。它可以与 Servlet 容器集成，用于记录 Web 应用程序的访问日志。

Logback 的一些主要特点包括：

• 性能优秀：Logback 的设计旨在提供高性能的日志记录功能，比传统的 Log4j 框架更快速地处理日志事件。

• 灵活性：Logback 提供了丰富的配置选项和插件支持，使得用户可以根据需要定制日志记录的行为和格式。

• SLF4J 兼容：Logback 与 SLF4J（Simple Logging Facade for Java）结合使用，使得应用程序可以灵活地切换不同的日志框架。

• 支持文件和控制台日志输出：Logback 支持将日志输出到文件、控制台以及其他各种目标，可以根据需求配置输出目的地。

• 多种过滤器：Logback 提供了多种过滤器选项，可以根据不同的条件过滤日志事件，使得日志输出更加精准。

总之，Logback 是一个功能丰富、灵活性强、性能优秀的日志框架，适用于大多数 Java 应用程序的日志记录需求。可以根据具体的项目需求和喜好选择是否在的应用程序中使用 Logback 框架。

logback 官网;

二、整合：

2.1 引入jar

 <dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId><version>1.2.12</version></dependency>

maven 版本参考：https://mvnrepository.com/artifact/ch.qos.logback/logback-classic

2.2 logback.xml 文件配置：

logback.xml 是 Logback 日志框架的配置文件，用于指定 Logback 日志系统的行为和属性。通过 logback.xml 文件，可以配置日志输出的格式、目标（比如控制台、文件）、日志级别、滚动策略等。

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="60 seconds" debug="false"><!-- 日志存放路径  logs/job 设置为相对项目目录--><property name="log.path" value="logs/job" /><!-- 日志输出格式 时间 线程 日志级别 类 方法 对应的行数 输出信息 这样设置后输出格式如下 --><!-- 15:09:27.204 [http-nio-8080-exec-10] DEBUG c.e.s.l.TestLog - [getVersion,26] - debug详细信息 --><property name="log.pattern" value="%d{HH:mm:ss.SSS} [%thread] %-5level %logger{20} - [%method,%line] - %msg%n" /><!-- 控制台输出 appender  --><appender name="console" class="ch.qos.logback.core.ConsoleAppender"><encoder><!-- 日志内容输出格式设置为定义好的 log.pattern--><pattern>${log.pattern}</pattern></encoder></appender><!-- 系统日志输出 appender  class 中的log.pattern 表示日志滚动输出 --><appender name="file_info" class="ch.qos.logback.core.rolling.RollingFileAppender"><!-- 日志首次输出的文件地址  --><file>${log.path}/info.log</file><!-- 滚动输出策略：基于时间创建日志文件 ，这样第二天输出的日志，就会按照 fileNamePattern 新建日志文件 --><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><!-- 日志文件名格式 --><fileNamePattern>${log.path}/info.%d{yyyy-MM-dd}.log</fileNamePattern><!-- 日志最大的历史 60天 --><maxHistory>60</maxHistory></rollingPolicy><encoder><!-- 日志内容输出格式设置为定义好的 log.pattern--><pattern>${log.pattern}</pattern></encoder><!-- 日志内容输出过滤器 --><filter class="ch.qos.logback.classic.filter.LevelFilter"><!-- 过滤的级别 --><level>INFO</level><!-- 匹配时的操作：接收（记录） --><onMatch>ACCEPT</onMatch><!-- 不匹配时的操作：拒绝（不记录） --><onMismatch>DENY</onMismatch></filter></appender><appender name="file_debug" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>${log.path}/debug.log</file><!-- 循环政策：基于时间创建日志文件 --><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><!-- 日志文件名格式 --><fileNamePattern>${log.path}/debug.%d{yyyy-MM-dd}.log</fileNamePattern><!-- 日志最大的历史 60天 --><maxHistory>60</maxHistory></rollingPolicy><encoder><pattern>${log.pattern}</pattern></encoder><filter class="ch.qos.logback.classic.filter.LevelFilter"><!-- 过滤的级别 --><level>DEBUG</level><!-- 匹配时的操作：接收（记录） --><onMatch>ACCEPT</onMatch><!-- 不匹配时的操作：拒绝（不记录） --><onMismatch>DENY</onMismatch></filter></appender><appender name="file_error" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>${log.path}/error.log</file><!-- 循环政策：基于时间创建日志文件 --><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><!-- 日志文件名格式 --><fileNamePattern>${log.path}/error.%d{yyyy-MM-dd}.log</fileNamePattern><!-- 日志最大的历史 60天 --><maxHistory>60</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><!-- 系统模块日志级别控制 name 设置为你自己的项目根路径 如com.example.logback--><!-- level 设置日志输出的级别为debug 这样系统在进行日志输出时 只要级别在 debug  之后都可以打印 --><!-- 日志输出级别 trace< debug < info< warn < error  --><logger name="com.example.logback" level="debug" /><!-- Spring日志级别控制--><logger name="org.springframework" level="warn" /><!--系统操作日志 root 根路径的日志级别 info --><root level="info"><!-- 将定义好的几个日志输出 追加到 root 上 --><!-- console 控制台输出  --><appender-ref ref="console" /><!-- console info级别输出  --><appender-ref ref="file_info" /><!-- console debug级输出  --><appender-ref ref="file_debug" /><!-- console error级输出  --><appender-ref ref="file_error" /></root>
</configuration>

2.3 日志输出：

2.3.1 方式一：

类中定义logger 静态量

 static  Logger logger = LoggerFactory.getLogger(TestLog.class);

logger 日志输出：

logger.trace("trace追踪信息");
logger.debug("debug详细信息");
logger.info("info关键信息");
logger.warn("warn警告信息");
logger.error("error错误信息");

2.3.2 方式二：

maven 引入 lombok

<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional>
</dependency>

在类上增加 @Slf4j 注解：

lombok 中 Slf4j 注解源码内容

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;@Retention(RetentionPolicy.SOURCE)
@Target({ElementType.TYPE})
public @interface Slf4j {String topic() default "";
}

logger 日志输出：

 log.trace("trace追踪信息");
log.debug("debug详细信息");
log.info("info关键信息");
log.warn("warn警告信息");
log.error("error错误信息");

2.3 日志输出结果展示：

控制台输出：

log 日志文件输出：

日志内容：

三、扩展：

3.1 日志输出格式设置：

<property name="log.pattern" value="%d{HH:mm:ss.SSS} [%thread] %-5level %logger{20}- [%method,%line] - %msg%n" />

3.2 日志输出过滤器设置：

过滤器写在 Appender 标签内，可以配置一个或多个，按照先后顺序执行。过滤器会对每个级别的日志设置枚举值，表示对日志的处理方式：

<filter class="ch.qos.logback.classic.filter.LevelFilter"><!-- 过滤的级别 TRACE,DEBUG ,INFO,WARN,ERROR --><level>INFO</level><!-- 匹配时的操作：接收（记录） --><onMatch>ACCEPT</onMatch><!-- 不匹配时的操作：拒绝（不记录） --><onMismatch>DENY</onMismatch>
</filter>

---

总结

本文对springboot 整合Logback 日志框架进行介绍。