Log4j2的DefaultRolloverStrategy详解

[Q&A] 什么是 DefaultRolloverStrategy？

当触发器（例如SizeBasedTriggeringPolicy或TimeBasedTriggeringPolicy）决定需要进行日志文件滚动时，DefaultRolloverStrategy将负责处理滚动过程中的具体行为。

<RollingFile name="api_json"
             fileName="${LOG_HOME}/${FILE_NAME}.log"
             filePattern="${LOG_HOME}/${FILE_NAME}_%d{yyyy-MM-dd-HH}_%i.log.gz"
             createOnDemand="true">
    <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
    <PatternLayout pattern="${LOG_PATTERN}"/>
    <Policies>
        <SizeBasedTriggeringPolicy size="100K"/>
    </Policies>

    <DefaultRolloverStrategy fileIndex="nomax">
        <Delete basePath="${LOG_HOME}" maxDepth="2">
            <IfFileName glob="*.log.gz">
                <IfAny>
                    <IfAccumulatedFileSize exceeds="100M"/>
                    <IfAccumulatedFileCount exceeds="100"/>
                    <IfLastModified age="30d"/>
                </IfAny>
            </IfFileName>
        </Delete>
    </DefaultRolloverStrategy>
</RollingFile>

DefaultRolloverStrategy节点

参数	Type	Description
fileIndex	String	可选值 max, min,nomax
min	integer	The minimum value of the counter. The default value is 1.
max	integer	The maximum value of the counter. The default value is 7. 一旦达到这个值，旧的存档将在随后的滚动中被删除。
compressionLevel	integer	设置压缩级别，0-9，其中0 =无，1 =最佳速度，到9 =最佳压缩。仅对ZIP文件实现。
tempCompressedFilePattern	String	归档日志文件在压缩过程中的文件名模式。

<DefaultRolloverStrategy fileIndex="max" max="3" min="1">：
只保留3个日志文件，当到归档第4个文件时，
foo-1.log 被删除，
foo-2.log 被重命名为 foo-1.log，
foo-3.log 被重命名为 foo-2.log，
foo.log   被重命名为 foo-3.log。
创建新的   foo.log文件并继续写入。

<DefaultRolloverStrategy fileIndex="min" max="3" min="1">：
只保留3个日志文件，当到归档第4个文件时，
foo-3.log 被删除，
foo-2.log 重命名为foo-3.log，
foo-1.log 重命名为foo-2.log，
foo.log   重命名为foo -1.log。
创建新的   foo.log文件并继续写入。

Delete节点

参数	Type	Description
basePath	String	Required. Base path from where to start scanning for files to delete.
maxDepth	int	1、The maximum number of levels of directories to visit. 1.1、0 Log4j2只会检查${LOG_HOME}直接指向的目录下的.log.gz格式文件是否符合删除条件, 1.2、Integer.MAX_VALUE indicates that all levels should be visited. 1.3、The default is 1，Log4j2不仅会检查${LOG_HOME}指向的目录下的.log.gz格式文件是否符合删除条件，还会检查该目录下一层的所有子目录中的相同格式文件。
pathConditions	PathCondition[]	PathCondition也可以嵌套。如果进行嵌套，则是先判断外层的PathCondition，然后进行内层的判断。如果没有嵌套，则是按顺序进行判断。 也可以创建自定义条件或使用内置条件： IfFileName 如果文件名与此参数匹配则结果为true，此参数为正则表达式或 glob的文件。 IfLastModified 最后修改时间早于或等于此参数则结果为true，此参数为duration。 IfAccumulatedFileCount 文件数超过指定个数则结果为true，此参数为整型。 IfAccumulatedFileSize 所有文件总大小达到此参数则结果为true，此参数为KB、MB、GB。 IfAll 如果此标签下的所有条件都配置成功（逻辑与），则结果为true。 IfAny 如果此标签下的任何一个条件匹配成功（逻辑或），则结果为true。 IfNot 如果此标签下的所有条件都不匹配（逻辑非），则结果为true。

<DefaultRolloverStrategy fileIndex = "nomax">
    <Delete basePath="${LOG_HOME}" maxDepth="2">
        <IfFileName glob="*.log.gz">
            <IfLastModified age="7d">
                <IfAny>
                    <IfAccumulatedFileSize exceeds="100M"/>
                    <IfAccumulatedFileCount exceeds="100"/>
                </IfAny>
            </IfLastModified>
        </IfFileName>
    </Delete>
</DefaultRolloverStrategy>

<DefaultRolloverStrategy fileIndex = "nomax">
    <Delete basePath="${LOG_HOME}" maxDepth="2">
        <IfFileName glob="*.log.gz">
            <IfAny>
                <IfAccumulatedFileSize exceeds="100M"/>
                <IfAccumulatedFileCount exceeds="100"/>
                <IfLastModified age="30d"/>
            </IfAny>
        </IfFileName>
    </Delete>
</DefaultRolloverStrategy>