其他分享
首页 > 其他分享> > TimeBasedRollingPolicy简介说明

TimeBasedRollingPolicy简介说明

作者:互联网

转自:

http://www.java265.com/JavaCourse/202201/2157.html

下文讲述TimeBasedRollingPolicy的简介说明,如下所示:

TimeBasedRollingPolicy是rollingPolicy中最常见的轮转策略
   它同时实现了RollingPolicy和TriggeringPolicy 接口

TimeBasedRollingPolicy的属性

1.fileNamePattern(必填)
   String类型,该属性定义了轮转时的属性名
   它的值应该由文件名加上一个%d的占位符
   %d应该包含java.text/SimpleDateFormat中规定的日期格式
   如果忽略掉这个日期格式,默认文yyyy-MM-dd
   轮转周期通过fileNamePattern推断出来的。可以指定多个 %d
   但是只能有一个是主要的,用于推断轮转周期
   其它的 %d 占位符必须通过 'aux' 标记为辅助的
   还可以通过 aFloder/test.%d{yyyy-MM-dd-HH, UTC}.log 来指定一个时区
    当指定的timezone不能被识别或者拼写错误,将会根据TimeZone.getTimeZone(String)方法指定为GMT

轮询实例
/wombat/foo.%d
每天轮转(晚上零点)。由于省略了指定 %d 的日期格式,所以默认为?yyyy-MM-dd
/wombat/%d{yyyy/MM}/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{yyyy-MM-dd_HH-mm, UTC}.log
每分钟轮转,时间格式为UTC
/foo/%d{yyyy-MM, aux}/%d.log
每天轮转

2.maxHistory
int类型 可选属性,用来控制最多保留多少数量的归档文件,将会异步删除旧的文件
当旧的归档文件被移除时,当初用来保存这些日志归档文件的文件夹也会在适当的时候被移除
如:你指定按月轮转,设置maxHistory = 3,那么3个月内的归档文件将会保留在文件夹内,大于3个月的将会被删除。

3.totalSizeCap
int类型,可选属性,用来控制所有归档文件总的大小
  当达到这个大小后,旧的归档文件将会被异步的删除
   使用这个属性时还需要设置 maxHistory 属性。而且,maxHistory 将会被作为第一条件,该属性作为第二条件。

4.cleanHistoryOnStart
boolean类型,当设置为 true
 则在 appender 启动的时候,归档文件将会被删除。默认的值为 false
归档文件的删除通常在轮转期间执行。但是,有些应用的存活时间可能等不到轮转触发
 对于这种短期应用,可以通过设置该属性为 true,在 appender 启动的时候执行删除操作。

<!-- 滚动文件的方式生成日志日志文件,文件的存储位置通过file标签指定 -->
<!-- 通过encoder指定日志的生成格式,每个appender的日志格式都可以自定义,不用相同 -->
<appender name="file" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>/logback/log/test.log</file>
	<encoder>
    	<pattern>【logbck】%blue([requestId:%X{requestId:-syslogId}]) %d{yyyy-MM-dd HH:mm:ss.SSS} %red([%thread]) %5level - %msg%n</pattern>
    </encoder>
    <!-- 
    通过rollingPolicy设置日志滚动的策略,这是使用按照时间滚动
    fileNamePattern属性设置滚动生成文件的格式,这里设置的精确到天,也就是按照天滚动,如果时间设置精确到秒,就按秒来滚动
    maxHistory属性设定最大的文件数,比如按天滚动,这里设置了30天,在第31天日志生成的时候,第一天的日志就会被删掉
    -->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
		<!--设置按天来滚动,前一天日志打印到23点59分,然后就一直没有请求日志,直到次日的1点才有新的日志进入。
                在0点到1点这个时间段,日志文件是不会滚动生成新的日志文件。因为滚动的动作是需要日志写入动作来触发。-->
    	<fileNamePattern>/logback/log/test-%d{yyyy-MM-dd}.log</fileNamePattern>
        <maxHistory>30</maxHistory>
    </rollingPolicy>
</appender>

标签:yyyy,轮转,log,MM,简介,dd,说明,归档文件,TimeBasedRollingPolicy
来源: https://www.cnblogs.com/java265/p/16527169.html