记录日志使我们日常排查问题常用的手段,log4j2因其强大性能表现为众多应用所采用。以下为个人总结几个常用的功能,以供参考。
基本概念:
- appender:日志文件输出的目的地,常用FileAppender:输出到本地文件 RollingFileAppender:根据条件,对日志文件进行拆分保存 AsynchAppender:异步写入目的地
- logger:抽象的日志记录器,默认使用root根日志记录器,可以自定义Logger,都是继承与跟Logger。
- filter:过滤器,顾名思义根据条件过滤写入日志,通常用四个级别Context-wide、Logger 、Appender 、Appender Reference, 包含两个属性:onMatch和onMismatch,属性可选值3种:ACCEPT, DENY,NEUTRAL
打印格式化
符号 | 描述 |
---|---|
%c | 输出所属的类目,通常就是所在类的全名 |
%C | 输出Logger所在类的名称,通常就是所在类的全名 |
%d | 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式 |
%F | 输出所在类的类名称,只有类名。 |
%l | 输出语句所在的行数,包括类名+方法名+文件名+行数 |
%L | 输出语句所在的行数,只输出数字 |
%m | 输出代码中指定的讯息,如log(message)中的message |
%M | 输出方法名 |
%p | 输出日志级别,即DEBUG,INFO,WARN,ERROR,FATAL |
%r | 输出自应用启动到输出该log信息耗费的毫秒数 |
%t | 输出产生该日志事件的线程名 |
%n | 输出一个回车换行符,Windows平台为“/r/n”,Unix平台为“/n” |
%% | 用来输出百分号“%” |
日志分离:通过filter达到不同级别日志输出不同文件:
日志切分:通过策略进行配置
示例:
<RollingFile name="xxx" fileName="xxx.log" filePattern="xxx-%d{yyyy-MM-dd}-%i.log">
<!--输出格式-->
<PatternLayout charset="UTF-8" pattern="%d{yyyy/MM/dd HH:mm:ss.SSS} [%t] %-5level %logger{1.} - %msg%n"/>
<!--仅输出info级别日志-->
<Filters>
<ThresholdFilter level="error" onMatch="DENY" onMismatch="NEUTRAL"/>
<ThresholdFilter level="warn" onMatch="DENY" onMismatch="NEUTRAL"/>
<ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
</Filters>
<!--日志分割策略-->
<Policies>
<!--每天单独一个文件-->
<TimeBasedTriggeringPolicy modulate="true" interval="1"/>
<!--文件超过1G,拆分文件-->
<SizeBasedTriggeringPolicy size="1 G"/>
</Policies>
<!--保留日志策略,保留7个-->
<DefaultRolloverStrategy max="7"/>
</RollingFile>
附maven:
<dependencies>
<properties>
<slf4j.version>1.7.22</slf4j.version>
<log4j.version>2.7</log4j.version>
</properties>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>${slf4j.version}</version>
</dependency>
<!--用于slf4j与log4j2保持桥接 -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
<scope>runtime</scope>
<version>${log4j.version}</version>
</dependency>
<!-- 核心包与接口包 -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<scope>runtime</scope>
<version>${log4j.version}</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>${log4j.version}</version>
</dependency>
<!--AsyncLogger需要 -->
<dependency>
<groupId>com.lmax</groupId>
<artifactId>disruptor</artifactId>
<scope>runtime</scope>
<version>3.4.2</version>
</dependency>
</dependencies>