Springboot 集成logback 日志框架简介

**笔者声明 **该内容参考自logback官方网站 及一国外博客 ，其中关于日志写入远程服务器笔者没来得及亲自试，只是将官方文档进行了简单翻译，部分语法拿捏的并不准确。其中每部分都有指出官网的章节地址，建议看不懂的地方直接阅读官网。(未完待续。。。)

---

logback 基本配置

创建 logback.xml

Spting-Boot 默认集成的 logback 虽然打印些日志信息，但是不够友好。满足不了我们日常开发需求。因此，我们可以在g根目录下创建 logback.xml 或 logback-spring.xml 文件，进行自定义配置

In a Spring Boot application, you can specify a Logback XML configuration file as logback.xml or logback-spring.xml in the project classpath. The Spring Boot team however recommends using the -spring variant for your logging configuration, logback-spring.xml is preferred over logback.xml. If you use the standard logback.xml configuration, Spring Boot may not be able to completely control log initialization.

Here is the code of the logback-spring.xml file

Sping-Boot 默认集成的 logback 打印的日志样式个人觉得比较喜欢，而且默认打印的日志虽然不足以满足我们日常开发需要。但是我们可以直接在其基础上做些补充修改就能做到我们想要的日志输出，况且如果我们直接自定义日志输出的话想在控制台又想对不同的信息输出不同的颜色信息在进行定义的话也完全是脱裤子放弃多此一举不是？更何况默认Spring-Boot默认就做了这些开箱即用操作，所以我们直接引用进来即可！

笔者使用的 SpringBoot 开发版本为 2.0.2.REALEASE 版本，所以直接找到 spring-boot-2.0.2.REALEASE 依赖包。可以看到该依赖包下 org.springframework.boot 包级目录有许多默认配置依赖包类

当然，这里主要是看 logging 包，在该包中有个 logback 包，这里这里面放的就是默认 logback 日志配置文件。

其中主要有四个 xml 配置文件，我在可以就在我们创建的 logback-spring.xml 配置文件中引入 base.xml 配置文件。

<configuration>
	<include resource="org/springframework/boot/logging/logback/base.xml" />
</configuration>

现在我们重新启动项目就会发现打印的日志信息跟没创建自定义日志配置文件效果是一毛一样。就是因为 springboot 默认配置 logback 就是该配置文件。

现在在来看下 base.xml 配置文件中都是些什么东东。

<included>
	<include resource="org/springframework/boot/logging/logback/defaults.xml" />
	<property name="LOG_FILE" value="${LOG_FILE:-${LOG_PATH:-${LOG_TEMP:-${java.io.tmpdir:-/tmp}}}/spring.log}"/>
	<include resource="org/springframework/boot/logging/logback/console-appender.xml" />
	<include resource="org/springframework/boot/logging/logback/file-appender.xml" />
	<root level="INFO">
		<appender-ref ref="CONSOLE" />
		<appender-ref ref="FILE" />
	</root>
</included>

其中最惹人瞩目的就是三个 <include>

defaults.xml
console-appender.xml
file-appender.xml

所以，若是不直接引用 base.xml 配置文件，引用另外三个配置文件作用是相同的。建议单独引用文件，且只引用 defaults.xml 和 console-appender.xml 。因为多个app部署同一环境下可能会导致日志输出权限问题。

logback 基本属性

现在来看下自定义配置 logback 日志输出时需要准守的格式

基本示例(仅做参考)

<configuration debug="true">

	<include resource="org/springframework/boot/logging/logback/defaults.xml" />
	<include resource="org/springframework/boot/logging/logback/console-appender.xml" />

	<property name="APP_NAME" value="Logback"/>
	<property name="APP_HOME" value="/home/logback"/>
	<property name="LOG_HOME_PATH" value="${APP_HOME}/logs"/>
	<property name="DEBUG_LOG_FILE" value="${LOG_HOME_PATH}/debug/${APP_NAME}_debug" />

	<appender name="DEBUG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<encoder>
			<pattern>${FILE_LOG_PATTERN}</pattern>
		</encoder>

		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${DEBUG_LOG_FILE}.%d{yyyy-MM-dd}.log</FileNamePattern>
			<MaxHistory>60</MaxHistory>
		</rollingPolicy>

		<filter class="ch.qos.logback.classic.filter.LevelFilter">
			<level>DEBUG</level>
			<onMatch>ACCEPT</onMatch>
			<onMismatch>DENY</onMismatch>
		</filter>
	</appender>
	<root level="INFO">
		<appender-ref ref="DEBUG_FILE" />
	</root>

	<logger name="com.mingrn.logback" level="DEBUG">
		<appender-ref ref="DEBUG_FILE"/>
	</logger>

	<logger name="com.uhope.rl.logback.repository" level="DEBUG" />
</configuration>

configuration 标签

configuration属于全局配置标签，在配置 logback 日志时，所有的配置属性都必须包含在该配置标签中！ 该配置标签共有四个个节点属性

scan

默认情况下：配置文件将每分钟扫描一次更改，配置文件如果发生改变，将会被重新加载，默认值为true（官网说明）

<configuration scan="true"> 
  <!--do something-->
</configuration>

scanPeriod

配置文件扫描周期，当不设置单位时默认为毫秒级。可以配合 scan 使用，当开启 scan 时，通过是设置该值用于控制配置文件扫描周期，如每30秒扫描一次配置文件（官网说明）

<configuration scan="true" scanPeriod="30 seconds" > 
  <!--do something-->
</configuration>

### packagingData

在堆栈跟踪中是否启用打包数据，默认false。如设置 TRUE 时打印堆栈数据信息（官网说明）

<configuration packagingData="true">
  <!--do something-->
</configuration>

日志如下

14:28:48.835 [btpool0-7] INFO  c.q.l.demo.prime.PrimeAction - 99 is not a valid value
java.lang.Exception: 99 is invalid
  at ch.qos.logback.demo.prime.PrimeAction.execute(PrimeAction.java:28) [classes/:na]
  at org.apache.struts.action.RequestProcessor.processActionPerform(RequestProcessor.java:431) [struts-1.2.9.jar:1.2.9]
  at org.apache.struts.action.RequestProcessor.process(RequestProcessor.java:236) [struts-1.2.9.jar:1.2.9]
  at org.apache.struts.action.ActionServlet.doPost(ActionServlet.java:432) [struts-1.2.9.jar:1.2.9]
  at javax.servlet.http.HttpServlet.service(HttpServlet.java:820) [servlet-api-2.5-6.1.12.jar:6.1.12]
  at org.mortbay.jetty.servlet.ServletHolder.handle(ServletHolder.java:502) [jetty-6.1.12.jar:6.1.12]
  at ch.qos.logback.demo.UserServletFilter.doFilter(UserServletFilter.java:44) [classes/:na]
  at org.mortbay.jetty.servlet.ServletHandler$CachedChain.doFilter(ServletHandler.java:1115) [jetty-6.1.12.jar:6.1.12]
  at org.mortbay.jetty.servlet.ServletHandler.handle(ServletHandler.java:361) [jetty-6.1.12.jar:6.1.12]
  at org.mortbay.jetty.webapp.WebAppContext.handle(WebAppContext.java:417) [jetty-6.1.12.jar:6.1.12]
  at org.mortbay.jetty.handler.ContextHandlerCollection.handle(ContextHandlerCollection.java:230) [jetty-6.1.12.jar:6.1.12]

debug

实时查看logback运行状态，默认值为false。当该值设置为TRUE 时，将打印出logback内部日志信息，实时查看logback运行状态。（官网说明）

<configuration debug="true"> 
	<include resource="org/springframework/boot/logging/logback/base.xml" />
</configuration>

statusListener 标签

statusListener configuration 的子元素。是个状态监听器，通过注册状态监听器以便可以立即采取行动响应状态消息，尤其是在logback配置之后发生的消息。在没有人工干预的情况下，注册状态监听器是一种方便的方式来监视logback的内部状态（官网说明）

<configuration>
  <statusListener class="ch.qos.logback.core.status.OnConsoleStatusListener" />  

  <!--do something-->
</configuration>

logger 标签

<logger> configuration 的子元素。用来设置某个包或及具体的某个类的日志输出以及指定 <appender> , logger 只用一个 name 、 level 和一个可选的 addtivity 属性（官网说明）

name

name 属性用来指定 logger 约束的包或具体类。

<!--指定包-->
<logger name="com.mingrn.repository"/>
<!--指定类-->
<logger name="com.mingrn.repository.UserRepository"/>

level

level 属性设置日志打印级别。TRACE,、DEBUG、 INFO、 WARN、 ERROR、 ALL 和 OFF，还有一个特俗值 INHERITED 或者同义词 NULL，代表强制执行上级的级别。如果未设置此属性，那么当前 logger 将会继承上级的级别（root）

<!--指定包-->
<logger name="com.mingrn.repository" level="DEBUG"/>
<!--指定类-->
<logger name="com.mingrn.repository.UserRepository" level="DEBUG"/>

addtivity

addtivity 是否向上级loger传递打印信息，默认是true。及若这里设置 true

<logger name="com.mingrn.repository" level="DEBUG" additivity="true"/>

在输出日志时，你会发现控制台会输出两边，就是因为设置了该属性。所以一般指定 <logger> 指定包或具体类时该属性设置为 FALSE。

<logger name="com.mingrn.repository" level="DEBUG" additivity="true"/>
	
<root level="INFO">
    <appender-ref ref="CONSOLE" />
	<appender-ref ref="DEBUG_FILE" />
	<appender-ref ref="INFO_FILE" />
	<appender-ref ref="WARN_FILE" />
	<appender-ref ref="ERROR_FILE" />
	<appender-ref ref="RUN_FILE" />
</root>

root 标签

<root> configuration 的子元素。该标签其实就是 <logger> ，但他是根 <logger> 。该标签只有一个属性 level 即打印日志级别。若 <logger > 或 <appender> 标签为设置输出级别时就会默认继承该标签设置的级别！同时，若设置 <logger > 后并且 additivity 设置值为 true 时就会进行传递导致 logger 打印日志后 root 又打印一次日志！（官网说明）

appender-ref 标签

<appender-ref> root 或 logger 的子元素。标签属于 logger 和 root 内部引用标签。该标签只有一个属性 ref 用于指定 <appender> 标签的 name 值！就是说被指定的 appender 输出级别为 root 、 logger 指定的级别，若 appender 指定级别后只输出 appender 指定的级别日志。

<root level="INFO">
    <appender-ref ref="CONSOLE" />
	<appender-ref ref="DEBUG_FILE" />
	<appender-ref ref="INFO_FILE" />
	<appender-ref ref="WARN_FILE" />
	<appender-ref ref="ERROR_FILE" />
	<appender-ref ref="RUN_FILE" />
</root>

<logger name="com.uhope.rl.electornic" level="DEBUG">
	<appender-ref ref="DEBUG_FILE"/>
</logger>

ref

指定具体的 appender 。 ref 值为 <appender> 的 name 属性值

<logger name="com.uhope.rl.electornic" level="DEBUG">
	<appender-ref ref="DEBUG_FILE"/>
</logger>
<appender name="DEBUG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
	<!--do something-->
</appender>

contextName 标签

<contextName> ：configuration 的子元素。用于定义 looger 关联到的上下文，默认上下文名称为 default。但是可以通过该标签设置成其他名称，用于区分不同引用程序的记录，一旦设置，不能修改。

官网说明

<configuration>
  <contextName>myAppName</contextName>
  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%d %contextName [%t] %level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

  <root level="debug">
    <appender-ref ref="STDOUT" />
  </root>
</configuration>

property 标签

<configuration debug="true">
	<!--路径-->
	<property name="USER_HOME" value="/home/sebastien" />
	<!--日志输出规则-->
	<property name="FILE_LOG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} ${LOG_LEVEL_PATTERN:-%5p} ${PID:- } --- [%t] %-40.40logger{39} : %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}" />

	<appender name="FILE" class="ch.qos.logback.core.FileAppender">
		<file>${USER_HOME}/myApp.log</file>
		<encoder>
			<pattern>%msg%n</pattern>
		</encoder>
	</appender>

	<appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<encoder>
			<pattern>${FILE_LOG_PATTERN}</pattern>
		</encoder>
	</appender>
</configuration>

引用资源

<configuration>

  <property resource="resource.properties" />

  <appender name="FILE" class="ch.qos.logback.core.FileAppender">
     <file>${USER_HOME}/myApp.log</file>
     <encoder>
       <pattern>%msg%n</pattern>
     </encoder>
   </appender>

   <root level="debug">
     <appender-ref ref="FILE" />
   </root>
</configuration>

<configuration>

  <property file="src/main/java/chapters/configuration/variables.properties" />

  <appender name="FILE" class="ch.qos.logback.core.FileAppender">
     <file>${USER_HOME}/myApp.log</file>
     <encoder>
       <pattern>%msg%n</pattern>
     </encoder>
   </appender>

   <root level="debug">
     <appender-ref ref="FILE" />
   </root>
</configuration>

appender 标签

appender 组键说明

ConsoleAppender 主键

ConsoleAppender官网说明

ConsoleAppender 组件包类： ch.qos.logback.core.ConsoleAppender ConsoleAppender 主要作用是将日志输出到控制台，适用于 本地 。

有以下节点属性

<configuration>

  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <!-- encoders are assigned the type -->
    <!-- ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
    <encoder>
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg %n</pattern>
    </encoder>
  </appender>

  <root level="DEBUG">
    <appender-ref ref="STDOUT" />
  </root>
</configuration>

FileAppender 组键

FileAppender官网说明

FileAppender 组件包类 ch.qos.logback.core.FileAppender FileAppender 主要作用是将日志写入一个文件中。目标文件由文件选项指定。如果文件已经存在，它要么被追加，要么根据附加属性的值被截断，适用于 本地 。

有以下节点属性 | 属性名 | 类型 | 说明 | |:------|------:|:-----:| |file |String |被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值。| |append |boolean|如果设为true，日志将会在文件结尾处增加。如果为false就清空现有文件。默认为true| |encoder|String |编码| |prudent|boolean|将日志安全谨慎的写入到指定文件，即使有其他FileAppender也将日志写入此文件中。效率低下，该模式默认值为false。注意：当该值设为true时，append将默认为true| 说明 默认情况下，日志会立即写入到底层输出流。这种默认方式是安全的，因为如果应用程序没有正确关闭的情况下退出，name日志不会丢失。不过，为了显著的增加日志吞吐量应该将 <immediateFlush> 显示的设为false。

<configuration>

  <appender name="FILE" class="ch.qos.logback.core.FileAppender">
    <file>testFile.log</file>
    <append>true</append>
    <!-- 为了更高的日志吞吐量应将 immediateFlush 设为 false -->
    <immediateFlush>true</immediateFlush>
    <!-- encoders are assigned the type -->
    <!-- ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
    <encoder>
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>
    </encoder>
  </appender>
        
  <root level="DEBUG">
    <appender-ref ref="FILE" />
  </root>
</configuration>

RollingFileAppender 组键

RollingFileAppender官网说明

RollingFileAppender 组件包类 ch.qos.logback.core.rolling.RollingFileAppender RollingFileAppender 继承 FileAppender。当满足一定条件时，具有滚动写入文件的特性。说以这是最常用的写入文件权限定名，适用于 本地 。 该组件具有两个非常重要的组件 ： RollingPolicy 和 TriggeringPolicy

有以下节点属性 |属性名 |类型 |说明 | |:------|------:|:-----:| |file |String |被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值。| |append |boolean|如果设为true，日志将会在文件结尾处增加。如果为false就清空现有文件。默认为true| |encoder|String |编码| |prudent|boolean|将日志安全谨慎的写入到指定文件，即使有其他FileAppender也将日志写入此文件中。效率低下，该模式默认值为false。注意：当该值设为true时，append将默认为true| |rollingPolicy |RollingPolicy |滚动出发策略，当发生滚动时，决定 RollingFileAppender 的行为，涉及文件移动和重命名。 见下文 | |triggeringPolicy |TriggeringPolicy |告知 RollingFileAppender 合适激活滚动。 见下文 |

RollingFileAppender 组键之 RollingPolicy 翻转策略

RollingPolicy官网说明

RollingPolicy 滚动策略负责翻转过程中的文件路径与重命名或命名。

RollingPolicy 翻转策略之 TimeBasedRollingPolicy 翻转策略

TimeBasedRollingPolicy 包类 ch.qos.logback.core.rolling.TimeBasedRollingPolicy TimeBasedRollingPolicy 翻转策略可能是最最流行的翻转策略。它定义了基于时间的翻转策略，如日、月等！ TimeBasedRollingPolicy 有一个强制性的属性 <fileNamePattern> 和 几个非必须的属性。

有以下节点属性 |属性名 |类型 |说明| |:-----|---:|:--:| |fileNamePattern |String | 必须属性 ，它的值应该包括文件的名称，以及适当放置的%d转换说明符。%d转换说明符可以包含一个由 java.text.SimpleDateFormat 指定的日期和时间模式,如%d{yyyy-MM}。如果省略了日期和时间模式 如%d，则默认时间格式为 yyyy-MM-dd。翻转周期是从 fileNamePattern 值中推断出来的。| |maxHistory |int |日志数量最大保存时间，如设置的时间模式( fileNamePattern )为 yyyy-MM，maxHistory 设为 6。则意味日志文件最大保存6个月。注意，当旧的归档日志文件被删除时，为了日志文件存档而创建的任何文件夹都将被适当地删除。| |maxFileSize |int |每个文件最大保存大小，如 10M，100M | |totalSizeCap |int |控制日志文档存储的总大，如 3GB、100M| |cleanHistoryOnStart |boolean |通过将清理历史记录设置为true，在appender启动时执行存档删除操作。默认false| TimeBasedRollingPolicy fileNamePattern 值列举： |fileNamePattern |Rollover schedule |file | |:---------------|-----------------:|:------:| |/wombat/foo.%d |默认：yyyy-MM-dd 每天滚动|/wombat/foo.2018-6-1、 /wombat/foo.2018-6-2| |/wombat/%d{yyyy/MM}/foo.txt |每月滚动 |/wombat/2018/1/foo.txt 、/wombat/2018/2/foo.txt| |/wombat/foo.%d{yyyy-ww}.log |每周滚动 | | |/wombat/foo%d{yyyy-MM-dd_HH}.log |每时滚动 | | |/wombat/foo%d{yyyy-MM-dd_HH-mm}.log |每分滚动 | | |/wombat/foo.%d.gz |每日滚动，自动压缩为 GZIP格式 |/wombat/foo.2018-6-1.gz |

设置日志保存最大时间和最大容量 <file>logFile.log</file> 可以不设

<configuration>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  
    <file>logFile.log</file>
    
    <encoder>
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>
    </encoder>
    
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <!-- daily rollover -->
      <fileNamePattern>logFile.%d{yyyy-MM-dd}.log</fileNamePattern>

      <!-- keep 30 days' worth of history capped at 3GB total size -->
      <maxHistory>30</maxHistory>
      <totalSizeCap>3GB</totalSizeCap>

    </rollingPolicy>
  </appender> 

  <root level="DEBUG">
    <appender-ref ref="FILE" />
  </root>
  
</configuration>

允许多程序写入同一日志文件

<configuration>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <!-- Support multiple-JVM writing to the same log file -->
    <prudent>true</prudent>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>logFile.%d{yyyy-MM-dd}.log</fileNamePattern>
      <maxHistory>30</maxHistory> 
      <totalSizeCap>3GB</totalSizeCap>
    </rollingPolicy>

    <encoder>
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>
    </encoder>
  </appender> 

  <root level="DEBUG">
    <appender-ref ref="FILE" />
  </root>
</configuration>

设置每个文件保存最大大小

<configuration>
  <appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>mylog.txt</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
      <!-- rollover daily -->
      <fileNamePattern>mylog-%d{yyyy-MM-dd}.%i.txt</fileNamePattern>
       <!-- each file should be at most 100MB, keep 60 days worth of history, but at most 20GB -->
       <maxFileSize>100MB</maxFileSize>    
       <maxHistory>60</maxHistory>
       <totalSizeCap>20GB</totalSizeCap>
    </rollingPolicy>
    <encoder>
      <pattern>%msg%n</pattern>
    </encoder>
  </appender>

  <root level="DEBUG">
    <appender-ref ref="ROLLING" />
  </root>

</configuration>

RollingPolicy 翻转策略 之 FixedWindowRollingPolicy 翻转策略

FixedWindowRollingPolicy包类 ch.qos.logback.core.rolling.FixedWindowRollingPolicy FixedWindowRollingPolicy在滚动时，根据一个固定的窗口算法，FixedWindowRollingPolicy重命名文件 FixedWindowRollingPolicy有一个强制性的属性 <fileNamePattern> 和 几个非必须的属性。

有以下节点属性 |属性名 |类型 |说明| |:-----|---:|:--:| |fileNamePattern |String | 必须属性 ，这个选项表示在重命名日志文件时将遵循FixedWindowRollingPolicy的模式。它必须包含字符串%i，它将指示插入当前窗口索引值的位置。如 MyLogFile%i.log 用最小索引1和最大索引3将产生文件 MyLogFile1.log、MyLogFile2.log 和 MyLogFile3.log| |minIndex |int |最小索引 | |maxIndex |int |最大索引 |

TimeBasedRollingPolicy fileNamePattern 值列举 |Number of rollovers |Active output target |Archived log files |file | :-----|---:|:--:| |0 | foo.log| - | 没有翻转文件，日志将会记录初始文件| |1 | foo.log| foo1.log| 第一次翻转，文件foo.log 将会被命名为foo1.log，新文件 foo.log 将会被创建并成为活动输出目标。| |2 | foo.log| foo1.log、foo2.log| 第二次翻转，文件foo1.log 将会被命名为foo2.log，文件foo.log 将会被命名为foo1.log，新文件 foo.log 将会被创建并成为活动输出目标。| 同上 | |3 | foo.log| foo1.log、foo2.log、foo3.log| 同上 | |4 | foo.log| foo1.log、foo2.log、foo3.log、foo4.log| 同上 |

<configuration>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>test.log</file>

    <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
      <fileNamePattern>tests.%i.log.zip</fileNamePattern>
      <minIndex>1</minIndex>
      <maxIndex>3</maxIndex>
    </rollingPolicy>

    <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
      <maxFileSize>5MB</maxFileSize>
    </triggeringPolicy>
    <encoder>
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>
    </encoder>
  </appender>
        
  <root level="DEBUG">
    <appender-ref ref="FILE" />
  </root>
</configuration>

RollingFileAppender 组键之 triggeringPolicy 触发策略

triggeringPolicy官网说明

RollingPolicy 触发策略实现负责指导RollingFileAppender在何时翻转。

triggeringPolicy 触发策略之 SizeBasedTriggeringPolicy 触发策略

SizeBasedTriggeringPolicy触发策略官网说明

SizeBasedTriggeringPolicy 包类 ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy SizeBasedTriggeringPolicy 查看当前活动文件的大小，如果超过指定大小会告知 RollingFileAppender 触发当前活动文件滚动。 SizeBasedTriggeringPolicy 触发策略只接受一个属性 maxFileSize ，默认值为10 MB。 maxFileSize 选项可以用字节、千字节、兆字节或千兆字节来指定，方法是用KB、MB和GB分别设置数值。例如，5000000，5000 KB，5 MB和2 GB都是有效值，前三个是等价的。

<configuration>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>test.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
      <fileNamePattern>test.%i.log.zip</fileNamePattern>
      <minIndex>1</minIndex>
      <maxIndex>3</maxIndex>
    </rollingPolicy>

    <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
      <maxFileSize>5MB</maxFileSize>
    </triggeringPolicy>
    <encoder>
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>
    </encoder>
  </appender>
        
  <root level="DEBUG">
    <appender-ref ref="FILE" />
  </root>
</configuration>

SocketAppender and SSLSocketAppender 组键

ServerSocketReceiver
SimpleSocketServer

SocketAppender 组件之 SimpleSocketServer

SimpleSocketServer 官网说明

SimpleSocketServer应用程序接受两个命令行参数： port 和 configFile 端口是要监听的端口， configFile 是 XML 格式的配置脚本。

<configuration>
          
  <appender name="SOCKET" class="ch.qos.logback.classic.net.SocketAppender">
    <remoteHost>${host}</remoteHost>
    <port>${port}</port>
    <reconnectionDelay>10000</reconnectionDelay>
    <includeCallerData>${includeCallerData}</includeCallerData>
  </appender>

  <root level="DEBUG">
    <appender-ref ref="SOCKET" />
  </root>  

</configuration>

SSLSocketAppender 组件之 SimpleSSLSocketServer

SimpleSSLSocketServer官网说明

SimpleSSLSocketServer要求SimpleSocketServer使用的端口和configFile命令行参数相同。另外，您必须使用命令行中指定的系统属性来提供日志服务器的x.509证书的位置和密码。

服务器配置有debug="true"，在根元素上指定，可以在在服务器的启动日志中看到将要使用的SSL配置。这有助于验证本地安全策略是否得到了正确的实施！

<configuration debug="true">
          
  <appender name="SOCKET" class="ch.qos.logback.classic.net.SSLSocketAppender">
    <remoteHost>${host}</remoteHost>
    <port>${port}</port>
    <reconnectionDelay>10000</reconnectionDelay>
    <ssl>
      <trustStore>
        <location>${truststore}</location>
        <password>${password}</password>
      </trustStore>
    </ssl>
  </appender>

  <root level="DEBUG">
    <appender-ref ref="SOCKET" />
  </root>  

</configuration>

ServerSocketAppender and SSLServerSocketAppender 组件

ServerSocketAppender and SSLServerSocketAppender官网说明

ServerSocketAppender 包类 ch.qos.logback.classic.net.server.ServerSocketAppender SSLServerSocketAppender 包类 ch.qos.logback.classic.net.server.SSLServerSocketAppender

ServerSocketAppender组件 示例

<configuration debug="true">
  <appender name="SERVER" class="ch.qos.logback.classic.net.server.ServerSocketAppender">
    <port>${port}</port>
    <includeCallerData>${includeCallerData}</includeCallerData>
  </appender>

  <root level="debug">
    <appender-ref ref="SERVER" />
  </root>  

</configuration>

注意：在没有remoteHost属性的情况下——这个appender被动地等待来自远程主机的入站连接，而不是打开到远程日志服务器的连接。

SSLServerSocketAppender 组件示例

<configuration debug="true">
  <appender name="SERVER" class="ch.qos.logback.classic.net.server.SSLServerSocketAppender">
    <port>${port}</port>
    <includeCallerData>${includeCallerData}</includeCallerData>
    <ssl>
      <keyStore>
        <location>${keystore}</location>
        <password>${password}</password>
      </keyStore>
    </ssl>
  </appender>

  <root level="debug">
    <appender-ref ref="SERVER" />
  </root>  

</configuration>