log4j2日志框架使用-编程知识

log4j2日志框架使用

依赖

<dependency><groupId>org.apache.logging.log4j</groupId><artifactId>log4j-core</artifactId><version>2.11.1</version>
</dependency>

配置文件样列

<?xml version="1.0" encoding="UTF-8"?>
<!--Configuration后面的status，这个用于设置log4j2自身内部的信息输出，可以不设置，当设置成trace时，你会看到log4j2内部各种详细输出-->
<!--monitorInterval：Log4j能够自动检测修改配置 文件和重新配置本身，设置间隔秒数-->
<Configuration status="warn" monitorInterval="60"><!--日志级别以及优先级排序: OFF > FATAL > ERROR > WARN > INFO > DEBUG > TRACE > ALL --><Properties><Property name="LOG_HOME">./log4j2</Property></Properties><Appenders><!-- 输出控制台日志的配置 --><Console name="console" target="SYSTEM_OUT"><!--控制台只输出level及以上级别的信息（onMatch），其他的直接拒绝（onMismatch）--><ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/><!-- 输出日志的格式 --><!-- 格式化输出：%date表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度 %msg：日志消息，%n是换行符--><!-- %logger{36} 表示 Logger 名字最长36个字符 --><PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"/></Console><!-- 打印出所有的信息，每次大小超过size，则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩，作为存档 --><RollingFile name="infoLog" fileName="${LOG_HOME}/log-analysis-info.log"filePattern="${LOG_HOME}/log-analysis-info-%d{yyyy-MM-dd}-%i.log.gz"><PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS z} [%thread] %-5level %logger{36} %L %M - %msg%xEx%n"/><Policies><!--interval属性用来指定多久滚动一次，默认是1， 单位到底是月 天 小时 分钟，根据filePattern配置的日期格式而定，本处的格式为天，则默认为1天--><TimeBasedTriggeringPolicy interval="1" modulate="true"/><!--按大小分--><SizeBasedTriggeringPolicy size="20 MB"/></Policies><Filters><!-- 只记录info和warn级别信息 --><!--<ThresholdFilter level="error" onMatch="DENY" onMismatch="NEUTRAL"/>--><ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/></Filters><!-- 指定每天的最大压缩包个数，默认7个，超过了会覆盖之前的 --><DefaultRolloverStrategy max="1000"/></RollingFile><!-- 存储所有error信息 --><RollingFile name="errorLog" fileName="${LOG_HOME}/log-analysis-error.log"filePattern="${LOG_HOME}/log-analysis-error-%d{yyyy-MM-dd}-%i.log.gz"><PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS z} [%thread] %-5level %logger{36} %L %M - %msg%xEx%n"/><Policies><!--interval属性用来指定多久滚动一次，默认是1， 单位到底是月 天 小时 分钟，根据filePattern配置的日期格式而定，本处的格式为天，则默认为1天--><TimeBasedTriggeringPolicy interval="1" modulate="true"/><!--按大小分--><SizeBasedTriggeringPolicy size="20 MB"/></Policies><Filters><!-- 只记录error级别信息 --><ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/></Filters><!-- 指定每天的最大压缩包个数，默认7个，超过了会覆盖之前的 --><DefaultRolloverStrategy max="1000"/></RollingFile></Appenders><Loggers><!-- root logger 配置,全局配置，默认所有的Logger都继承此配置 --><!-- AsyncRoot - 异步记录日志 - 需要LMAX Disruptor的支持 --><Root level="info"><AppenderRef ref="infoLog"/><AppenderRef ref="errorLog"/><AppenderRef ref="console"/></Root><!--将logger中的 additivity 属性配置为 false，则这个logger不会将日志流反馈到root中,反之会反馈到root中--><!--所谓反馈即是指：会把该日志事件输入到root下配置的appender中，然后根据条件输出--><logger name = "com.lyc.log.log4j2" additivity = "false"><AppenderRef ref="infoLog"/><AppenderRef ref="errorLog"/><AppenderRef ref="console"/></logger></Loggers>
</Configuration>

配置项说明

log4j2的配置文件语法树如下：结构清晰。总配置是一个Configuration,下面包含4类标签：

Properties、filter、appenders、loggers

<?xml version="1.0" encoding="UTF-8"?>;
<Configuration>
<Properties>
<Property >value</property>
</Properties>
<filter ... />
<Appenders>
<appender ... >
<filter ... />
</appender>
...
</Appenders>
<Loggers>
<Logger >
<appender .../>
</Logger>
...
<Root level="level">
<AppenderRef ref="name"/>
</Root>
</Loggers>
</Configuration>

源码浅析

入口：

Logger logger = LogManager.getLogger(Log4j2ParseDemo1.class.getName());

LogManager静态代码块：

这里是基于jdk的spi机制读取依赖中实现了org.apache.logging.log4j.spi.Provider类：在log4j2中的类是：org.apache.logging.log4j.core.impl.Log4jProvider

然后获取日志上线文

最终会由ConfigurationFactory#getConfiguration完成配置文件加载初始化。

log4j2支持四种类型的配置文件：XML/JSON/YML/Properties(后缀支持的不只4种)，由四种解析器完成。主流配置是xml。

org.apache.logging.log4j.core.config.ConfigurationFactory.Factory#getConfiguration(org.apache.logging.log4j.core.LoggerContext, java.lang.String, java.net.URI)