SpringBoot日志配置详情

一、介绍

在所有的项目中，日志是必不可少的，为了高效清晰的查找日志，可以配置日志输出的等级和格式。

在配置后，可以自定义输出日志到指定目录，可以按照天数来分割日志，可以按照日志级别分割日志，可以按照大小来进行分割日志。

输出的日志方式，可以说五花八门，但总有一款适合你的项目

二、简单配置

1、日志的级别

关于日志的级别打印，需要搞清楚日志等级的优先级

import lombok.extern.slf4j.Slf4j;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;

@Slf4j
@Component
public class LoggerTask {

    @Scheduled(cron = "0/30 * * * * ?")
    public void logTask(){
        // 日志级别，由低到高，trace < debug < info < warn < error
        log.trace("TRACE");
        log.debug("DEBUG日志");
        log.info("INFO日志");
        log.warn("WARN日志");
        log.error("ERROR日志");
    }
    
}

在SpringBoot的yaml配置文件中，添加相关日志的配置文件

# 日志配置
logging:
    level:
        # 代表工程所有类的日志等级
        root: info

以下是日志的打印，发现比info级别低的debug和trace级别的日志没有打印出来。

在实际项目中，除了日志输出的规范，合理利用日志等级，也可以达到清晰日志的规范，排查问题会变得高效

除了logging.level.root，还可以指定对应包和类的日志级别 配置文件和测试代码 # 日志配置 logging: level: # 代表工程所有包的日志等级 root: info # 指定包下的日志等级 com.banmoon.spring_boot_logger.mapper: debug import com.banmoon.spring_boot_logger.mapper.UserMapper; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.scheduling.annotation.Scheduled; import org.springframework.stereotype.Component; @Slf4j @Component public class LoggerTask { @Autowired private UserMapper userMapper; /** * 定时去查询数据库表 */ @Scheduled(cron = "10 * * * * ?") public void dbDemonstration(){ log.info("====================="); int count = userMapper.countByExample(null); log.info("用户条数：{}", count); log.info("====================="); } }

2、日志的打印格式

虽然springBoot的日志打印格式足够清晰明了，但它支持自定义打印格式，还是记录一波吧

配置文件指定格式

# 日志配置
logging:
    pattern:
        # 格式化控制台输出的日志
        console: "%red(%d{yyyy-MM-dd HH:mm:ss.SSS}) %green([%thread]) %blue([%-5level]) %cyan(%logger{36}:%line) %msg%n"

简单说明一下这段格式化的意思，学会大家就可以配置自己喜欢的格式了

%red: 指定颜色，记得用小括号将内容包裹起来
%d: 日期时间，后面的是日期格式化
%thred: 线程名
%-5level: 日志级别，%-5表示的是打印字符个数，如果个数不足则用空格补上
%logger{36}: 输出日志的包名，最长36字符，超过则会简化，只会输出后面几个包名和类名
%line: 输出日志的行数
%msg: 输出的日志信息
%n: 换行

3、日志的持久化输出

在日常的开发中，控制台输出的日志就满足开发的需求了。但是在测试生产环境下，日志的持久化保存就显得格外的重要，springBoot也考虑到了这一点，也拥有相对应的配置

# 日志配置
logging:
    # 输出日志文件的路径，log=相对路径，D:/log=绝对路径，文件名默认为spring.log
    path: D:/log
    # 输出到指定的文件中，同样可以指定相对路径
    file: log/spring-boot-logger.log
    pattern:
        # 持久化输出日志的格式，颜色不起作用，需要区别于控制台
        file: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%-5level] %logger{36}:%line %msg%n"

相对路径，指定logging.file输出

绝对路径，指定logging.path输出

注意：logging.path和logging.file只需指定一个便可，两个都指定时，仅会输出logging.file的日志

三、高级配置

在创建springBoot项目后，简单的日志配置可以满足我们大部分的需求，但我们有时需要高度自定义的日志，比如说

• 按天生成日志：一天一份日志，排查问题就方便的多
• 按日志大小来切割日志：假如日志超过存储大小，它会自动将日志写入新的文件中
• 按日志等级输出独立的日志：一般选择ERROR级别的日志单独输出

1、配置模板

在resources目录下，创建文件logback/logback.xml，并在配置文件指定logback的配置文件

logging:
    config: classpath:logback/logback.xml

logback.xml文件配置

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="30 seconds" debug="true">

    <!-- 获取日志文件的输出路径 -->
    <springProperty scope="context" name="LOG_PATH" source="logging.log_path"/>
    <!-- 获取该应用的名称 -->
    <springProperty scope="context" name="APPLICATION_NAME" source="spring.application.name"/>

    <!-- 定义日志输出格式和颜色 -->
    <property name="LOG_FORMAT_ONE" value="%red(%d{yyyy-MM-dd HH:mm:ss.SSS}) %green([%thread]) %blue([%-5level]) %cyan(%logger{36}:%line) %msg%n" />
    <property name="LOG_FORMAT_TWO" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%-5level] %logger{36}:%line %msg%n" />

    <!-- 输出到控制台 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <!-- 日志输出编码格式化 -->
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <Pattern>${LOG_FORMAT_ONE}</Pattern>
            <charset>UTF-8</charset>
        </encoder>
        <!-- 过滤器，此过滤器低于阈值的不再显示 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>info</level>
        </filter>
    </appender>

	<!-- 时间日期滚动日志 -->
	<appender name="FILE_INFO" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<!-- 输出的日志远程，当天的日志名称 -->
		<file>${LOG_PATH}/info.log</file>
		<!-- 策略配置 -->
		<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
			<!-- 保存归纳的日志 -->
			<fileNamePattern>${LOG_PATH}/%d{yyyy-MM-dd}/info_%i.log</fileNamePattern>
			<!-- 日志文件最大尺寸 -->
			<maxFileSize>50MB</maxFileSize>
			<!--日志文件保留天数-->
			<MaxHistory>90</MaxHistory>
		</rollingPolicy>
		<!-- 日志输出编码格式化 -->
		<encoder>
			<pattern>${LOG_FORMAT_TWO}</pattern>
			<charset>UTF-8</charset>
		</encoder>
	</appender>

    <!-- 时间日期滚动日志，只记录error级别的日志 -->
    <appender name="FILE_ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/${APPLICATION_NAME}/${APPLICATION_NAME}_error.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/${APPLICATION_NAME}/%d{yyyy-MM-dd}/${APPLICATION_NAME}_error.log</fileNamePattern>
            <maxHistory>180</maxHistory>
            <totalSizeCap>10GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>${LOG_FORMAT_TWO}</pattern>
            <charset>UTF-8</charset>
        </encoder>
        <!-- 过滤器，日志级别过滤，仅输出error日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>

    <!-- 指定输出的日志等级，root代表工程所有包 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE_INFO" />
        <appender-ref ref="FILE_ERROR" />
    </root>

    <!-- 指定输出的日志等级，指定包路径，此包下都以设置的等级输出 -->
    <!-- additivity表示日志是否向上传递，如果为true，日志在root可能会再次打印 -->
    <logger name="com.banmoon.spring_boot_logger.mapper" level="DEBUG" additivity="false">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE_INFO" />
        <appender-ref ref="FILE_ERROR" />
    </logger>

</configuration>

2、通过运行环境来指定对应的输出策略

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="30 seconds" debug="true">
    <!-- 或者通过环境来指定输出的策略 -->
    <springProfile name="dev">
        <include resource="logback/logback-dev.xml" />
    </springProfile>
    <springProfile name="test | prod">
        <include resource="logback/logback-prod.xml" />
    </springProfile>
</configuration>

logback-dev.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<included>
    <!-- 开发环境，日志只至控制台 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
    </root>

    <logger name="com.banmoon.spring_boot_logger.mapper" level="DEBUG" additivity="false">
        <appender-ref ref="CONSOLE" />
    </logger>
</included>

logback-prod.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<included>
    <!-- 测试，生产环境，持久化日志文件 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE_INFO" />
        <appender-ref ref="FILE_ERROR" />
    </root>

    <logger name="com.banmoon.spring_boot_logger.mapper" level="DEBUG" additivity="false">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE_INFO" />
        <appender-ref ref="FILE_ERROR" />
    </logger>
</included>

3、相关配置标签

四、官方配置文档和git地址

• logback
• springBoot日志配置
• gitee