Logback的使用及如何配置

日志在项目开发过程的作用不言而喻，项目上线后，我们需要根据日志文件定位问题发生的位置以及产生的原因。以前在项目开发中，已经有前人在工程中配置过日志，所以完全不需要自己再进行日志的配置。这次在新的项目中自己来配置日志时，还是遇到了一些波折，下面慢慢道来。

1 为什么选用Logback？

目前，在Springboot工程体系中，使用较多的日志组件是Slf4j、Logback以及Log4j2。而Slf4j本身只是一个接口类，具体的实现还是由Logback或Log4j2来完成的。由于Springboot自身就集成了Logback，默认使用的日志组件是Logback，Logback的体系结构具有足够的通用性，可以在不同的场景下使用。因此，在我们的DRS工程中，使用了Logback进行日志的打印。

目前，Logback包含三个部分：logback-core, logback-classic, logback-access。 Logback-core： 为其他两个模块奠定了基础 Logback-classic: 可以被同化为log4j的一个显著改进的版本，此外， logback-classic实现了slf4japi，因此您可以方便地在logback和其他日志框架（如log4j或log4j）之间来回切换java.util.logging文件 Logback-access: 集成了Servlet容器（如Tomcat和Jetty），以提供HTTP访问日志功能。

如果使用的是Springboot是2.4版本及以上，则不需要另外引入logback-core, logback-classic, logback-access和slf2j-api的依赖包的。

2 Logback的配置

首先，看一下我们在DRS工程中使用的Logback配置文件:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <property name="log.path" value="/duan/drs-server/logs" />
  <property name="log.pattern" value="%d{HH:mm:ss.SSS} [%thread] %-5level %logger{20} - [%method,%line] - %msg%n" />

  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>${log.pattern}</pattern>
    </encoder>
  </appender>

  <!-- 系统debug日志输出 -->
  <appender name="FILE_DEBUG" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${log.path}/drs-server-debug.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>${log.path}/drs-server-debug.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder>
      <pattern>${log.pattern}</pattern>
    </encoder>
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>DEBUG</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>

  <!-- 系统info日志输出 -->
  <appender name="FILE_INFO" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${log.path}/drs-server-info.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>${log.path}/drs-server-info.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder>
      <pattern>${log.pattern}</pattern>
    </encoder>
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>INFO</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>

  <!-- 系统warn日志输出 -->
  <appender name="FILE_WARN" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${log.path}/drs-server-warn.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>${log.path}/drs-server-warn.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder>
      <pattern>${log.pattern}</pattern>
    </encoder>
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>WARN</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>

  <!-- 系统error日志输出 -->
  <appender name="FILE_ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${log.path}/drs-server-error.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>${log.path}/drs-server-error.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>30</maxHistory>
    </rollingPolicy>
    <encoder>
      <pattern>${log.pattern}</pattern>
    </encoder>
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>ERROR</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>

  <logger name="com.nuonuo.middleware.drsserver" level="INFO" />
  <logger name="org.springframework" level="warn" />

  <root level="INFO">
    <appender-ref ref="STDOUT" />
    <appender-ref ref="FILE_DEBUG" />
    <appender-ref ref="FILE_INFO" />
    <appender-ref ref="FILE_WARN" />
    <appender-ref ref="FILE_ERROR" />
  </root>
</configuration>

说明：

3 Logback的输出格式

针对以上述配置中的格式进行说明：

%d{HH:mm:ss.SSS} [%thread] %-5level %logger{20} - [%method,%line] - %msg%n

4 Appender

Appender子类包含Filter、Encoder、ConsoleAppender、FileAppender、以及RollingFileAppender。其类图关系如下所示。

顾名思义目标文件由file选项指定。如果该文件已存在，则根据append属性的值将其追加或截断。RollingFileAppender 扩展了FileAppender，具有滚动更新日志文件的功能。

OutputStreamAppender 这个类提供了其他附加程序构建的基本服务。该类包含两个属性设置： encoder—— 确定日志写入的编码格式。 immediateFlush——布尔值，默认为true， 立即刷新输出流可确保立即写出日志事件，并且在应用程序退出而未正确关闭附加器时不会丢失这些事件。 另一方面，将此属性设置为“false”可能会使日志吞吐量增加四倍。同样，如果immediateFlush设置为“false”，并且应用程序退出时appender未正确关闭，则尚未写入磁盘的日志事件可能会丢失。

ConsoleAppender 将日志附加在控制台上，其包含三个属性： encoder——略 target—— System.out或者 System.err字符串值之一 默认目标是 System.out withJansi——布尔值，默认false。 将withJansi设置为true将激活Jansi库，该库为Windows机器上的ANSI颜色代码提供支持。在Windows主机上，如果此属性设置为true，则应将网址：org.fusesource.jansi:jansi：1.17“在类路径上进行设置。请注意，基于Unix的操作系统（如Linux和macosx）默认支持ANSI颜色代码。一般我们很少用到，使用默认值即可。

FileAppender 它将日志事件附加到文件中，其包含四个属性： append——布尔值，默认为true， 表示事件附加在现有文件的末尾。如果append为false，则任何现有文件都将被截断。 encoder——略 file—— 要写入的文件的名称， 如果文件不存在，则创建该文件。 如果文件的父目录不存在，FileAppender将自动创建它，包括任何必要但不存在的父目录。 prudent——布尔值，默认值为false。如果设置为true， FileAppender将安全地写入指定的文件，即使存在运行在不同jvm（可能运行在不同主机上）中的其他FileAppender实例。

RollingFileAppender 扩展了FileAppender，具有滚动更新日志文件的功能，其包含以下几个属性： file——略 append——略 encoder——略 rollingPolicy—— 此选项是在发生滚动时指定RollingFileAppender行为的组件，包含SizeAndTimeBasedRollingPolicy、FixedWindowRollingPolicy、TimeBasedRollingPolicy。在上述配置中我们使用的是最为广泛的TimeBasedRollingPolicy。 triggeringPolicy—— 此选项是通知RollingFileAppender何时激活滚动更新过程的组件 prudent——布尔值，当为true时，不支持FixedWindowRollingPolicy。

5 Logback使用过程中遇到的问题

起初，在配置完logback.xml文件后，始终无法将日志输出到指定目录。 第一步，调试确认使用的是logback组件； 第二步，引入logback-core、logback-classic、logback-access和slf4j-api对应的jar包，验证是否可以将日志输出到指定目录。验证后发现，仍然无法解决问题，于是将引入的jar包删除。 第三步，排除springboot中包含的log4j2相关的jar，验证后仍无法解决问题。 第四步，在网上查到可能跟配置文件的命名有关，有说logback-spring.xml加载的优先级最高，于是将文件名由logback.xml改为logback-spring.xml，但是仍然无法解决问题。官网上看到的加载顺序是： logback-test.xml> logback.groovy> logback.xml。具体可见官方文档logback.qos.ch/manual/conf… 第五步，怀疑可能没加载logback.xml文件，于是在application.properties中加入logging.config=classpath:logback.xml，启动工程时报错，错误信息是： class path resource [logback.xml] cannot be resolved to URL because it does not exist。

根据错误信息可以看到，系统中根本没有加载到logback.xml文件。 第六步，由于第五步验证系统根本没有加载到logback.xml文件，于是检查了一下pom.xml文件，发现在build时，没有引入资源文件，于是修改pom.xml文件，添加如下内容，成功将日志输出到指定目录。

<resource>
  <directory>src/main/resources</directory>
  <includes>
    <include>**/*.xml</include>
  </includes>
  <filtering>false</filtering>
</resource>

以上就是Logback的使用及如何配置的详细内容，更多关于Logback的使用和配置的资料请关注我们其它相关文章！