Log4j2 的配置简单学习
一、Log4j2 Maven配置
Log4j2的性能高于log4j与logback,在项目中建议使用Log4j2,其依赖如下
<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-api</artifactId> <version>2.6.2</version> </dependency> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-core</artifactId> <version>2.6.2</version> </dependency>
二、log4j2.xml文件配置
log4j2.xml的配置文件放在classpath下就会被自动加载,其配置如下:
<?xml version="1.0" encoding="UTF-8"?> <!-- status : 这个用于设置log4j2自身内部的信息输出,可以不设置,当设置成trace时,会看到log4j2内部各种详细输出 monitorInterval : Log4j能够自动检测修改配置文件和重新配置本身, 设置间隔秒数。 --> <Configuration status="INFO"> <Properties> <property name="service_name">ershourecycle</property> <!-- %d{yyyy-MM-dd HH:mm:ss, SSS} : 日志生产时间 %p : 日志输出格式 %c : logger的名称 %m : 日志内容,即 logger.info("message") %n : 换行符 %C : Java类名 %L : 日志输出所在行数 %M : 日志输出所在方法名 hostName : 本地机器名 hostAddress : 本地ip地址 --> <property name="log_pattern">[%d{MM-dd HH:mm:ss,SSS} %-5p] [%t] %c{2\} - %m%n%ex</property> <property name="daily_pattern">[%d{MM-dd HH:mm:ss SSS} %-5level] [%t] %c{3} - %m%n%ex</property> <property name="log_home">/opt/scf/log/ershourecycle</property> <property name="age">50</property> </Properties> <Appenders> <!-- console begin 输出控制台的配置 --> <Console name="console" target="SYSTEM_OUT"> <!-- 控制台只输出level及以上级别的信息(onMatch),其他的直接拒绝(onMismatch) --> <ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY"/> <!-- 输出日志的格式 --> <PatternLayout pattern="${log_pattern}" /> </Console> <!-- console end --> <!-- dailyDebug begin --> <RollingFile name="dailyDebug" fileName="${log_home}/${service_name}_debug.log" filePattern="${log_home}/${service_name}_debug.log.%d{yyyy-MM-dd}-%i.log.gz"> <PatternLayout> <Pattern>${daily_pattern}</Pattern> </PatternLayout> <Filters> <ThresholdFilter level="debug" onMatch="ACCEPT" onMismatch="DENY" /> </Filters> <Policies> <TimeBasedTriggeringPolicy /> </Policies> <DefaultRolloverStrategy max="${age}" /> </RollingFile> <!-- dailyDebug end --> <!-- dailyInfo begin --> <RollingFile name="dailyInfo" fileName="${log_home}/${service_name}_info.log" filePattern="${log_home}/${service_name}_info.log.%d{yyyy-MM-dd}-%i.log.gz"> <PatternLayout> <Pattern>${daily_pattern}</Pattern> </PatternLayout> <Filters> <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY" /> </Filters> <Policies> <TimeBasedTriggeringPolicy /> </Policies> <DefaultRolloverStrategy max="${age}" /> </RollingFile> <!-- dailyInfo end --> <!-- dailyError begin --> <RollingFile name="dailyError" fileName="${log_home}/${service_name}_error.log" filePattern="${log_home}/${service_name}_error.log.%d{yyyy-MM-dd}-%i.log.gz"> <PatternLayout> <Pattern>${daily_pattern}</Pattern> </PatternLayout> <Filters> <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY" /> </Filters> <Policies> <TimeBasedTriggeringPolicy /> </Policies> <DefaultRolloverStrategy max="${age}" /> </RollingFile> <!-- dailyError end --> </Appenders> <Loggers> <!-- 配置日志的根节点 --> <Root level="debug"> <AppenderRef ref="console" /> <AppenderRef ref="dailyDebug" /> <AppenderRef ref="dailyInfo" /> <AppenderRef ref="dailyError" /> </Root> <!-- 日志实例(info),其中'serviceLog',通过属性'additivity="false"'将'service-log'的的日志不再输出到控制台 --> <logger name="serviceLog" level="info" includeLocation="true" additivity="true"> <appender-ref ref="dailyInfo"/> <!-- 可以自定义appender --> </logger> </Loggers> </Configuration>
在配置文件中:
1、根节点configuration下有两个子节点:appenders和loggers(可定义多个appender和logger了)
2、appenders:定义输出,如定义的Console,是将日志输出到控制台,并对输出设置属性(通过PatternLayout设置输出格式)
3、loggers:定义多个logger,且logger通过name进行区分,对不同的logger配置不同的输出可appender-ref引用配置的appender的name
4、logger name机制
logger name类似于java package一样,比如有个包:cn.lsw.base.log4j2,而且生成Logger对象的时候通常通过Hello.class.getName()匹配定义的logger name,这是因为Logger也有继承关系。比如给cn.lsw.base定义了一个logger,那么它也适用于cn.lsw.base.lgo4j2这个logger。名称的继承是通过点“.”分隔的。此外,在上面的loggers配置中有子节点不是logger而是root,而且这个root没有name属性。这个root相当于根节点,所有的logger都适用与这个logger,所以即使在很多类里面通过类名.class.getName()得到很多的logger,而且没有在配置文件的loggers下面做配置也都能够输出,因为都继承了root的配置。
5,Filters:<Filters>是组合过滤器额标签,它包含的子标签是具体的过滤器,这三个具体过滤器分别是:
日志等级过滤器:
ThresholdFilter
正则表达式过滤器:
RegexFilter
和时间过滤器:
TimeFilter
<Filters> <ThresholdFilter level="TRACE" onMatch="NEUTRAL" onMismatch="DENY"/> <RegexFilter regex=".* test .*" onMatch="NEUTRAL" onMismatch="DENY"/> <TimeFilter start="05:00:00" end="05:30:00" onMatch=" NEUTRAL " onMismatch="DENY"/> </Filters>
需要说明的是onMatch 和 onMismatch 可以选择的值及其含义。
可选的值分别是,ACCEPT(接受), DENY(拒绝), NEUTRAL(中立)。
ACCEP 和 DENY比较好理解就是接受和拒绝的意思,在使用单个过滤器的时候,一般就是使用这两个值。但是在组合过滤器中,如果用接受ACCEPT的话,日志信息就会直接写入日志文件,后续的过滤器不再进行过滤。所以,在组合过滤器中,接受使用NEUTRAL(中立),被第一个过滤器接受的日志信息,会继续用后面的过滤器进行过滤,只有符合所有过滤器条件的日志信息,才会被最终写入日志文件。
三、log4j2与slf4j集成
log4j与slf4j集成还需添加另外的两个Maven Jar包依赖,配置如下:
<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.7.21</version> </dependency> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-api</artifactId> <version>2.6.2</version> </dependency> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-core</artifactId> <version>2.6.2</version> </dependency> <!-- log4j-slf4j-impl(用于log4j2与slf4j集成) --> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-slf4j-impl</artifactId> <version>2.6.2</version> </dependency>
获取Logger对象方式:
// log4j2方式 private static final org.apache.logging.log4j.Logger LOG = org.apache.logging.log4j.LogManager.getLogger(Logstrap.class); // slf4j方式 private static final org.slf4j.Logger LOG = org.slf4j.LoggerFactory.getLogger(LoggerFactory.class);
转载请注明:刘召考的博客 » Log4j2 的配置简单学习
文章来源:
Author:goomoon
link:http://www.liuzk.com/322.html