统一日志处理

目录

一、Logback日志

1、什么是日志

2、日志级别

3、创建日志文件

4、创建测试日志输出

二、基本配置说明

1、configuration

2、contextName

3、property

4、appender

控制台日志配置

文件日志配置

5、logger

6、测试

三、多环境配置

1、springProfile

四、滚动日志

1、设置时间滚动策略

2、设置触发滚动时机

五、完整的日志配置文件


一、Logback日志

1、什么是日志

通过日志查看程序的运行过程,运行信息,异常信息等

2、日志级别

日志记录器(Logger)的行为是分等级的。如下表所示:

分为:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF

默认情况下,spring boot从控制台打印出来的日志级别只有INFO及以上级别,可以配置日志级别

# 设置日志级别
logging:
  level:
    root: ERROR

这种方式能将ERROR级别以及以上级别的日志输出到控制台上,其他级别将不会输出

3、创建日志文件

spring boot内部使用Logback作为日志实现的框架。

先删除前面在application.yml中的日志级别配置

resources 中创建 logback-spring.xml (默认日志文件的名字)

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

4、创建测试日志输出

将以下日志输出到任意controller的方法中即可,例如list方法中

@ApiOperation("积分等级列表")
@GetMapping("/list")
public R listAll(){
    log.info("hi i'm helen");
    log.warn("warning!!!");
    log.error("it's a error");
    List<IntegralGrade> list = integrationService.list();
    return R.ok().data("list", list);
}

二、基本配置说明

1、configuration

日志配置的根节点

<configuration></configuration>

2、contextName

<contextName>是<configuration>的子节点。

每个logger都关联到logger上下文,默认上下文名称为“default”。但可以使用<contextName>设置成其他名字,用于区分不同的应用程序。

<contextName>BUBAYKASrb</contextName>

3、property

<property>是<configuration>的子节点,用来定义变量。

<property> 有两个属性,name和value:name的值是变量的名称,value是变量的值。

通过<property>定义的值会被插入到logger上下文中。定义变量后,可以使“${}”来使用变量。

<!-- 日志的输出目录 -->
<property name="log.path" value="D:/Java/尚融宝金融项目/log" />
<!--控制台日志格式:彩色日志-->
<!-- magenta:洋红 -->
<!-- boldMagenta:粗红-->
<!-- cyan:青色 -->
<!-- white:白色 -->
<!-- magenta:洋红 -->
<property name="CONSOLE_LOG_PATTERN"
          value="%yellow(%date{yyyy-MM-dd HH:mm:ss}) %highlight([%-5level]) %green(%logger) %msg%n"/>
<!--文件日志格式-->
<property name="FILE_LOG_PATTERN"
          value="%date{yyyy-MM-dd HH:mm:ss} [%-5level] %thread %file:%line %logger %msg%n" />
<!--编码-->
<property name="ENCODING"
          value="UTF-8" />

4、appender

<appender>是<configuration>的子节点,是负责写日志的组件,记录在什么地方(控制器/文件输出)

<appender>有两个必要属性name和class:name指定appender名称,class指定appender的全限定名

<encoder>对日志进行格式化

<pattern>定义日志的具体输出格式

<charset>编码方式

控制台日志配置

<!-- ConsoleAppender控制台日志 -->
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>${CONSOLE_LOG_PATTERN}</pattern>
        <charset>${ENCODING}</charset>
    </encoder>
</appender>

文件日志配置

<file>表示日志文件的位置,如果上级目录不存在会自动创建,没有默认值。

<append>默认 true,日志被追加到文件结尾,如果是 false,服务重启后清空现存文件。

<!-- FileAppender文件日志 -->
<appender name="FILE" class="ch.qos.logback.core.FileAppender">
    <file>${log.path}/log.log</file>
    <append>true</append>
    <encoder>
        <pattern>${FILE_LOG_PATTERN}</pattern>
        <charset>${ENCODING}</charset>
    </encoder>
</appender>

5、logger

<logger>可以是<configuration>的子节点,用来设置某一个包或具体某一个类的日志打印级别、指定<appender>

name:用来指定受此logger约束的某一个包或者具体的某一个类

level:用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF。默认继承上级的级别

<logger>可以包含零个或多个<appender-ref>元素,标识这个appender将会添加到这个logger

<!-- 日志记录器  -->
<logger name="com.buba.yka" level="INFO">
    <appender-ref ref="CONSOLE" /> <!--打印到控制台-->
    <appender-ref ref="FILE" /> <!--打印到文件中-->
</logger>

6、测试

测试日志记录的控制台输出、文件输出、以及日志级别

三、多环境配置

1、springProfile

在一个基于Spring boot开发的项目里,常常需要有多套环境的配置:开发,测试以及产品。

使用springProfile 可以分别配置开发(dev),测试(test)以及生产(prod)等不同的环境

环境配置基于yml配置文件中

<!-- 开发环境和测试环境,级别INFO输出到控制台 -->
<springProfile name="dev,test">
    <logger name="com.buba.yka" level="INFO">
        <appender-ref ref="CONSOLE" />
    </logger>
</springProfile>
<!-- 生产环境,级别为ERROR输出到控制台和文件中 -->
<springProfile name="prod">
    <logger name="com.buba.yka" level="ERROR">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE" />
    </logger>
</springProfile>

四、滚动日志

问题:生产环境下,如果系统长时间运行,那么日志文件会变得越来越大,系统读取和写入日志的时间会越来越慢,严重的情况会耗尽系统内存,导致系统宕机。

解决方案:可以设置滚动日志。

设置时间滚动策略:第二天会生成新的日志文件

设置触发滚动时机:单个文件内存大于指定内存,生成新的日志文件

1、设置时间滚动策略

第二天会生成新的日志文件,格式为:log-rolling-2023-07-14.0.log

RollingFileAppender是Appender的另一个实现,表示滚动记录文件,先将日志记录到指定文件,当符合某个条件时,将旧日志备份到其他文件

<rollingPolicy>是<appender>的子节点,用来定义滚动策略。

TimeBasedRollingPolicy:最常用的滚动策略,根据时间来制定滚动策略。

<fileNamePattern>:包含文件名及转换符, “%d”可以包含指定的时间格式,如:%d{yyyy-MM-dd}。如果直接使用 %d,默认格式是 yyyy-MM-dd。<maxHistory>:可选节点,控制保留的归档文件的最大数量,超出数量就删除旧文件。假设设置每个月滚动,且<maxHistory>是6,则只保存最近6个月的文件,删除之前的旧文件。注意,删除旧文件是,那些为了归档而创建的目录也会被删除。

<appender name="ROLLING_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <!--  要区别于其他的appender中的文件名字  -->
    <file>${log.path}/log-rolling.log</file>
    <encoder>
        <pattern>${FILE_LOG_PATTERN}</pattern>
        <charset>${ENCODING}</charset>
    </encoder>
    <!-- 设置滚动日志记录的滚动策略 TimeBasedRollingPolicy:最常用的滚动策略,根据时间来制定滚动策略。-->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <!-- 日志归档路径以及格式 -->
        <fileNamePattern>${log.path}/info/log-rolling-%d{yyyy-MM-dd}.log</fileNamePattern>
        <!--归档日志文件保留的最大数量-->
        <maxHistory>15</maxHistory>
    </rollingPolicy>
</appender>

2、设置触发滚动时机

设置触发滚动时机:单个文件内存大于指定内存,生成新的日志文件,格式为:log-rolling-2023-07-14.1.log

放在<rollingPolicy>的子节点的位置,基于实践策略的触发滚动策略

<maxFileSize>设置触发滚动条件:单个文件大于100M时生成新的文件

注意:修改日志文件名 此时 <fileNamePattern>${log.path}/info/log-rolling-%d{yyyy-MM-dd}.%i.log</fileNamePattern>

.%i:代表第几个文件。如0.log,1.log,2.log ...

<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
    <maxFileSize>1KB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>

五、完整的日志配置文件

<?xml version="1.0" encoding="UTF-8"?>
<!--日志配置的根节点-->
<configuration>
    <!--每个logger都关联到logger上下文,默认上下文名称为“default”。但可以使用<contextName>设置成其他名字,用于区分不同的应用程序。-->
    <contextName>BUBAYKASrb</contextName>
    <!--
    <property>是<configuration>的子节点,用来定义变量。
    <property> 有两个属性,name和value:name的值是变量的名称,value是变量的值。
    通过<property>定义的值会被插入到logger上下文中。定义变量后,可以使“${}”来使用变量。
    -->
    <!-- 日志的输出文件目录 -->
    <property name="log.path" value="D:/Java/尚融宝金融项目/log" />
    <!--控制台日志格式:彩色日志-->
    <!-- magenta:洋红 -->
    <!-- boldMagenta:粗红-->
    <!-- cyan:青色 -->
    <!-- white:白色 -->
    <!-- magenta:洋红 -->
    <property name="CONSOLE_LOG_PATTERN"
              value="%yellow(%date{yyyy-MM-dd HH:mm:ss}) %highlight([%-5level]) %green(%logger) %msg%n"/>
    <!--文件日志格式-->
    <property name="FILE_LOG_PATTERN"
              value="%date{yyyy-MM-dd HH:mm:ss} [%-5level] %thread %file:%line %logger %msg%n" />
    <!--编码-->
    <property name="ENCODING"
              value="UTF-8" />
    <!--
        <appender>是<configuration>的子节点,是负责写日志的组件,记录在什么地方
        <appender>有两个必要属性name和class:name指定appender名称,class指定appender的全限定名
        <encoder>对日志进行格式化
        <pattern>定义日志的具体输出格式
        <charset>编码方式
    -->
    <!-- ConsoleAppender控制台日志 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
            <charset>${ENCODING}</charset>
        </encoder>
    </appender>
    <!--
        <file>表示日志文件的位置,如果上级目录不存在会自动创建,没有默认值。
        <append>默认 true,日志被追加到文件结尾,如果是 false,服务重启后清空现存文件。
    -->
    <!-- FileAppender文件日志 -->
    <appender name="FILE" class="ch.qos.logback.core.FileAppender">
        <file>${log.path}/log.log</file>
        <append>true</append>
        <encoder>
            <pattern>${FILE_LOG_PATTERN}</pattern>
            <charset>${ENCODING}</charset>
        </encoder>
    </appender>
    <!--
        滚动日志
        设置时间滚动策略:第二天生成新的日志文件。
        设置触发滚动时机:单个文件内存大于指定内存生成新的日志文件
        RollingFileAppender是Appender的另一个实现,表示滚动记录文件,先将日志记录到指定文件,当符合某个条件时,将旧日志备份到其他文件
        <rollingPolicy>是<appender>的子节点,用来定义滚动策略。
        TimeBasedRollingPolicy:最常用的滚动策略,根据时间来制定滚动策略。
        <fileNamePattern>:包含文件名及转换符, “%d”可以包含指定的时间格式,如:%d{yyyy-MM-dd}。如果直接使用 %d,默认格式是 yyyy-MM-dd。
        <maxHistory>:可选节点,控制保留的归档文件的最大数量,超出数量就删除旧文件,
        假设设置每个月滚动,且<maxHistory>是6,则只保存最近6个月的文件,删除之前的旧文件。注意,删除旧文件是,那些为了归档而创建的目录也会被删除。
    -->
    <appender name="ROLLING_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!--  要区别于其他的appender中的文件名字  -->
        <file>${log.path}/log-rolling.log</file>
        <encoder>
            <pattern>${FILE_LOG_PATTERN}</pattern>
            <charset>${ENCODING}</charset>
        </encoder>
        <!-- 设置滚动日志记录的滚动策略,TimeBasedRollingPolicy:最常用的滚动策略,根据时间来制定滚动策略。 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 日志归档路径以及格式 -->
            <fileNamePattern>${log.path}/info/log-rolling-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <!--归档日志文件保留的最大数量-->
            <maxHistory>15</maxHistory>
            <!--
                设置触发滚动时机:单个文件内存大于指定内存生成新的日志文件
                放在<rollingPolicy>的子节点的位置,基于实践策略的触发滚动策略
                <maxFileSize>设置触发滚动条件:单个文件大于100M时生成新的文件
            -->
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>1KB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
    </appender>
    <!--
        <logger>可以是<configuration>的子节点,用来设置某一个包或具体某一个类的日志打印级别、指定<appender>
        name:用来指定受此logger约束的某一个包或者具体的某一个类
        level:用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF。默认继承上级的级别
        <logger>可以包含零个或多个<appender-ref>元素,标识这个appender将会添加到这个logger
    -->
    <!-- 日志记录器,有了多环境配置这里就可以注释了  -->
<!--    <logger name="com.buba.yka" level="INFO">-->
<!--        <appender-ref ref="CONSOLE" /> &lt;!&ndash;打印到控制台&ndash;&gt;-->
<!--        <appender-ref ref="FILE" /> &lt;!&ndash;打印到文件中&ndash;&gt;-->
<!--    </logger>-->
    
    <!--
        多环境配置
        在一个基于Spring boot开发的项目里,常常需要有多套环境的配置:开发,测试以及产品。
        使用springProfile 可以分别配置开发(dev),测试(test)以及生产(prod)等不同的环境
        环境基于yml文件配置的环境设置
    -->
    <!-- 开发环境和测试环境,级别INFO输出到控制台 -->
    <springProfile name="dev,test">
        <logger name="com.buba.yka" level="INFO">
            <appender-ref ref="CONSOLE" />
        </logger>
    </springProfile>
    <!-- 生产环境,级别为ERROR输出到控制台和文件中 -->
    <springProfile name="prod">
        <logger name="com.buba.yka" level="ERROR">
            <appender-ref ref="CONSOLE" />
            <appender-ref ref="ROLLING_FILE" />
        </logger>
    </springProfile>
</configuration>

 直接拿着😀!!!!!

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值