Log4j2 Config

by

Log4j 2

配置

可以自动加载配置，配置文件包括四种格式：properties,yml,json,xml，配置文件优先级依次为 log4j2.configurationFile > log4j2-test.properties > log4j2-test.yaml或log4j2-test.yml > log4j2-test.json或log4j2-test.jsn > log4j2-test.xml > log4j2.properties > log4j2.yaml或log4j2.yml > log4j2.json或log4j2.jsn > log4j2.xml > DefaultConfiguration，配置文件需要放在classpath路径下

配置文件示例

在实际项目中用过properties和xml格式，yml和json没用过

log4j2.properties

# 名称
name=PropertiesConfig
# 全局日志级别
status=INFO
# 过滤器
# 过滤器类型
filter.threshold.type = ThresholdFilter
# 过滤级别
filter.threshold.level = debug
# console
# 指定输出源的类型与名称
appender.console.type=Console
appender.console.name=Console
appender.console.layout.type=PatternLayout
# 输出模板
appender.console.layout.pattern=%d%p[%c]-%m%n
# rolling file
appender.rolling.type=RollingFile
appender.rolling.name=RollingFile
appender.rolling.fileName=logs/properties.log
# 指定当发生Rolling时，文件的转移和重命名规则
appender.rolling.filePattern=logs/properties.%d{YYYYMMdd}.log
appender.rolling.layout.type=PatternLayout
appender.rolling.layout.pattern=%d%p[%c]-%m%n
# 指定记录文件的封存策略，该策略主要是完成周期性的日志文件封存工作
appender.rolling.policies.type=Policies
# 基于时间的触发策略
appender.rolling.policies.time.type=TimeBasedTriggeringPolicy
# 当前记录周期为每天生成一个文件
appender.rolling.policies.time.interval=1
# 设置是否按小时来计算封存周期，否则以文件名格式
appender.rolling.policies.time.modulate = false
# 含有包含关系的类包，被子包的需要放在父包前面
loggers=org.hibernate.util.JDBCExceptionReporter,org.hibernate
 
logger.org.hibernate.util.JDBCExceptionReporter.name=org.hibernate.util.JDBCExceptionReporter
logger.org.hibernate.util.JDBCExceptionReporter.level=OFF
logger.org.hibernate.util.JDBCExceptionReporter.appenderRef.stdout.ref=Console
logger.org.hibernate.util.JDBCExceptionReporter.appenderRef.rolling.ref=RollingFile
logger.org.hibernate.util.JDBCExceptionReporter.additivity=false
 
logger.org.hibernate.name=org.hibernate
logger.org.hibernate.level=FATAL
logger.org.hibernate.appenderRef.stdout.ref=Console
logger.org.hibernate.appenderRef.rolling.ref=RollingFile
logger.org.hibernate.additivity=false
# rootLogger, 根记录器，所有记录器的父辈
# 指定根日志的级别
rootLogger.level=info
# 指定输出的appender引用
rootLogger.appenderRef.stdout.ref=Console
rootLogger.appenderRef.rolling.ref=RollingFile

log4j2.yml

Configuration:
  status: warn
  name: YAMLConfigTest
  properties:
    property:
      name: filename
      value: target/test-yaml.log
  thresholdFilter:
    level: debug
  appenders:
    Console:
      name: STDOUT
      target: SYSTEM_OUT
      PatternLayout:
        Pattern: "%m%n"
    File:
      name: File
      fileName: ${filename}
      PatternLayout:
        Pattern: "%d %p %C{1.} [%t] %m%n"
      Filters:
        ThresholdFilter:
          level: error
  Loggers:
    logger:
      -
        name: org.apache.logging.log4j.test1
        level: debug
        additivity: false
        ThreadContextMapFilter:
          KeyValuePair:
            key: test
            value: 123
        AppenderRef:
          ref: STDOUT
      -
        name: org.apache.logging.log4j.test2
        level: debug
        additivity: false
        AppenderRef:
          ref: File
    Root:
      level: error
      AppenderRef:
        ref: STDOUT

log4j2.json

{ "configuration": { "status": "debug", "name": "RoutingTest",
                      "packages": "org.apache.logging.log4j.test",
      "properties": {
        "property": { "name": "filename",
                      "value" : "target/rolling1/rollingtest-$${sd:type}.log" }
      },
    "ThresholdFilter": { "level": "debug" },
    "appenders": {
      "appender": [
         { "type": "Console", "name": "STDOUT", "PatternLayout": { "pattern": "%m%n" }, "ThresholdFilter": { "level": "debug" }},
         { "type": "Routing",  "name": "Routing",
          "Routes": { "pattern": "$${sd:type}",
            "Route": [
              {
                "RollingFile": {
                  "name": "Rolling-${sd:type}", "fileName": "${filename}",
                  "filePattern": "target/rolling1/test1-${sd:type}.%i.log.gz",
                  "PatternLayout": {"pattern": "%d %p %c{1.} [%t] %m%n"},
                  "SizeBasedTriggeringPolicy": { "size": "500" }
                }
              },
              { "AppenderRef": "STDOUT", "key": "Audit"}
            ]
          }
        }
      ]
    },
    "loggers": {
      "logger": [
        { "name": "EventLogger", "level": "info", "additivity": "false",
          "AppenderRef": { "ref": "Routing" }},
        { "name": "com.foo.bar", "level": "error", "additivity": "false",
          "AppenderRef": { "ref": "STDOUT" }}
      ],
      "root": { "level": "error", "AppenderRef": { "ref": "STDOUT" }}
    }
  }
}

log4j2.xml

<?xml version="1.0" encoding="UTF-8"?>
<!--日志级别以及优先级排序: OFF > FATAL > ERROR > WARN > INFO > DEBUG > TRACE > ALL -->
<!--Configuration后面的status，这个用于设置log4j2自身内部的信息输出，可以不设置，当设置成trace时，你会看到log4j2内部各种详细输出-->
<!--monitorInterval：Log4j能够自动检测修改配置 文件和重新配置本身，设置间隔秒数-->
<configuration status="WARN" monitorInterval="30">
  <!--先定义所有的appender-->
  <appenders>
    <!--这个输出控制台的配置-->
    <console name="Console" target="SYSTEM_OUT">
      <!--输出日志的格式-->
      <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n" />
    </console>
    <!--文件会打印出所有信息，这个log每次运行程序会自动清空，由append属性决定，这个也挺有用的，适合临时测试用-->
    <File name="log" fileName="log/test.log" append="false">
      <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n" />
    </File>
    <!-- 这个会打印出所有的info及以下级别的信息，每次大小超过size，则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩，作为存档-->
    <RollingFile name="RollingFileInfo" fileName="${sys:user.home}/logs/info.log" filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/info-%d{yyyy-MM-dd}-%i.log">
      <!--控制台只输出level及以上级别的信息（onMatch），其他的直接拒绝（onMismatch）-->
      <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY" />
      <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n" />
      <Policies>
        <TimeBasedTriggeringPolicy />
        <SizeBasedTriggeringPolicy size="100 MB" />
      </Policies>
    </RollingFile>
    <RollingFile name="RollingFileWarn" fileName="${sys:user.home}/logs/warn.log" filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/warn-%d{yyyy-MM-dd}-%i.log">
      <ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY" />
      <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n" />
      <Policies>
        <TimeBasedTriggeringPolicy />
        <SizeBasedTriggeringPolicy size="100 MB" />
      </Policies>
      <!-- DefaultRolloverStrategy属性如不设置，则默认为最多同一文件夹下7个文件，这里设置了20 -->
      <DefaultRolloverStrategy max="20" />
    </RollingFile>
    <RollingFile name="RollingFileError" fileName="${sys:user.home}/logs/error.log" filePattern="${sys:user.home}/logs/$${date:yyyy-MM}/error-%d{yyyy-MM-dd}-%i.log">
      <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY" />
      <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n" />
      <Policies>
        <TimeBasedTriggeringPolicy />
        <SizeBasedTriggeringPolicy size="100 MB" />
      </Policies>
    </RollingFile>
  </appenders>
  <!--然后定义logger，只有定义了logger并引入的appender，appender才会生效-->
  <loggers>
    <!--过滤掉spring和mybatis的一些无用的DEBUG信息-->
    <logger name="org.springframework" level="INFO"></logger>
    <logger name="org.mybatis" level="INFO"></logger>
    <root level="all">
      <appender-ref ref="Console" />
      <appender-ref ref="RollingFileInfo" />
      <appender-ref ref="RollingFileWarn" />
      <appender-ref ref="RollingFileError" />
    </root>
  </loggers>
</configuration>

配置参数

appender组件列表

append描述
AsyncAppender用于接受其他类型appender的引用，并使用单独线程异步写入log
CassandraAppender将日志写入Cassandra数据库中，需要提前建立keyspace和table
ConsoleAppender其日志写入System.out或System.err，默认为System.out
FailoverAppender故障转移appender，可以指定主appender，并且包含一组appender集合，当主appender写入失败，则会依次使用其他append写入，直至写入成功或者全部appender写入失败
FileAppender将日志写入文件，使用FileManager执行io
FlumeAppender将日志序列化后发送给Flume代理。 可选组件，由单独的jar提供。
JDBCAppender使用标准JDBC将日志写入关系数据库表，必须使用连接池
JMS Appender将日志发送至JMS中
JPAAppender通过JPA将日志写入关系型数据库表，需要有单独的persistence.xml配置文件
HttpAppender通过http请求发送日志，使用HttpURLConnection实现，响应2XX状态码为成功，否则抛出异常
KafkaAppender将日志事件发送到Kafka的topic中
MemoryMappedFileAppender2.1新增功能，将指定日志文件的一部分映射至内存，并将新日志事件写入此内存，达到阈值时将此内存刷新至存储设备
NoSQLAppender使用内部轻量级Provider接口将日志事件写入NoSQL数据库。目前只有MongoDB和Apache CouchDB的Provider实现
NoSQLAppender for MongoDB2.0.11开始，提供两个MongoDB模块：log4j-mongodb2、log4j-mongodb3
NoSQLAppender for MongoDB 2使用MongoDB驱动程序版本2将日志写入MongoDB中
NoSQLAppender for MongoDB 3使用MongoDB驱动程序版本3将日志写入MongoDB中
NoSQLAppender for Apache CouchDB使用内部轻量级Provider将日志写入CouchDB中
OutputStreamAppenderOutputStreamAppender不能直接配置，只是作为基础组件提供给其他Appender使用，如可以将日志事件写入输出流的File和Socket
RandomAccessFileAppender与FileAppender相比，使用的I/O实现类不同，FileAppender使用FileOutputStream，RandomAccessFileAppender 使用RandomAccessFile。bufferedIO=true(默认是true)时，性能提高20-200％ 。
RewriteAppender用于在日志被其他Appender写入文件之前，通过RewritePolicy修改日志事件
RollingFileAppender将日志写入文件，并根据TriggeringPolicy和RolloverPolicy规则将文件归档、清理
RollingRandomAccessFileAppender与RollingFileAppender相比，使用的I/O实现类不同，RollingFileAppender使用FileOutputStream，RollingRandomAccessFileAppender使用RandomAccessFile。bufferedIO=true(默认是true)时，性能提高20-200％ 。
RoutingAppender配置不同的规则，将日志路由到不同的Appender进行输出
SMTPAppender发生指定日志事件时，发送电子邮件
ScriptAppenderSelector根据Script脚本的执行结果来选择AppenderSet中配置的Appender，并将结果输出至ScriptAppenderSelector的name中
SocketAppender通过tcp或者udp，将日志写入远程目标中
SyslogAppenderSyslogAppender是一个SocketAppender，它将其输出以符合BSD Syslog或RFC 5424格式的日志写入到远程目标
ZeroMQ/JeroMQ AppenderZeroMQ Appender使用JeroMQ库将日志事件发送到一个或多个ZeroMQ端点

ConsoleAppender

ConsoleAppender比较简单，就是把日志写入System.out或者System.err中，基本配置如下：

Console一般使用基本配置就可以，唯一要注意的就是输出格式pattern，pattern的配置释义如下：

参数描述
%c或%logger输出logName，如 Logger log = LoggerFactory.getLogger(“com.test.logName”); 则输出为“com.test.logName” ，如果格式为%c{参数}，则输出内容参考官网：image
%C或%class输出为所在类的全路径名
d{pattern}或date输出时间，其中pattern可以是保留字，也可以是SimpleDateFormat中的字符。如 %d{DEFAULT} –> 2012-11-02 14:34:02,781 %d{DEFAULT_MICROS} –> 2012-11-02 14:34:02,123456 %d{yyyy-MM-dd HH:mm:ss.SSS} –> 2020-03-31 23:25:13.321 详见log4j PatternLayout
%F或%file输出所在类名.java，如所在类为com.test.LogTest，则输出为LogTest.java
%l输出错误的完整位置，全路径类名.方法名(类名.java:行号)，如，com.test.LogTest.testLog(LogTest.java:31)
%L输出行号
%m或%msg或%message输出log.error(text)中的text内容
%M或%method输出方法名
%n换行符
%t或%thread输出线程名
%u{“RANDOM”| “TIME”}或uuid输出uuid
%sn或%sequenceNumber输出自增序列
%r或%relative输出从JVM启动到当前时刻的毫秒数
%T或%tid或%threadId输出线程id
%t或%tn或%thread或%threadName输出线程id
%tp或%threadPriority输出线程优先级

RollingFileAppender

RollingFileAppender是一个OutputStreamAppender，可以根据TriggeringPolicy和RolloverPolicy将文件切割归档，通过RollingFileManager（扩展了OutputStreamManager）来实际执行文件I / O并执行归档。参数如下：

参数类型描述
appendboolean默认为true。如果为true，记录将附加到文件末尾。设置为false时，将在写入新记录之前清除文件
bufferedIOboolean默认为true。如果为true，数据先写入缓冲区，如果缓冲区满或者immediateFlush 为true时，数据才被写入磁盘，如果为false直接写入磁盘。文件锁定不能与bufferedIO一起使用
bufferSizeint缓冲区大小。bufferedIO为true时，此参数有效，默认为8192 bytes
createOnDemandboolean默认为false。按需创建文件。仅当日志事件通过所有Filter并且路由到该append时，append才创建文件
filterFilter确定事件是否应由此Appender处理，通过CompositeFilter（对应标签为）可以使用多个过滤器
fileNameString要写入的文件名，如果不存在或者父目录不存在，则创建对应的文件或目录
filePatternString归档文件的模式，取决于所使用的RolloverPolicy
immediateFlushboolean默认为true。如果为true，每次写操作后都会将数据刷新入磁盘，可能会影响性能。 每次写入后刷新仅在使用同步appender时才有用。即使设置为false，异步appender也将在一批事件结束后自动刷新，这也可以确保效率更高的将数据写入磁盘。
layoutLayout格式化日志输出格式。如果未设置，则默认为’%m%n’
nameStringappend名称
policyTriggeringPolicy用于确定归档的触发条件
strategyRolloverStrategy用于确定归档的文件名称、路径及归档方式
ignoreExceptionsboolean默认为true。设置为true时，如果记录日志发生异常，此条日志和异常将被忽略。设置为false时，异常将被抛出到调用方。如果此append用在FailoverAppender中，则必须设置为false。
filePermissionsString创建文件时指定文件的rwx权限，前提是文件系统应支持POSIX文件属性视图
fileOwnerString文件所有者。出于安全原因，更改文件的所有者可能受到限制，并且不允许操作时会抛出IOException。 如果_POSIX_CHOWN_RESTRICTED对路径有效，则只有有效用户ID等于文件用户ID或具有适当特权的进程才可以更改文件的所有权，前提是文件系统应支持文件所有者属性视图
fileGroupString文件组。，前提是文件系统应支持POSIX文件属性视图

TriggeringPolicy

TriggeringPolicy是控制日志文件归档的触发条件。总共有四种类型的TriggeringPolicy，可以组合（CompositeTriggeringPolicy）多种触发策略来控制归档，标签为，如果配置了多种策略，则只要有一种策略返回true，就返回true。

<Policies> <!-- <CronTriggeringPolicy schedule="0 0 * * * ?"/> --> <OnStartupTriggeringPolicy minSize="2" /> <SizeBasedTriggeringPolicy size="20 MB" /> <TimeBasedTriggeringPolicy /></Policies>

四种类型如下：

  • OnStartupTriggeringPolicy
    如果日志文件的时间比JVM的启动时间早，或者达到minSize的值，则会触发归档。
    minSize：触发文件归档的最小值，默认为1。
  • SizeBasedTriggeringPolicy
    当文件达到指定大小后，触发归档。大小可以通过size指定，单位为KB、MB、GB。与TimeBasedTriggeringPolicy配合使用时，filePattern中必须包含%i，否则文件每次归档时都会覆盖当前文件，因为TimeBasedTriggeringPolicy不会让文件名中的时间戳改变。如果不使用TimeBasedTriggeringPolicy，则SizeBasedTriggeringPolicy会让时间戳改变。
  • TimeBasedTriggeringPolicy
    当前时间与当前日志文件时间不匹配时，TimeBasedTriggeringPolicy会触发归档。参数如下：
参数描述
interval基于filePattern中配置的最小时间单位进行来控制归档频率，默认值为1。如：filePattern中最小时间单位为小时，如果interval=1，则1小时归档一次；如果interval=2，则2小时归档一次。
modulate默认为false。指明是否对interval进行调节，若modulate为true，会以0为开始对interval进行偏移计算。例如，最小时间粒度为小时，当前为3:00，interval为4，则后面归档时间依次为4:00，8:00，12:00，16:00
maxRandomDelay指示随机延迟过渡的最大秒数。默认情况下，该值为0，表示没有延迟。此设置在配置了多个应用程序以同时滚动日志文件的服务器上很有用，并且可以在整个时间上分散这样做的负担。
  • CronTriggeringPolicy
    基于cron表达式触发归档。此策略由计时器控制，并且与处理日志事件异步，因此上一个或下一个时间段的日志事件可能会出现在当前日志文件的开头或结尾。filePattern属性应包含一个时间戳，否则目标文件将在每次归档时被覆盖。参数如下：
参数描述
schedulecron表达式，该表达式与Quartz调度程序中允许的表达式相同。详见CronExpression
EvaluationOnStartup启动时，将根据文件的最后修改时间戳评估cron表达式。如果cron表达式指示应该在该时间和当前时间之间归档，则文件将立即被归档。

RolloverPolicy

用来控制文件归档方式，目前有两种类型：DefaultRolloverStrategy和DirectWriteRolloverStrategy

DefaultRolloverStrategy

通过接收filePattern属性中日期/时间模式（%d）和整数（%i）来控制归档方式。如果存在日期/时间模式，则将在归档时使用当前时间替换filePattern中配置的日期/时间部分，如果模式包含整数，则它将在每次归档时递增。如果归档时在模式中同时包含日期/时间和整数，则整数将递增，直到日期/时间部分也将被替换。如果文件模式以“ .gz”，“.zip”，“.bz2”，“.deflate”，“.pack200”或“ .xz”结尾，则将使用与后缀匹配的压缩方案来压缩文件。 bzip2, Deflate, Pack200 and XZ格式要求有Apache Commons Compress组件，另外xz格式还要求有XZ for Java组件。

DefaultRolloverStrategy参数如下：

参数描述
fileIndex默认值为max。可选值为：min、max，2.8之后新增nomax。文件归档及新文件创建规则后面介绍。
min计数器的最小值。预设值为1。
max计数器的最大值。一旦达到此值，较旧的归档文件将在以后的转换中被删除。预设值为7。
compressionLevel将压缩级别设置为0-9，其中0 =无，1 =最佳速度，直到9 =最佳压缩。仅针对ZIP文件实现
tempCompressedFilePattern压缩期间归档日志文件的文件名的模式。

fileIndex设值不同，则文件归档及新文件创建及计数器递增方法都不同，计数器递增有三种方式，如下：

  • 方式一：fileIndex值为max
    假设将DefaultRolloverStrategy的min属性设置为1，将max属性设置为3，fileName是“ foo.log”，filePattern是“ foo-％i.log”,归档规则如下：
归档数当前日志文件归档文件描述
0foo.log–所有日志记录都将转到初始文件
1foo.logfoo-1.log第一次归档，foo.log重命名为foo-1.log。创建新的foo.log文件并继续写入
2foo.logfoo-2.log，foo-1.log第二次归档，foo.log重命名为foo-2.log。创建新的foo.log文件并继续写入
3foo.logfoo-3.log，foo-2.log，foo-1.log第三次归档，foo.log重命名为foo-3.log。创建新的foo.log文件并继续写入
4foo.logfoo-3.log，foo-2.log，foo-1.log第四次和随后的归档，foo-1.log被删除，foo-2.log被重命名为foo-1.log，foo-3.log被重命名为foo-2.log，foo.log被重命名为foo-3.log。创建新的foo.log文件并继续写入。
  • 方式二：fileIndex值为min

假设将DefaultRolloverStrategy的min属性设置为1，将max属性设置为3，fileName是“ foo.log”，filePattern是“ foo-％i.log”,归档规则如下：

归档数当前日志文件归档文件描述
0foo.log–所有日志记录都将转到初始文件
1foo.logfoo-1.log第一次归档，foo.log重命名为foo-1.log。创建新的foo.log文件并继续写入
2foo.logfoo-1.log，foo-2.log第二次归档，将foo-1.log重命名为foo-2.log，并将foo.log重命名为foo-1.log。创建新的foo.log文件并继续写入
3foo.logfoo-1.log，foo-2.log，foo-3.log第三次归档，将foo-2.log重命名为foo-3.log，将foo-1.log重命名为foo-2.log，将foo.log重命名为foo-1.log。创建新的foo.log文件并继续写入
4foo.logfoo-1.log，foo-2.log，foo-3.log第四次和随后的归档，删除foo-3.log，将foo-2.log重命名为foo-3.log，将foo-1.log重命名为foo-2.log，将foo.log重命名为foo -1.log。创建新的foo.log文件并继续写入。
  • 方式三：fileIndex值为nomax
    nomax为2.8新增属性，设置为nomax时，将忽略DefaultRolloverStrategy的最大值和最小值，每次归档生成的新文件相对于前一个文件编号加1，没有最大文件数限制。
DirectWriteRolloverStrategy

将日志事件直接写入由filePattern表示的文件。使用此策略文件不会执行重命名。如果是基于大小的触发策略，将在指定的时间段内写入多个文件，它们从1开始编号，并不断递增直到发生基于时间归档。

注意：如果filePattern的后缀表示应该进行压缩，则在关闭应用程序时不会压缩当前文件。此外，如果时间更改使得filePattern不再与当前文件匹配，则启动时也不会对其进行压缩。

DirectWriteRolloverStrategy模式参数如下：

参数描述
maxFiles与文件格式匹配的时间段内允许的最大文件数。如果超出文件数量，则最早的文件将被删除。如果指定，则该值必须大于1。如果该值小于零或省略，则文件数量将不受限制。
compressionLevel将压缩级别设置为0-9，其中0 =无，1 =最佳速度，直到9 =最佳压缩。仅针对ZIP文件实现。
tempCompressedFilePattern压缩期间归档日志文件的文件名的模式。
归档保留策略

DefaultRolloverStrategy模式下，Log4j-2.5引入了Delete（删除）操作（标签为），与 max属性所提供的功能相比，Log4j-2.5使用户可以更好地控制在归档时删除哪些文件。删除操作使用户可以配置一个或多个条件，以选择要相对于基本目录删除的文件。

注意：可以删除任何文件，而不仅仅是删除日志文件，因此请谨慎使用此操作！使用testMode参数，可以测试配置，而不会意外删除错误的文件。

delete参数如下：

参数描述
basePath必需。从此处开始扫描要删除的文件的基本路径。
maxDepth要访问的目录的最大级别数。值为0表示仅访问起始文件，除非安全管理器拒绝。Integer.MAX_VALUE的值指示应访问所有级别。默认值为1，表示仅指定基本路径中的文件。
followLinks是否遵循符号链接。默认为false。
testMode如果为true，则不会删除文件，而是在INFO级别打印一条消息到状态记录器。使用此功能可以测试配置是否按预期工作。默认为false。
pathSorter一个实现PathSorter 接口的插件， 用于在选择要删除的文件之前对文件进行排序。默认设置是首先对最近修改的文件进行排序。
pathConditions如果未指定ScriptCondition，则为必需。可以指定一个或多个PathCondition元素。如果指定了多个PathCondition元素，则需要所有的PathCondition结果都为true才会进行删除。PathCondition也可以嵌套。如果进行嵌套，则是先判断外层的PathCondition，然后进行内层的判断。如果没有嵌套，则是按顺序进行判断。也可以创建自定义条件或使用内置条件：IfFileName 如果文件名与此参数匹配则结果为true，此参数为正则表达式或 glob的文件。IfLastModified 最后修改时间早于或等于此参数则结果为true，此参数为duration。IfAccumulatedFileCount 文件数超过指定个数则结果为true，此参数为整型。IfAccumulatedFileSize 所有文件总大小达到此参数则结果为true，此参数为KB、MB、GB。IfAll 如果此标签下的所有条件都配置成功（逻辑与），则结果为true。IfAny 如果此标签下的任何一个条件匹配成功（逻辑或），则结果为true。IfNot 如果此标签下的所有条件都不匹配（逻辑非），则结果为true。
scriptCondition如果未指定PathConditions，则为必需。指定脚本的ScriptCondition元素。ScriptCondition应该包含一个Script，ScriptRef或ScriptFile元素，该元素指定要执行的逻辑。（有关配置ScriptFiles和ScriptRefs的更多示例，另请参阅ScriptFilter文档。）该脚本传递了许多参数，包括在basePath下找到的路径列表（最大maxDepth），并且必须返回包含要删除的路径的列表。

标签: log4j2

Leave a Comment