Apache Log4j 2是日志框架Log4j的升级，它比其前身Log4j 1.x提供了重要的改进，并且参考了Logback中许多有用的改进，同时修复了Logback的一些固有问题。

本文介绍Log4j2的常用功能，给出一个完整的log4j2.xml配置文件，作为工作开发中常用的日志配置参考。

一、示例项目结构

示例项目结构如下所示，比较简单。

二、Maven依赖包

在项目的pom.xml文件中，添加如下log4j2的依赖JAR包。

<properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <maven.compiler.source>1.8</maven.compiler.source>
  <maven.compiler.target>1.8</maven.compiler.target>
  <log4j-version>2.15.0</log4j-version>
</properties>

<dependencies>
  <dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>${log4j-version}</version>
  </dependency>
  <dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>${log4j-version}</version>
  </dependency>
</dependencies>

三、配置文件

Log4j2能够在初始化期间自动配置，它支持4种格式的配置文件：

Properties, YAML, JSON, XML

并且按从高到低的顺序查找配置文件。

Log4j2启动时，首先检查系统属性log4j.configurationFile，如果设置了该属性，则匹配文件扩展名去加载配置文件，

就是说文件名可以是任意的，文件扩展名必须是上面的4种之一。

在启动应用时配置该参数，示例如下：

java -jar -Dlog4j.configurationFile="/home/rickie/myLog4j2.xml" log4j2test.jar

我们在项目中创建log4j2.xml配置文件：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <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">
            <AppenderRef ref="Console"/>
        </Root>
    </Loggers>
</Configuration>

配置文件中主要有两类配置：

一类是Appenders：定义日志输出目的地，内容和格式等。

另一类是Loggers：定义日志级别和使用的Appenders。

<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n”/>，其中pattern 定义日志输出格式：

<Configuration status="WARN">

Log4j2内部日志可以输出到控制台，status控制Log4j2内部日志的输出级别。

也可以设置系统属性log4j2.debug，也会将Log4j2内部日志打印到控制台，包括在找到配置文件之前发生的内部日志。

在启动应用时配置该参数，示例如下：

java -jar -Dlog4j2.debug log4j2test.jar

如果找不到配置文件，使用的默认配置等价于下面的配置：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
  <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="ERROR">
      <AppenderRef ref="Console"/>
    </Root>
  </Loggers>
</Configuration>

未完待续，请继续阅读下一篇文章。