SpringBoot.06.SpringBoot日志管理

x33g5p2x  于2021-09-19 转载在 Spring  
字(10.2k)|赞(0)|评价(0)|浏览(513)

SpringBoot日志介绍

概念

在SpringBoot框架中默认集成的日志处理框架是Logback。Logback是由log4j创始人设计的又一个开源日志组件。目前logback分为三个模块:logback-core、logback-classic和logback-access。它是对log4j日志展示进一步改进,相比较与log4j,logback更加轻量!

日志的级别

在SpringBoot中日志分为以下8类:

  • Off:关闭,日志的最低级别,不打印日志
  • Fatal:致命错误,指明非常严重的可能会导致应用终止执行的错误时间
  • Error:错误,指明错误事件,但应用可能还能继续运行
  • Warn:警告,指明可能潜在的危险状况
  • Info:信息,指明描述信息,从粗粒度上描述了应用运行过程
  • Debug:调试,指明细致的事件信息,对调试应用最有用
  • Trace:跟踪,指明程序运行轨迹,比DEBUG级别的粒度更细
  • All:所有,所有日志级别,包括定制级别

日志级别由低到高,级别越高,输出的日志信息越多。如下图所示:

日志的分类

在项目中,日志分为两类:rootLoggerlogger

  • rootLogger:根全局日志,用来监听项目中的所有运行日志,包括引入依赖jar中的日志
  • logger:指定包级别日志,用来监听项目中指定包的日志信息

SpringBoot日志基本使用

1.新建Module

打开IDEA,新建Module – springboot-05-logback,按下图所示填写相应信息,点击Next

在Dependencies中勾选Spring Web,点击Finish,如下图所示:

2.项目配置

我们将项目springboot-04-mybatis中的代码拷贝过来,整理一下项目结构。如下图所示:

3.配置日志

在SpringBoot框架中默认的根日志级别为INFO,这个在项目启动时通过控制套打印输出能看出来。如下图所示:

如果我们想要更改默认的根日志级别,可以修改配置文件如下:

server:
  port: 8805

# datasource
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: com.mysql.jdbc.Driver
    url: jdbc:mysql://localhost:3306/christy?characterEncoding=UTF-8
    username: root
    password: 123456

# mybatis
mybatis:
  mapper-locations: classpath:com/christy/mapper/*.xml
  type-aliases-package: com.christy.entity

# logback
logging:
  level:
    root: debug

我们运行单元测试测试UserTest中的findAll(),可以发现控制台吗,明显多了很多DEBUG日志的输出,而且还打印输出了相应的sql语句。如下图所示:

那么问题来了,如果我想在控制台打印输出sql语句,但是又不想看到Debug信息怎么办?这就要用到我们上面所说的包级别日志了。我们修改配置文件如下:

server:
  port: 8805

# datasource
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: com.mysql.jdbc.Driver
    url: jdbc:mysql://localhost:3306/christy?characterEncoding=UTF-8
    username: root
    password: 123456

# mybatis
mybatis:
  mapper-locations: classpath:com/christy/mapper/*.xml
  type-aliases-package: com.christy.entity

# logback
logging:
  level:
    root: info  # 指定全局根日志级别为INFO(默认)
    com.christy.mapper: debug   # 指定包级别日志为debug,在控制台不打印DEBUG日志时能看到sql语句

然后们再次运行上面的单元测试方法,可以看到控制台没有打印框架DEBUG日志,而只是打印了指定包级别日志的DEBUG信息,这个信息就是我们想要的sql信息。如下图所示:

SpringBoot日志切割

上面虽然能够打印我们想要的日志,但是在实际开发中我们不仅需要在控制台输出日志信息,还需要将运行日志输出到磁盘上,便于日常维护。这个时候就需要日志切割功能了。

在实际开发中我们的开发环境和生产环境配置文件和日志配置是不一样的,一半般都要做多环境配置。这里我们先调整一下resources的目录结构,如下图所示:

官方推荐使用的xml名字的格式为:logback-spring.xml而不是logback.xml,带spring后缀的可以使用<springProfile>这个标签。
这是因为logback.xml加载早于application.properties,所以如果你在logback.xml使用了变量时,而恰好这个变量是写在application.properties时,那么就会获取不到,只要改成logback-spring.xml就可以解决。

1.application.yml

# 指定当前为开发环境
spring:
  profiles:
    active: dev   # 开发环境端口号为8805

2.application-dev.yml

server:
  port: 8805

# datasource
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: com.mysql.jdbc.Driver
    url: jdbc:mysql://localhost:3306/christy?characterEncoding=UTF-8
    username: root
    password: 123456
  ldap:
    template:
      ignore-name-not-found-exception:

# mybatis
mybatis:
  mapper-locations: classpath:com/christy/mapper/*.xml
  type-aliases-package: com.christy.entity

# logback
# logging:
# level:
# root: info # 指定全局根日志级别为INFO(默认)
# com.christy.mapper: debug # 指定包级别日志为debug,在控制台不打印DEBUG日志时能看到sql语句

# 多环境下我们需要指定当前使用的日志文件
logging:
  config: classpath:logs/logback-dev.xml

3.logback-dev.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- 从低到高 OFF -> FATAL -> ERROR -> WARN -> INFO -> DEBUG -> TRACE -> ALL -->

<!-- 属性描述 scan:性设置为true时,配置文件如果发生改变,将会被重新加载,默认值为true scanPeriod:设置监测配置文件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒。当scan为true时,此属性生效。默认的时间间隔为1分钟。 debug:当此属性设置为true时,将打印出logback内部日志信息,实时查看logback运行状态。默认值为false。 -->
<configuration scan="true" scanPeriod="60 seconds" debug="false">
    <!-- 定义日志文件输出位置:在当前项目根目录下的logs/spring-05-logback -->
    <property name="log_path" value="/logs/spring-05-logback" />
    <!-- 日志最大的历史 30天 -->
    <property name="maxHistory" value="30" />
    <!-- 文件输出格式 -->
    <!-- 格式化输出: %d:表示日期, %thread:表示线程名 %-5level:级别从左显示5个字符宽度 %msg:日志消息 %n:是换行符 -->
    <property name="PATTERN" value="%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger -%msg%n" />

    <!-- ConsoleAppender用于在屏幕上输出日志-->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <!--定义了一个过滤器,在LEVEL之下的日志输出会被打印出来-->
        <!-- 控制台只打印INFO及其以下级别的logger -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>DEBUG</level>
        </filter>
        <!-- encoder 默认配置为PatternLayoutEncoder -->
        <!-- 定义控制台输出格式与编码 -->
        <encoder>
            <pattern>${PATTERN}</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!-- ERROR级别日志 -->
    <!-- 滚动记录文件,先将日志记录到指定文件,当符合某个条件时,将日志记录到其他文件 RollingFileAppender -->
    <appender name="ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤器,只记录ERROR级别的日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <!-- 只接收与当前级别匹配的logger信息 -->
            <onMatch>ACCEPT</onMatch>
            <!-- 拒绝与当前级别匹配的logger信息 -->
            <onMismatch>DENY</onMismatch>
        </filter>

        <!-- 最常用的滚动策略,它根据时间来制定滚动策略.既负责滚动也负责出发滚动 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--日志输出位置 可相对、和绝对路径 -->
            <fileNamePattern>${log_path}/%d{yyyy-MM-dd}/error-log.log</fileNamePattern>
            <!-- 可选节点,控制保留的归档文件的最大数量,超出数量就删除旧文件 注意,删除旧文件是,那些为了归档而创建的目录也会被删除 -->
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>

        <!-- 按照固定窗口模式生成日志文件,当文件大于20MB时,生成新的日志文件。窗口大小是1到3,当保存了3个归档文件后,将覆盖最早的日志。 -->
        <!--<rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy"> <fileNamePattern>${log_path}/%d{yyyy-MM-dd}/.log.zip</fileNamePattern> <minIndex>1</minIndex> <maxIndex>3</maxIndex> </rollingPolicy>-->

        <!-- 查看当前活动文件的大小,如果超过指定大小会告知RollingFileAppender 触发当前活动文件滚动 -->
        <!--<triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy"> <maxFileSize>5MB</maxFileSize> </triggeringPolicy>-->

        <encoder>
            <pattern>${PATTERN}</pattern>
        </encoder>
    </appender>

    <!-- WARN级别日志appender -->
    <appender name="WARN" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤器,只记录WARN级别的日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>WARN</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>

        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 按天回滚 daily -->
            <fileNamePattern>${log_path}/%d{yyyy-MM-dd}/warn-log.log</fileNamePattern>
            <!-- 日志最大的历史 -->
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>

        <encoder>
            <pattern>${PATTERN}</pattern>
        </encoder>
    </appender>

    <!-- INFO级别日志 appender -->
    <appender name="INFO" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤器,只记录INFO级别的日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>INFO</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>

        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 按天回滚 daily -->
            <fileNamePattern>${log_path}/%d{yyyy-MM-dd}/info-log.log</fileNamePattern>
            <!-- 日志最大的历史 -->
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>

        <encoder>
            <pattern>${PATTERN}</pattern>
        </encoder>
    </appender>

    <!-- DEBUG级别日志 appender -->
    <appender name="DEBUG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤器,只记录DEBUG级别的日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>DEBUG</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>

        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 按天回滚 daily -->
            <fileNamePattern>${log_path}/%d{yyyy-MM-dd}/debug-log.log
            </fileNamePattern>
            <!-- 日志最大的历史 -->
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>

        <encoder>
            <pattern>${PATTERN}</pattern>
        </encoder>
    </appender>

    <!-- TRACE级别日志 appender -->
    <appender name="TRACE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤器,只记录TRACE级别的日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>TRACE</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>

        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 按天回滚 daily -->
            <fileNamePattern>${log_path}/%d{yyyy-MM-dd}/trace-log.log</fileNamePattern>
            <!-- 日志最大的历史 60天 -->
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>

        <encoder>
            <pattern>${PATTERN}</pattern>
        </encoder>
    </appender>

    <!-- <logger>用来设置某一个包或者具体的某一个类的日志打印级别以及指定<appender>。 <logger>仅有一个name属性,一个可选的level和一个可选的addtivity属性。 name:用来指定受此logger约束的某一个包或者具体的某一个类。 level:用来设置打印级别,大小写无关:TRACE、DEBUG、INFO、WARN、ERROR、ALL、OFF, 还有一个特俗值INHERITED或者同义词NULL,代表强制执行上级的级别。 如果未设置此属性,那么当前logger将会继承上级的级别。 addtivity:是否向上级logger传递打印信息。默认是true。 -->
    <!--<logger name="org.springframework.web" level="info"/>-->
    <!--<logger name="org.springframework.scheduling.annotation.ScheduledAnnotationBeanPostProcessor" level="INFO"/>-->
    <!-- 使用mybatis的时候,sql语句是debug下才会打印,而这里我们只配置了info,所以想要查看sql语句的话,有以下两种操作: 第一种把<root level="info">改成<root level="DEBUG">这样就会打印sql,不过这样日志那边会出现很多其他消息 第二种就是单独给dao下目录配置debug模式,代码如下,这样配置sql语句会打印,其他还是正常info级别: -->
    <!-- mybatis日志打印sql-->
    <logger name="com.christy.mapper" level="DEBUG"></logger>

    <!-- root级别 INFO -->
    <root level="INFO">
        <!-- 控制台输出 -->
        <appender-ref ref="CONSOLE" />
        <!-- 一般情况下我们只输出以下4种日志就可以了 -->
        <appender-ref ref="ERROR" />
        <appender-ref ref="INFO" />
        <appender-ref ref="WARN" />
        <appender-ref ref="DEBUG" />
        <!-- Trace一般情况下我们不输出 -->
        <appender-ref ref="TRACE" />
    </root>
</configuration>

对于配置文件和日志处理,目前开发和生产的环境是一样的,暂时不做区分处理

4.测试

我们再次运行上面的单元测试方法,注意观察控制台。效果如下:

本地磁盘上也已经记录下了详细的日志信息,如下图所示:

相关文章