logback 配置相对路径_SpringBoot中如何使用logback日志框架

最新推荐文章于 2024-02-04 21:45:24 发布

weixin_39989875

最新推荐文章于 2024-02-04 21:45:24 发布

阅读量2.2k

点赞数

文章标签： logback 配置相对路径

本文链接：https://blog.csdn.net/weixin_39989875/article/details/112286921

版权

对于Java来说，现在有很多的日志实现，像commons-logging、log4j、log4j2、logback等，这些都是比较主流的日志实现。SpringBoot对上述主流的日志实现都做了很好的支持，这样以来我们在使用日志框架时就显得有些困惑了，怎么样选择日志框架，才是最优配置。其实最优配置是相对的，不过我们可以根据SpringBoot“约定优于配置”的理念作为指导，来选择适合自己的日志框架。默认情况下，当我们使用启动类来构建项目时，SpringBoot使用logback来记录日志。

基础配置

在使用SpringBoot时收集日志时，如果你对日志的显示格式以及日志文件的输出内容没有特殊的要求时，我们都甚至不需要定义日志实现框架的配置文件，只需在SpringBoot的配置文件中添加基本日志配置即可满足我们的需求，当然这些配置项有些只是针对默认的logback才生效，基础配置项列表如下：

debug=false
trace=false
# LOGGING
logging.config=
logging.exception-conversion-word=%wEx
logging.file=
logging.file.max-history=0
logging.file.max-size=10MB
logging.group.*=
logging.level.*=
logging.path=
logging.pattern.console=
logging.pattern.dateformat=yyyy-MM-dd HH:mm:ss.SSS
logging.pattern.file=
logging.pattern.level=%5
plogging.register-shutdown-hook=false

1、debug、trace属性

默认false，如果为true，则表示打开调试或跟踪模式，调试或跟踪模式只针对SpringBoot系统内部日志，并不是所有的日志都以debug级别显示，比如我们手动通过api输出的日志就不受影响。

2、logging.config属性

该属性指定日志配置文件的所在位置，默认会从classpath的根路径加载，如果两种方式都没有指定，则根据日志框架实现类型加载默认的日志配置文件（在框架内部）。

3、logging.exception-conversion-word属性

默认值“%wEx”，主要用彩色异常日志的格式化，不常用。

4、logging.file属性

只有在SpringBoot默认的日志配置下此属性才有意义，它指定日志文件生成的完整路径或相对路径。如果是ide运行项目则相对路径以src为基准，如果是可执行jar包，则以jar包为基准。

5、logging.path属性

只有在SpringBoot默认的日志配置下此属性才有意义，它指定生成的日志文件所在的文件夹的完整路径或相对路径，相对路径的基准目录同上。如果使用此属性，则生成的日志文件名称固定，为spring.log，而且如果同时配置了logging.file属性，则以logging.file属性配置位为准。

6、logging.file.max-size属性

此属性只在默认日志实现为logback并且loggin.file属性启用之后才生效，表示日志文件的大小，单位MB。如果日志文件超过此设置的之后，会自动生成一个压缩包，压缩包的命名规则：日志文件名称.log.xxxx-xx-xx.num。

7、logging.file.max-history属性

此属性只在默认日志实现为logback并且loggin.file属性启用之后才生效，表示生成的日志文件压缩包的存档时间，默认是0，表示永远存档，如果大于0表示最多保留x天。该属性只在6属性存在的情况下才有意义。

8、logging.group属性

此属性表示的是一个日志组，它的作用在于方便的控制某个组下的日志级别，例如：

#定义com.icypt.controller包下的日志，统一由controller组管理
logging.group.controller=com.icypt.controller
#控制日志组日志级别
loggin.level.contoller=info

SpringBoot也预定义了一些日志组，如下：

logging.group.web=org.springframework.core.codec, org.springframework.http, org.springframework.web, org.springframework.boot.actuate.endpoint.web, org.springframework.boot.web.servlet.ServletContextInitializerBeans
logging.group.sql=org.springframework.jdbc.core, org.hibernate.SQL

所以我们在以后调试SpringBoot项目时可以通过这些预定义组来临时修改日志级别，岂不是很方便。

9、logging.level属性

此属性用于指定日志级别，其后可以跟root、组名称、包名称、包.类名等，例如：

logging.level.root=warn
logging.level.org.springframework.web=debug
logging.level.org.hibernate=error

这里有个优先级的问题需要注意一下：logging.level后跟的路径越详细优先级越高：

logging.level.包.类 > logging.level.包 > logging.level.组 > logging.level.root

10、格式化属性

logging.pattern.console= #格式化控制台打印的日志 logging.pattern.dateformat=yyyy-MM-dd HH:mm:ss.SSS #格式化日志日期时间 logging.pattern.file= #格式化输出到文件的日志 logging.pattern.level=%5p #格式化日志级别

11、logging.register-shutdown-hook属性

此属性默认值false，目前还未使用过此属性，不知其使用场景是什么，各位学友有谁知道，在公众号留言告诉我一下。那么，如果你对日志记录要求不是很高，采用SpringBoot默认的logback日志框架再加上一些自定义的属性配置就可以完成日志的搜集工作了。如果以上这些设置还不能满足你的需求，就得自定义logback的配置文件了，当然也可以集成其他日志框架。

自定义日志配置文件

由于SpringBoot默认支持Logback日志实现框架，所以我们要做的就是定义其配置文件，并放置指定的路径下即可，这个配置文件的存放路径，在上述的基础配置中已经提到过，这里就不赘述了。

1、定义logback配置文件

为了使我们的配置文件结构更加清晰，这里将logback的配置文件根据其不同的功能进行分解整合。 配置文件一、logback入口配置文件，命名为logback-init.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">
   <!-- 日志全局属性，日志文件存放路径  -->
   <property name="log.path" value="D:/sboot/logs/" />
   <!-- 日志全局属性，日志文件前缀  -->
   <property name="log.file.prefix" value="sboot" />

   <!-- 日志配置模块引入 -->
   <include resource="logback/defaults.xml" />
   <include resource="logback/console-appender.xml" />
   <include resource="logback/file-appender.xml" />

   <!-- 定义根日志级别 -->
   <root level="INFO">
      <!-- 引用日志追加器 -->
      <appender-ref ref="CONSOLE" />
      <appender-ref ref="FILE_INFO" />
      <appender-ref ref="FILE_ERROR" />
   </root>
</configuration>

配置文件二，logback默认配置文件，命名为default.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- 以下均为默认配置，基本不会动 -->
<included>
   <!-- 五彩斑斓的日志转换器 -->
   <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日志输出格式化-->
   <property name="CONSOLE_LOG_PATTERN" value="${CONSOLE_LOG_PATTERN:-%clr(%d{${LOG_DATEFORMAT_PATTERN:-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}}"/>
   <!-- 文件日志输出格式化-->
   <property name="FILE_LOG_PATTERN" value="${FILE_LOG_PATTERN:-%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}} ${LOG_LEVEL_PATTERN:-%5p} ${PID:- } --- [%t] %-40.40logger{39} : %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
   <!-- 自定义一些特定日志的打印级别-->
   <logger name="org.apache.catalina.startup.DigesterFactory" level="ERROR"/>
   <logger name="org.apache.catalina.util.LifecycleBase" level="ERROR"/>
   <logger name="org.apache.coyote.http11.Http11NioProtocol" level="WARN"/>
   <logger name="org.apache.sshd.common.util.SecurityUtils" level="WARN"/>
   <logger name="org.apache.tomcat.util.net.NioSelectorPool" level="WARN"/>
   <logger name="org.eclipse.jetty.util.component.AbstractLifeCycle" level="ERROR"/>
   <logger name="org.hibernate.validator.internal.util.Version" level="WARN"/>
</included>

配置文件三、logback控制台日志输出配置文件，命名为console-appender.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- 输出日志到控制台，默认就这样吧 -->
<included>
   <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
      <encoder>
         <pattern>${CONSOLE_LOG_PATTERN}</pattern>
         <!-- 设置字符集 -->
         <charset>UTF-8</charset>
      </encoder>
   </appender>
</included>

配置文件四、logback文件日志输出配置文件，命名为file-appender.xml

<?xml version="1.0" encoding="UTF-8"?>
<included>

   <!-- info日志文件appender -->
   <appender name="FILE_INFO"
      class="ch.qos.logback.core.rolling.RollingFileAppender">
      <encoder>
         <!-- 日志文件的输出格式 -->
         <pattern>${FILE_LOG_PATTERN}</pattern>
         <!-- 设置字符集 -->
         <charset>UTF-8</charset>
      </encoder>
      <!-- 定义日志文件名称 -->
      <file>${log.path}${log.file.prefix}_info.log</file>
      <!-- 此日志文件只记录info级别的 -->
      <filter class="ch.qos.logback.classic.filter.LevelFilter">
         <!-- 被过滤的日志级别 -->
         <level>ERROR</level>
         <!-- 拒绝拼配到级别的日志-->
         <onMatch>DENY</onMatch>
         <!-- 接受没有匹配到的日志-->
         <onMismatch>ACCEPT</onMismatch>
      </filter>
      <!-- 文件回滚策略 -->
      <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
         <!-- 当当日文件超过10MB时会进行压缩，压缩的文件名称如下 -->
         <fileNamePattern>${log.path}/${log.file.prefix}_info_%d{yyyy-MM-dd}_%i.gz</fileNamePattern>
         <!-- 当日日志文件最大 -->
         <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
            <maxFileSize>1MB</maxFileSize>
         </timeBasedFileNamingAndTriggeringPolicy>
         <!-- 存档-->
         <maxHistory>120</maxHistory>
      </rollingPolicy>
   </appender>

   <!-- error日志文件appender -->
   <appender name="FILE_ERROR"
           class="ch.qos.logback.core.rolling.RollingFileAppender">
      <encoder>
         <!-- 日志文件的输出格式 -->
         <pattern>${FILE_LOG_PATTERN}</pattern>
         <!-- 设置字符集 -->
         <charset>UTF-8</charset>
      </encoder>
      <!-- 定义日志文件名称 -->
      <file>${log.path}${log.file.prefix}_error.log</file>
      <!-- 此日志文件只记录info级别的 -->
      <filter class="ch.qos.logback.classic.filter.LevelFilter">
         <level>ERROR</level>
         <onMatch>ACCEPT</onMatch>
         <onMismatch>DENY</onMismatch>
      </filter>
      <!-- 文件回滚策略 -->
      <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
         <!-- 当当日文件超过10MB时会进行压缩，压缩的文件名称如下 -->
         <fileNamePattern>${log.path}/${log.file.prefix}_error_%d{yyyy-MM-dd}_%i.gz</fileNamePattern>
         <!-- 当日日志文件最大 -->
         <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
            <maxFileSize>1MB</maxFileSize>
         </timeBasedFileNamingAndTriggeringPolicy>
         <!-- 存档-->
         <maxHistory>120</maxHistory>
      </rollingPolicy>
   </appender>
</included>

以上四个配置文件由logback-init.xml文件作为统一入口进行整合，使得日志配置结构更加简单明了，这也是对SpringBoot默认配置的一种学习和参考。关于配置文件的说明，看注释就好，这里就不赘述了。

2、在SpringBoot属性配置中定义logback入口配置文件位置

#定义日志配置文件路径
logging.config=classpath:./logback/logback-init.xml

3、温馨提示

1>、一旦我们自定义了日志配置文件，则之前在用于logback默认配置的基础属性都将失效，原则上自定义配置文件已经涵盖了之间所述的默认配置属性，所以并无大碍。

2>、Spring日志的初始化先与SpringBoot上下文的加载，所以不能在配置类中使用@PropertySource来获取属进行日志的控制。

3>、如果想要把配置文件置于可执行jar包的外部，只需对上述配置稍作修改即可：

修改一、SpringBoot属性配置文件

#定义日志配置文件路径，file的基准在ide中是项目根目录，在可执行jar文件中与就是其本身
logging.config=file:./logback/logback-init.xml
或者
logging.config=完整路径

修改二、Logback入口配置文件

<!-- 日志配置模块引入，可以是相对路径，也可是完整路径，相对路径基准同上-->
<include file="./logback/defaults.xml"/>
<include file="./logback/console-appender.xml"/>
<include file="./logback/file-appender.xml"/>

至此，关于SpringBoot中Logback日志框架的使用就说清楚了，各位小伙伴赶快去实践吧！

如果想学习、交流更多Java开发技术，可以关注公众号 [冰点IT]，后台回复暗号“666”，能免费获取博主精心整理的学习资料，你也可以加我微信，让我们一起共同学习成长吧！