基于logback 实现springboot超级详细的日志配置

前言

java web 下有好几种日志框架，比如：logback，log4j，log4j2（slj4f 并不是一种日志框架，它相当于定义了规范，实现了这个规范的日志框架就能够用 slj4f 调用）。其中性能最高的应该使 logback 了，而且 springboot 默认使用的也是 logback 日志，所以本篇将会详细的讲解 logback 的日志配置方案。

本篇主要内容如下：

•logback 配置文件的构成
•如何将日志输出到文件
•如何按时间，按大小切分日志
•如何将让一个日志文件中只有一种日志级别
•如何将指定包下的日志输出到指定的日志文件中

简单使用

如果无需复杂的日志配置，执行简单设置日志打印级别，打印方式可直接再 application.yml 中配置。

默认情况下 spring boot 将 info 级别的日志输出到控制台中，不会写到日志文件，且不能进行复杂配置。 

打印到文件中

想要将日志输出到文件中，可通过如下两个配置：

logging:
 # 配置输出额日志文件名,可以带路径
 # file: out.log
 # 配置日志存放路径,日志文件名为：spring.log
 path: ./log
 file:
  # 设置日志文件大小
  max-size: 10mb

注意:file 和 path 是不能同时配置的，如果同时配置path不会生效。

打印级别控制

可通过配置控制日志打印级别，格式如下：

logging.level.*=trace/debug/info/...

*可以为包名或 logger 名，如下：
logging:
 level:
  # root日志以warn级别输出
  root: info
  # 此包下所有class以debug级别输出
  com.example.log_demo.log1: warn

logback 详细配置

接下来说明如何通过独立的 xml 配置文件来配置日志打印。虽然 springboot 是要消灭 xml 的，但是有些复杂功能还是得编写 xml。使用 xml 后要将 application.yml 中的配置去掉，避免冲突.

根据不同的日志系统，按照指定的规则组织配置文件名，并放在 resources 目录下，就能自动被 spring boot 加载：

•logback：logback-spring.xml, logback-spring.groovy, logback.xml, logback.groovy
•log4j: log4j-spring.properties, log4j-spring.xml, log4j.properties, log4j.xml
•log4j2: log4j2-spring.xml, log4j2.xml
•jdk (java util logging)： logging.properties

想要自定义文件名的可配置：logging.config指定配置文件名:

logging.config=classpath:logging-config.xml

spring boot 官方推荐优先使用带有 -spring 的文件名作为你的日志配置（如使用 logback-spring.xml ，而不是 logback.xml ），命名为 logback-spring.xml 的日志配置文件， spring boot 可以为它添加一些 spring boot 特有的配置项（下面会提到）。

logback 配置文件的组成

根节点<configuration>有 5 个子节点，下面来进行一一介绍。

<root>节点

root 节点是必选节点，用来指定最基础的日志输出级别，只有一个 level 属性，用于设置打印级别，可选如下：trace,debug,info,warn,error,all,off。

root 节点可以包含 0 个或多个元素，将appender添加进来。如下：

<root level="debug">
 <appender-ref ref="console" />
 <appender-ref ref="file" />
</root>

appender 也是子节点之一，将会在后面说明。

<contextname>节点

设置上下文名称，默认为default，可通过%contextname来打印上下文名称，一般不使用此属性。

<property>节点

用于定义变量，方便使用。有两个属性：name,value。定义变量后，可以使用${}来使用变量。如下：

<property name="path" value="./log"/>
<property name="appname" value="app"/>

<appender>节点

appender 用来格式化日志输出的节点，这个最重要。有两个属性：

•name:该本 appender 命名
•class:指定输出策略，通常有两种：控制台输出，文件输出

下面通过例子来说明这个怎么用：

1.输出到控制台/按时间输出日志

<?xml version="1.0" encoding="utf-8"?>
<configuration debug="false">
  <!--设置存储路径变量-->
  <property name="log_home" value="./log"/>

  <!--控制台输出appender-->
  <appender name="console" class="ch.qos.logback.core.consoleappender">
    <!--设置输出格式-->
    <encoder class="ch.qos.logback.classic.encoder.patternlayoutencoder">
      <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
      <pattern>%d{yyyy-mm-dd hh:mm:ss.sss} [%thread] %-5level %logger{50} - %msg%n</pattern>
      <!--设置编码-->
      <charset>utf-8</charset>
    </encoder>
  </appender>

  <!--文件输出,时间窗口滚动-->
  <appender name="timefileoutput" class="ch.qos.logback.core.rolling.rollingfileappender">
    <!--日志名,指定最新的文件名，其他文件名使用filenamepattern -->
    <file>${log_home}/timefile/out.log</file>
    <!--文件滚动模式-->
    <rollingpolicy class="ch.qos.logback.core.rolling.timebasedrollingpolicy">
      <!--日志文件输出的文件名,可设置文件类型为gz,开启文件压缩-->
      <filenamepattern>${log_home}/timefile/info.%d{yyyy-mm-dd}.%i.log.gz</filenamepattern>
      <!--日志文件保留天数-->
      <maxhistory>30</maxhistory>
      <!--按大小分割同一天的-->
      <timebasedfilenamingandtriggeringpolicy class="ch.qos.logback.core.rolling.sizeandtimebasedfnatp">
        <maxfilesize>10mb</maxfilesize>
      </timebasedfilenamingandtriggeringpolicy>
    </rollingpolicy>

    <!--输出格式-->
    <encoder class="ch.qos.logback.classic.encoder.patternlayoutencoder">
      <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
      <pattern>%d{yyyy-mm-dd hh:mm:ss.sss} [%thread] %-5level %logger{50} - %msg%n</pattern>
      <!--设置编码-->
      <charset>utf-8</charset>
    </encoder>

  </appender>

  <!--指定基础的日志输出级别-->
  <root level="info">
    <!--appender将会添加到这个loger-->
    <appender-ref ref="console"/>
    <appender-ref ref="timefileoutput"/>
  </root>
</configuration>

1.设置只输出单个级别

在 appender 中设置,filter 子节点，在默认级别上再此过滤，配置 onmatch，onmismatch 可实现只输出单个级别

<appender ...>
  <filter class="ch.qos.logback.classic.filter.levelfilter">
    <level>info</level>
    <!--接受匹配-->
    <onmatch>accept</onmatch>
    <!--拒绝不匹配的-->
    <onmismatch>deny</onmismatch>
  </filter>
</appender>

<logger>节点

构成

此节点用来设置一个包或具体的某一个类的日志打印级别、以及指定<appender>，有以下三个属性：

•name: 必须。用来指定受此 loger 约束的某个包或者某个具体的类
•level：可选。设置打印级别。默认为 root 的级别。
•addtivity: 可选。是否向上级 loger(也就是 root 节点)传递打印信息。默认为 true。

使用示例如下：

1.不指定级别，不指定 appender

<!-- 控制com.example.service下类的打印，使用root的level和appender -->
<logger name="com.example.service"/>

2.指定级别，不指定 appender

<!-- 控制com.example.service下类的打印，使用root的appender打印warn级别日志 -->
<logger name="com.example.service" level="warn"/>

3.指定级别，指定 appender

<!-- 控制com.example.service下类的打印，使用console打印warn级别日志 -->
<!-- 设置addtivity是因为这里已经指定了appender，如果再向上传递就会被root下的appender再次打印 -->
<logger name="com.example.service" level="warn" addtivity="false">
  <appender-ref ref="console">
</logger>

通过指定 appender 就能将指定的包下的日志打印到指定的文件中。

多环境日志输出

通过设置文件名为-spring 结尾，可分环境配置 logger，示例如下：

<configuration>
  <!-- 测试环境+开发环境. 多个使用逗号隔开. -->
  <springprofile name="test,dev">
    <logger name="com.example.demo.controller" level="debug" additivity="false">
      <appender-ref ref="console"/>
    </logger>
  </springprofile>
  <!-- 生产环境. -->
  <springprofile name="prod">
    <logger name="com.example.demo" level="info" additivity="false">
      <appender-ref ref="timefileoutput"/>
    </logger>
  </springprofile>
</configuration>

通过配置spring.profiles.active也能做到切换上面的 logger 打印设置

结束

日志打印可以很复杂， 这里只是说明了常用的 logback 配置，代码详见：github

总结

以上所述是小编给大家介绍的基于logback 实现springboot超级详细的日志配置,希望对大家有所帮助