log4j2 replace_log4j2配置文件详解

                 log4j2 RollingRandomAccessFile配置

转载：https://garssion.iteye.com/blog/

一、需求背景

1. 日志按小时压缩成zip文件。

2. 仅保存距离当前时间最近24小时的历史压缩文件。

3. 压缩封存的zip文件，按照零点为参考点纠偏。

4. 将com.roadway.acceptor.base.DebugUtils类的日志输出到指定文件，且不再输出到其他文件。

二、log4j2 配置实现

xml代码
 

<?xml version="1.0" encoding="UTF-8"?> <Configuration status="INFO" monitorInterval="120"> <properties> <property name="MSG_LOG_HOME">/data/gpslog</property> </properties> <Appenders> <Console name="Console" target="SYSTEM_OUT"> <PatternLayout pattern="%d [%t] %-5p [%c] - %m%n" /> </Console> <RollingRandomAccessFile name="msgAppender" immediateFlush="true" fileName="${MSG_LOG_HOME}/msg.log" filePattern="${MSG_LOG_HOME}/backup/msg.%d{yyyyMMddHH}.zip"> <Filters> <ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/> </Filters> <PatternLayout pattern="%m%n" /> <Policies> <TimeBasedTriggeringPolicy interval="1" modulate="true"/> </Policies> <DefaultRolloverStrategy max="24"> <Delete basePath="${MSG_LOG_HOME}" maxDepth="2"> <IfFileName glob="*/msg.*.zip" /> <IfLastModified age="24H" /> </Delete> </DefaultRolloverStrategy> </RollingRandomAccessFile> </Appenders> <Loggers> <AsyncLogger name="com.roadway.DebugUtils" additivity="FALSE" level="INFO"> <appender-ref ref="msgAppender" /> </AsyncLogger> </Loggers> </Configuration> 

 三、配置说明

1. monitorInterval，博客配置的为120，单位为秒。即在服务运行过程中发生了log4j2配置文件的修改，log4j2能够在monitorInterval时间范围重新加载配置，无需重启应用。

2. property配置文件全局属性的声明，使用方式为：${声明的属性名称}。

    ${sys:catalina.home}为tomcat部署路径，例如：/data/tomcat。

3. RollingRandomAccessFile基本属性

    name：Appender名称

    immediateFlush：log4j2接收到日志事件时，是否立即将日志刷到磁盘。默认为true。

    fileName：日志存储路径

    filePattern：历史日志封存路径。其中%d{yyyyMMddHH}表示了封存历史日志的时间单位（目前单位为小时，yyyy表示年，MM表示月，dd表示天，HH表示小时，mm表示分钟，ss表示秒，SS表示毫秒）。注意后缀，log4j2自动识别zip等后缀，表示历史日志需要压缩。

4. TimeBasedTriggeringPolicy

interval：表示历史日志封存间隔时间，单位为filePattern设置的单位值

modulate：表示是否历史日志生成时间纠偏，纠偏以零点为基准进行。比如：15:16生成了msg..zip文件，那么纠偏后会在16:00生成msg..zip

5. ThresholdFilter

     level，表示最低接受的日志级别，博客配置的为INFO，即我们期望打印INFO级别以上的日志。

     onMatch，表示当日志事件的日志级别与level一致时，应怎么做。一般为ACCEPT，表示接受。

     onMismatch，表示日志事件的日志级别与level不一致时，应怎么做。一般为DENY，表示拒绝。也可以为NEUTRAL表示中立。

6. 保存24小时历史日志，但不想用文件索引

Xml代码

<DefaultRolloverStrategy max="24"> <Delete basePath="${MSG_LOG_HOME}" maxDepth="2"> <IfFileName glob="*/msg.*.zip" /> <IfLastModified age="24H" /> </Delete> </DefaultRolloverStrategy> 

备注：

1. age的单位：D、H、M、S，分别表示天、小时、分钟、秒

2. basePath表示日志存储的基目录，maxDepth=“1”表示当前目录。因为我们封存的历史日志在basePath里面的backup目录，所以maxDepth设置为2。

7. RollingRandomAccessFile设置bufferSize不生效问题

a. log4j2配置如下：

Xml代码

<RollingRandomAccessFile name="msgAppender" immediateFlush="false" bufferSize="512" fileName="${MSG_LOG_HOME}/msg.log" filePattern="${MSG_LOG_HOME}/backup/msg.%d{yyyyMMddHH}.zip"> ...... 

b. 使用异步Logger方式输出日志

Xml代码

...... <AsyncLogger name="com.roadway.DebugUtils" additivity="FALSE" level="INFO"> <appender-ref ref="msgAppender" /> </AsyncLogger> ...... 

c. 验证

经过反复测试验证，日志始终实时刷新到磁盘，这是为什么？查看log4j2文档发现：

Asynchronous loggers and appenders will automatically flush at the end of a batch of events, even if immediateFlush is set to false. This also guarantees the data is written to disk but is more efficient.

因此，如果期望使用RollingRandomAccessFile异步的方式打印输出日志，bufferSize是无法生效的且也没有必要采用buffer的方式。

请参考log4j2官网地址：http://logging.apache.org/log4j/2.x/manual/appenders.html