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