一、简述
Logback一个通用、快速而又灵活的Java日志框架。主要分为三个模块组成
- logback-core： 其他两个模块的基础模块
- logback-classic： 由log4j的改良版本，完整实现了slf4j的API，所以可以很方便的更换成其他日志系统如log4j或者JDK14 Logging
- logback-access：访问模块和Servlet容器集成提供通过Http来访问日志的功能
二、文件引用
通常情况下，并不需要在pom.xml文件中显式添加logback的Maven依赖。因为SpringBoot默认使用Spring Boot Starter依赖项来管理日志记录，里面包含了logback的依赖，并且也做了相关的默认日志设置。
如果想自定义配置，可以在src/main/resources目录下添加logback-spring.xml（官方推荐的名字，而不是logback.xml）的配置文件，SpringBoot会自动加载，如果想使用其他名称可以在配置处指定
logging.config=classpath:logback.xml
三、标签说明使用
3.1、<property>声明变量，方便后面引用
<property name="log.path" value="logs/gateway"/>
这样就声明了一个log.path的变量，想要使用则${log.path}
3.2、<appender>自定义和配置日志输出目标
在Logback 中使用<appender>来指定日志输出位置和格式等等，可以将日志输出到不同的目标，如控制台，文件，数据库等。
-
name用来指定appender的名称，在配置文件中是唯一标识 -
class:用来指定实现类，Logback提供了多种自带的实现类，如：-
ConsoleAppender控制台输出 -
FileAppender或者RollingFileAppender文件输出 -
DBAppender数据库
-
-
其他配置项
根据实现不同的类，可以设置有些相关的配置项，如文件路径，输出格式，滚动策略等。
3.3、<encoder>日志编码器标签
<encoder>
<pattern>%date [%thread] %-5level [%logger{50}] %file:%line - %msg%n</pattern>
</encoder>
-
encoder标签是Logback 配置文件中用于定义和配置日志事件的编码器的标签 -
pattern是encoder重要的配置项，用来指定日志输出格式，包括日期时间、日志级别、线程信息、日志内容等等。常用的占位符有：占位符 说明 %d 日期时间 %level 日志级别，如 DEBUG、INFO、WARN、ERROR 等 %logger 日志记录器的名称 %thread 线程名称 %msg 日志消息内容 %n 换行符 %class 出日志所在类的名称 %file 日志所在文件名 %line 所在日志行号 其他
3.4、<logger>指定日志级别
<logger name="com.learn" level="debug"/>
<logger> 可以为不同的包或者类设置不同的日志级别
3.5、<filter>指定日志级别
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>ERROR</level>
</filter>
<filter> 标签用于定义过滤器，它可以用于对特定的日志事件进行筛选和处理。过滤器可根据指定的条件决定是否传递或忽略某个日志事件。
logback 提供了多种类型的过滤器，每种类型都有相应的配置属性。以下是一些常见的过滤器类型及其作用：
-
ThresholdFilter（阈值过滤器）：根据日志事件的级别进行过滤，只传递满足指定级别要求的事件。
-
LevelFilter（级别过滤器）：允许或拒绝特定的日志级别。可以设置最小和最大级别，只保留在范围内的日志事件。
-
TimeFilter（时间过滤器）：根据日志事件的时间戳进行过滤，只传递在指定时间范围内的事件。
-
MarkerFilter（标记过滤器）：根据事件的标记（Marker）进行过滤，只传递符合指定标记要求的事件。
<filter class="ch.qos.logback.classic.filter.MarkerFilter"> <!-- 指定需要接受的 Marker 名称 --> <marker>MY_MARKER</marker> <!-- 设置 onMatch 和 onMismatch 的操作 --> <onMatch>ACCEPT</onMatch> <onMismatch>DENY</onMismatch> </filter>// 获取日志记录器 private static final Logger logger = LoggerFactory.getLogger(MyApp.class); // 创建自定义标记 private static final Marker MY_MARKER = MarkerFactory.getMarker("MY_MARKER"); public static void main(String[] args) { // 输出具有自定义标记的日志事件 logger.info(MY_MARKER, "This log event has the MY_MARKER marker"); }
3.6、<root> 全局日志配置
<root level="INFO">
<!-- 将日志事件输出到控制台 -->
<appender-ref ref="CONSOLE" />
<appender-ref ref="debug"/>
</root>
<root> 标签用来定义跟日志记录器的配置。这里指定了INFO的级别是指日志记录的级别，在日志级别中它与<logger>相比，<logger>的优先级更高。
并且可以为根日志记录器定义多个输出目标（appender），以将日志事件发送到不同的地方，如控制台、文件、数据库等。
3.7、<springProfile> 不同环境配置
<springProfile name="dev">
<logger name="com.learn" level="debug"/>
<!-- Level: FATAL 0 ERROR 3 WARN 4 INFO 6 DEBUG 7 -->
<root level="INFO">
<appender-ref ref="console"/>
<appender-ref ref="debug"/>
<appender-ref ref="error"/>
</root>
</springProfile>
<springProfile> 标签是 Logback 提供的特殊标签
在SpringBoot中每个环境有不同的配置参数，logback日志管理也支持多环境参数配置，与Spring Profile 关联起来，根据当前的环境决定是否加载特定的日志输出配置。文章来源：https://www.toymoban.com/news/detail-668425.html
四、一些常用的配置
4.1、彩色日志依赖
<conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter"/>
<conversionRule conversionWord="wex"
converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter"/>
<conversionRule conversionWord="wEx"
converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter"/>
这里只是设置了彩色打印日志的依赖，但并还没有设置，需要在日志打印格式里配置文章来源地址https://www.toymoban.com/news/detail-668425.html
<appender name="console" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>${CONSOLE_LOG_PATTERN}</pattern>
</encoder>
</appender>
4.2、RollingFileAppender滚筒日志文件输出
<appender name="debug" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${log.path}/debug.log</file>
<!--当触发指定条件时，决定RollingFileAppender的行为，涉及文件移动和重命名。属性class定义具体的滚动策略类。-->
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${log.path}/%d{yyyyMMdd}/debug.%i.log</fileNamePattern>
<maxFileSize>20MB</maxFileSize>
<maxHistory>15</maxHistory>
</rollingPolicy>
<encoder>
<pattern>%date [%thread] %-5level [%logger{50}] %file:%line - %msg%n</pattern>
</encoder>
</appender>
五、实例
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false" scan="false">
<property name="log.path" value="logs/gateway"/>
<!-- 彩色日志格式 -->
<property name="CONSOLE_LOG_PATTERN"
value="${CONSOLE_LOG_PATTERN:-%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
<!-- 彩色日志依赖的渲染类 -->
<conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter"/>
<conversionRule conversionWord="wex"
converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter"/>
<conversionRule conversionWord="wEx"
converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter"/>
<!-- Console log output -->
<appender name="console" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>${CONSOLE_LOG_PATTERN}</pattern>
</encoder>
</appender>
<!-- Log file debug output -->
<appender name="debug" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${log.path}/debug.log</file>
<!--当触发指定条件时，决定RollingFileAppender的行为，涉及文件移动和重命名。属性class定义具体的滚动策略类。-->
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${log.path}/%d{yyyyMMdd}/debug.%i.log</fileNamePattern>
<maxFileSize>20MB</maxFileSize>
<maxHistory>15</maxHistory>
</rollingPolicy>
<encoder>
<pattern>%date [%thread] %-5level [%logger{50}] %file:%line - %msg%n</pattern>
</encoder>
</appender>
<!-- Log file error output -->
<appender name="error" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${log.path}/error.log</file>
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${log.path}/%d{yyyy-MM}/error.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
<maxFileSize>50MB</maxFileSize>
<maxHistory>30</maxHistory>
</rollingPolicy>
<encoder>
<pattern>%date [%thread] %-5level [%logger{50}] %file:%line - %msg%n</pattern>
</encoder>
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>ERROR</level>
</filter>
</appender>
<springProfile name="dev">
<logger name="com.learn" level="debug"/>
<!-- Level: FATAL 0 ERROR 3 WARN 4 INFO 6 DEBUG 7 -->
<root level="INFO">
<appender-ref ref="console"/>
<appender-ref ref="debug"/>
<appender-ref ref="error"/>
</root>
</springProfile>
</configuration>
到了这里，关于Logback日志框架配置使用的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！
