Log4J2用法

一、关于Log4J

2015年5月，Apache宣布Log4J 1.x 停止更新。最新版为1.2.17。

如今，Log4J 2.x已更新至2.7。

官方网址：http://logging.apache.org/log4j/2.x/

二、 Log4J能做什么？

1. 将信息送到控制台，文件，GUI组件等。

2. 控制每条信息的输出格式。

3. 将信息分类，定义信息级别，细致地控制日志的输出。

三、 Log4J2的安装

1. 去官网下载log4j2，解压

2. 最基本的Jar包：

log4j-api-2.7.jar

log4j-core-2.7.jar

3. 将jar文件复制到Web项目的WEB-INF/lib目录下。

四、配置文件介绍

1. 日志级别

trace：追踪，就是程序推进一下，可以写个trace输出

debug：调试，一般作为最低级别，trace基本不用。

info：输出重要的信息，使用较多

warn：警告，有些信息不是错误信息，但也要给程序员一些提示。

error：错误信息。用的也很多。

fatal：致命错误。级别较高，这种级别不用调试了，重写吧……

机制：如果一条日志信息的级别大于等于配置文件的级别，就记录。

2. 输出源

CONSOLE（输出到控制台）、FILE（输出到文件）等。

3. 布局方式

SimpleLayout：以简单的形式显示

HTMLLayout：以HTML表格显示

PatternLayout：自定义形式显示

在Log4J2中基本采用PatternLayout自定义日志布局。

自定义格式：

%t：线程名称

%p：日志级别

%c：日志消息所在类名

%m：消息内容

%M：输出执行方法

%d：发生时间，%d{yyyy-MM-dd HH:mm:ss,SSS}，输出类似：2011-10-18 22:10:28,921

%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。

%L：代码中的行数

%n：换行

c{precision}

logger{precision}

class{precision}àOutputs the name of the logger thatpublished the logging event.

Conversion Pattern	Logger Name	Result
%c{1}	org.apache.commons.Foo	Foo
%c{2}	org.apache.commons.Foo	commons.Foo
%c{10}	org.apache.commons.Foo	org.apache.commons.Foo
%c{-1}	org.apache.commons.Foo	apache.commons.Foo
%c{-2}	org.apache.commons.Foo	commons.Foo
%c{-10}	org.apache.commons.Foo	org.apache.commons.Foo
%c{1.}	org.apache.commons.Foo	o.a.c.Foo
%c{1.1.~.~}	org.apache.commons.test.Foo	o.a.~.~.Foo
%c{.}	org.apache.commons.test.Foo	....Foo

p|level{level=label,level=label, ...} p|level{length=n} p|level{lowerCase=true|false}à you can define the length of the levellabel:

m{nolookups}{ansi}|msg{nolookups}{ansi}|message{nolookups}{ansi}àsupplied message

xEx|xException|xThrowableàsuppress printing of the exception

五、配置使用

1. 配置文件命名与存储位置（Log4J没有默认的配置文件）

系统选择configuration文件的优先级如下（放在src文件夹）：

classpath下名为 log4j-test.json 或者log4j-test.jsn文件

classpath下名为 log4j2-test.xml

classpath下名为 log4j.json 或者log4j.jsn文件

classpath下名为 log4j2.xml

很多人认为src就是classpath，java项目中Classpath路径到底指的是哪里？

1） src不是classpath,而WEB-INF/classes,lib才是classpath，WEB-INF/是资源目录, 客户端不能直接访问。

2） WEB-INF/classes目录存放src目录java文件编译之后的class文件，xml、properties等资源配置文件，这是一个定位资源的入口。

3） lib和classes同属classpath，两者的访问优先级为: lib>classes。

简单的配置文件

<?xml version="1.0" encoding="UTF-8"?>
     <configuration status="OFF">
       <appenders>
         <Console name="Console" target="SYSTEM_OUT">
           <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
         </Console>
       </appenders>
       <loggers>
         <root level="trace">
           <appender-ref ref="Console"/>
         </root>
       </loggers>
     </configuration>

稍微复杂的配置

<?xml version="1.0" encoding="UTF-8"?>
<configuration status="error">

    <appenders>

        <Console name="Console" target="SYSTEM_OUT">

            <ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY"/>

            <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>
        </Console>



        <File name="log" fileName="log/test.log" append="false">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>
        </File>


       <File name="ERROR" fileName="logs/error.log">
            <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="%d{yyyy.MM.dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
        </File>

<RollingFile name="RollingFile" fileName="logs/web.log"
                     filePattern="logs/$${date:yyyy-MM}/web-%d{MM-dd-yyyy}-%i.log.gz">
            <PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
            <SizeBasedTriggeringPolicy size="2MB"/>
        </RollingFile>
    </appenders>


    <loggers>

        <root level="info">
            <appender-ref ref="RollingFile"/>
            <appender-ref ref="Console"/>
           <appender-ref ref="ERROR" />
           <appender-ref ref="log"/>
        </root>

</loggers>
</configuration>

最后说明，

使用Console类型的appender，日志会输出到控制台，windows为控制台，linux为catalina.out文件

使用File,RollingFile为文件类型的appender，日志会输出到指定位置的文件中

如果logger包含控制台和文件类型的appender,且程序中记录日志的logger的级别大于等于配置文件中logger的级别，则日志会在各个类型的文件中记录。

如果logger只包含控制台的appender,且程序中记录日志的logger的级别大于等于配置文件中logger的级别，则日志只会记录在控制台类型的文件中记录。

如果logger只包含文件类型的appender,且程序中记录日志的logger的级别大于等于配置文件中logger的级别，则日志只会在文件类型的文件中记录。

也就是说logger引用了多少个append配置，记录日志时，引用的append都会起作用。

当然，如果程序中的logger调用方法的级别小于配置文件中logger配置的level，则不会记录日志。

下面Java类中使用了slf4j的接口来实现日志记录。这将会使用我们配置文件中Root根节点指定的Appender，如果我们没有自己配置Logger，则会使用Root根节点的默认配置。

private static final Logger logger=LoggerFactory.getLogger(My.class);

下面使用自定义的Logger作为日志记录器,为此加一个自定义Logger，name为myLearningLog

<Loggers>
<Logger name="myLearningLog" level="trace" additivity="false">
<AppenderRef ref="RollingFile"/>
</Logger>
<Root level="trace">
<AppenderRef ref="Console"/>
</Root>
</Loggers>

private static final Logger logger = LoggerFactory.getLogger("myLearningLog");

记录日志

　　 public static void main(String[] args) {
         logger.trace("learning1 log4j trace"); //如果配置文件中logger的level为info，则trace,和debug不会记录
         logger.debug("learning1 log4j debug");
         logger.info("learning1 log4j info");
       logger.warn("learning1 log4j warn");
         logger.error("learning1 log4j error");
       }

相关文章