SpringBoot项目增加logback日志文件

一、简介

在开发和调试过程中,日志是一项非常重要的工具。它不仅可以帮助我们快速定位和解决问题,还可以记录和监控系统的运行状态。Spring Boot默认提供了一套简单易用且功能强大的日志框架logback,本文将介绍如何在Spring Boot项目中配置和使用logback日志文件。

二、pom文件依赖查看

因为SpringBoot项目默认就是使用的就是logback日志系统,创建SpringBoot项目时引入的spring-boot-starter或者spring-boot-starter-web依赖jar包中已经包含了spring-boot-starter-logging的依赖,里面同时包含多种日志系统依赖,如下图所示:

SpringBoot项目增加logback日志文件_第1张图片

jar包里面已经包括logback和log4j,所以,无需额外添加依赖,直接配置logback.xml就可以了

此外,如果需要切换为log4j2,那么需要在spring-boot-starter-web依赖中排除springboot自带的commons‐logging,然后在引入log4j2的依赖jar包,代码如下:


<dependency>
   <groupId>org.springframework.bootgroupId>
   <artifactId>spring-boot-starter-webartifactId>
   <exclusions>
      <exclusion>
      <groupId>commons‐logginggroupId>
      <artifactId>commons‐loggingartifactId>
      exclusion>
   exclusions>
dependency>


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

三、创建logback日志文件步骤

    1. 添加了Spring Boot Starter依赖
<dependency>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-starter-webartifactId>
    
dependency>
    1. 在项目的src/main/resources目录下创建一个logback-spring.xml文件。这是logback的配置文件,Spring Boot会自动加载它。
    1. 通过自定义logback.xml配置文件来控制日志输出情况,通常我们会配置三个日志组件:
    • 控制台输出
    • 输出info级别日志文件
    • 输出error级别日志文件

以下为logback.xml完整配置:


<configuration scan="true" scanPeriod="2 seconds">
    
    <property name="LOG_PATH" value="./logs" />
    
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level ${PID:-} --- [%t] %logger{50} - %msg%npattern>
        encoder>
    appender>

    
    <appender name="INFO_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        
        <File>${LOG_PATH}/info.logFile>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            
            <fileNamePattern>${LOG_PATH}/info-%d{yyyy-MM-dd}.%i.logfileNamePattern>
            
            <maxHistory>30maxHistory>
            
            <maxFileSize>100MBmaxFileSize>
        rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level ${PID:-} --- [%t] %logger{50} - %msg%npattern>
        encoder>
    appender>

    
    <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>ERRORlevel>
        filter>
        <File>${LOG_PATH}/error.logFile>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/error-%d{yyyy-MM-dd}.%i.logfileNamePattern>
            <maxHistory>30maxHistory>
            <maxFileSize>100MBmaxFileSize>
        rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level ${PID:-} --- [%t] %logger{50} - %msg%npattern>
        encoder>
    appender>

    
    <root level="INFO">
        <appender-ref ref="STDOUT" />
        <appender-ref ref="INFO_FILE" />
        <appender-ref ref="ERROR_FILE" />
    root>

configuration>

四、logback配置说明

  • 根节点configuration用于配置日志系统的行为。它包含以下三个属性:
<configuration scan="true" scanPeriod="2 seconds" debug="false">
    
configuration>

scan:当配置文件发生更改时,是否重新加载配置,默认值为true。
scanPeriod:检测配置文件修改的时间间隔,默认值为6000毫秒。
debug:是否打印logback内部日志信息以实时查看logback的运行状态,默认值为false。

  • 子节点property
<property name="LOG_PATH" value="./logs" />

用来定义变量值,包含以下两个属性:

name:变量名称
value:变量定义的值
通过property定义的值会被插入到logger上下文中,可以使${}来使用变量,这里定义了log的保存位置根目录。

  • 子节点appender
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">

appender>

是负责写日志的组件,通过自定义日志组件控制日志输出的情况,包含以下两个属性:

  • name:组件名称
  • class:组件class指定的类名
    不同的class,对应不同的功能:
    ch.qos.logback.core.ConsoleAppender会把日志输出到控制台
    ch.qos.logback.core.rolling.RollingFileAppender把日志内容输出到指定文件
  • File节点:日志文件输出的文件名
<File>${LOG_PATH}/info.logFile>
  • filter节点:过滤器,用来指定日志组件的日志输出级别,优先级高于root节点的level
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
    <level>ERRORlevel>
filter>
  • rollingPolicy节点

滚动日志文件配置,涉及日志文件的移动和重命名,只有一个class属性,用来指定滚动策略,这里使用的是ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy

包含以下三个属性:

fileNamePattern:发生滚动时的日志命名方式
maxHistory:日志文件的最大保留时间,超过设定时间后会自动删除
maxFileSize:每份日志文件的最大限制,超出限制后会重新生成,并将旧的日志文件按照fileNamePattern设定的日志命名方式进行命名
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
    <fileNamePattern>${LOG_PATH}/error-%d{yyyy-MM-dd}.%i.logfileNamePattern>
    <maxHistory>30maxHistory>
    <maxFileSize>100MBmaxFileSize>
rollingPolicy>
  • 子节点encoder
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
     <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level ${PID:-} --- [%t] %logger{50} - %msg%npattern>
encoder>

对记录事件进行格式化,负责两件事,一是把日志信息转换成字节数组,二是把字节数组写入到输出流。PatternLayoutEncoder是唯一有用的且默认的encoder,有一个节点,用来设置日志的输入格式。使用“%”加“转换符”方式,如果要输出“%”,则必须用“\”对“%”进行转义。

  • 子节点root

logger,是所有logger的最上级,且只有一个level节点,用类设置打印日志的级别,默认值为debug,通常设置为info,此外还有trace、warn、error、all、off级别。
子节点appender-refref属性指定日志组件名称,即appendername属性值。

五、使用logback

# 配置日志文件
logging:
  config: classpath:logback.xml
  #设置日志级别的节点
  level:
    com:
      jzj: debug

通过以上步骤,我们成功地在Spring Boot项目中配置和使用了logback日志文件。logback提供了丰富的配置选项和强大的日志功能,可以帮助我们更好地进行系统开发和调试。希望本文对您有所帮助!

你可能感兴趣的:(spring,boot,logback,后端)