原文： https://howtodoinjava.com/log4j2/log4j-2-xml-configuration-example/

Apache Log4j2 是对 Log4j 1.x 的升级，与以前的版本相比有了显着改进，例如性能提高，自动重新加载已修改的配置文件， Java8 lambda 支持和自定义日志级别。

Log4j2.4 及更高版本需要 Java 7。 版本 2.0-alpha1 至 2.3 需要 Java 6。

1. log4j2 maven 依赖

要将 Log4j2 包含在您的项目中，请在项目中包含以下 maven 依赖项。

  1. <dependency>
  2.     <groupId>org.apache.logging.log4j</groupId>
  3.     <artifactId>log4j-api</artifactId>
  4.     <version>2.6.1</version>
  5. </dependency>
  6. <dependency>
  7.     <groupId>org.apache.logging.log4j</groupId>
  8.     <artifactId>log4j-core</artifactId>
  9.     <version>2.6.1</version>
  10. </dependency>

2. 用于控制台日志log4j2.xml

您可以使用下面的log4j2.xml将日志输出到控制台。 请注意，如果找不到配置文件，则将使用DefaultConfiguration。 这也将日志输出到控制台。

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Configuration status="INFO">
  3.     <Appenders>
  4.         <Console name="console" target="SYSTEM_OUT">
  5.             <PatternLayout
  6.                 pattern="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %c{1} - %msg%n" />
  7.         </Console>
  8.     </Appenders>
  9.     <Loggers>
  10.         <Root level="debug" additivity="false">
  11.             <AppenderRef ref="console" />
  12.         </Root>
  13.     </Loggers>
  14. </Configuration>

3. 用于滚动文件日志的log4j2.xml

您可以使用下面的log4j2.xml文件将日志输出到基于日期的滚动文件 – 以及控制台。

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Configuration status="warn">
  3.     <Properties>
  4.         <Property name="basePath">C:\\logs</Property>
  5.     </Properties>
  7.     <Appenders>
  8.         <RollingFile name="fileLogger" fileName="${basePath}/app-info.log" filePattern="${basePath}/app-info-%d{yyyy-MM-dd}.log">
  9.             <PatternLayout>
  10.                 <pattern>[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %c{1} - %msg%n</pattern>
  11.             </PatternLayout>
  12.             <Policies>
  13.                 <TimeBasedTriggeringPolicy interval="1" modulate="true" />
  14.             </Policies>
  15.         </RollingFile>
  17.         <Console name="console" target="SYSTEM_OUT">
  18.             <PatternLayout    pattern="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %c{1} - %msg%n" />
  19.         </Console>
  20.     </Appenders>
  21.     <Loggers>
  22.         <Logger name="com.howtodoinjava" level="debug" additivity="true">
  23.             <appender-ref ref="fileLogger" level="debug" />
  24.         </Logger>
  25.         <Root level="debug" additivity="false">
  26.             <appender-ref ref="console" />
  27.         </Root>
  28.     </Loggers>
  29. </Configuration>

4. log4j2.xml文件位置

您应该将log4j2.xml放在应用的类路径中的任何位置。 Log4j 将扫描所有类路径位置以查找此文件，然后加载它。

Log4j2 xml 配置示例 - 图1

Log4j2.xml文件位置

5. log4j2.xml示例

让我们编写一个 Java 类，并写一些日志语句，以验证控制台和日志文件中的日志是否也在增加。 它将不同的日志级别记录到不同的日志中

  1. package com.howtodoinjava.log4j2.examples;
  3. import org.apache.logging.log4j.LogManager;
  4. import org.apache.logging.log4j.Logger;
  6. public class Log4j2HelloWorldExample 
  7. {
  8.     private static final Logger LOGGER = LogManager.getLogger(Log4j2HelloWorldExample.class.getName());
  10.     public static void main(String[] args) 
  11.     {
  12.         LOGGER.debug("Debug Message Logged !!!");
  13.         LOGGER.info("Info Message Logged !!!");
  14.         LOGGER.error("Error Message Logged !!!", new NullPointerException("NullError"));
  15.     }
  16. }

现在，当您运行上述程序时，您将在控制台中获得以下日志。

  1. [DEBUG] 2016-06-16 12:17:42.972 [main] Log4j2HelloWorldExample - Debug Message Logged !!!
  2. [INFO ] 2016-06-16 12:17:42.996 [main] Log4j2HelloWorldExample - Info Message Logged !!!
  3. [ERROR] 2016-06-16 12:17:42.997 [main] Log4j2HelloWorldExample - Error Message Logged !!!
  4. java.lang.NullPointerException: NullError
  5.     at com.howtodoinjava.log4j2.examples.Log4j2HelloWorldExample.main(Log4j2HelloWorldExample.java:14) [classes/:?]

如果您更改系统日期并再次运行该应用，则会在配置的位置找到两个日志文件，即app-info.log和app-info-2016-06-15.log –第二个文件将在该文件上滚动。

6. 带有多文件附加器的log4j2.xml

使用此简单log4j2.xml作为多个日志文件中的日志语句的快速参考。 它使用LevelRangeFilter将不同级别的日志（debug，info等）记录到不同的文件中，以便您的日志干净且分开，以便于分析。

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Configuration status="WARN" monitorInterval="30">
  4.     <!-- Logging Properties -->
  5.     <Properties>
  6.         <Property name="LOG_PATTERN">%d{yyyy-MM-dd'T'HH:mm:ss.SSSZ} %p %m%n</Property>
  7.         <Property name="APP_LOG_ROOT">c:/temp</Property>
  8.     </Properties>
  10.     <Appenders>
  12.         <!-- Console Appender -->
  13.         <Console name="Console" target="SYSTEM_OUT" follow="true">
  14.             <PatternLayout pattern="${LOG_PATTERN}"/>
  15.         </Console>
  17.         <!-- File Appenders on need basis -->
  18.         <RollingFile name="frameworkLog" fileName="${APP_LOG_ROOT}/app-framework.log" 
  19.             filePattern="${APP_LOG_ROOT}/app-framework-%d{yyyy-MM-dd}-%i.log">
  20.             <LevelRangeFilter minLevel="ERROR" maxLevel="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>
  21.             <PatternLayout pattern="${LOG_PATTERN}"/>
  22.             <Policies>
  23.                 <SizeBasedTriggeringPolicy size="19500KB" />
  24.             </Policies>
  25.             <DefaultRolloverStrategy max="10"/>
  26.         </RollingFile>
  28.         <RollingFile name="debugLog" fileName="${APP_LOG_ROOT}/app-debug.log" 
  29.             filePattern="${APP_LOG_ROOT}/app-debug-%d{yyyy-MM-dd}-%i.log">
  30.             <LevelRangeFilter minLevel="DEBUG" maxLevel="DEBUG" onMatch="ACCEPT" onMismatch="DENY"/>
  31.             <PatternLayout pattern="${LOG_PATTERN}"/>
  32.             <Policies>
  33.                 <SizeBasedTriggeringPolicy size="19500KB" />
  34.             </Policies>
  35.             <DefaultRolloverStrategy max="10"/>
  36.         </RollingFile>
  38.         <RollingFile name="infoLog" fileName="${APP_LOG_ROOT}/app-info.log" 
  39.             filePattern="${APP_LOG_ROOT}/app-info-%d{yyyy-MM-dd}-%i.log" >
  40.             <LevelRangeFilter minLevel="INFO" maxLevel="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
  41.             <PatternLayout pattern="${LOG_PATTERN}"/>
  42.             <Policies>
  43.                 <SizeBasedTriggeringPolicy size="19500KB" />
  44.             </Policies>
  45.             <DefaultRolloverStrategy max="10"/>
  46.         </RollingFile>
  48.         <RollingFile name="errorLog" fileName="${APP_LOG_ROOT}/app-error.log" 
  49.             filePattern="${APP_LOG_ROOT}/app-error-%d{yyyy-MM-dd}-%i.log" >
  50.             <LevelRangeFilter minLevel="ERROR" maxLevel="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>
  51.             <PatternLayout pattern="${LOG_PATTERN}"/>
  52.             <Policies>
  53.                 <SizeBasedTriggeringPolicy size="19500KB" />
  54.             </Policies>
  55.             <DefaultRolloverStrategy max="10"/>
  56.         </RollingFile>
  58.         <RollingFile name="perfLog" fileName="${APP_LOG_ROOT}/app-perf.log" 
  59.             filePattern="${APP_LOG_ROOT}/app-perf-%d{yyyy-MM-dd}-%i.log" >
  60.             <PatternLayout pattern="${LOG_PATTERN}"/>
  61.             <Policies>
  62.                 <SizeBasedTriggeringPolicy size="19500KB" />
  63.             </Policies>
  64.             <DefaultRolloverStrategy max="1"/>
  65.         </RollingFile>
  67.         <RollingFile name="traceLog" fileName="${APP_LOG_ROOT}/app-trace.log" 
  68.             filePattern="${APP_LOG_ROOT}/app-trace-%d{yyyy-MM-dd}-%i.log" >
  69.             <PatternLayout pattern="${LOG_PATTERN}"/>
  70.             <Policies>
  71.                 <SizeBasedTriggeringPolicy size="19500KB" />
  72.             </Policies>
  73.             <DefaultRolloverStrategy max="1"/>
  74.         </RollingFile>
  76.     </Appenders>
  78.     <Loggers>
  80.         <Logger name="com.howtodoinjava.app.somePackage" additivity="false" level="trace">
  81.             <AppenderRef ref="traceLog" />
  82.             <AppenderRef ref="Console" />
  83.         </Logger>
  85.         <Logger name="com.howtodoinjava.app" additivity="false" level="debug">
  86.             <AppenderRef ref="debugLog" />
  87.             <AppenderRef ref="infoLog"  />
  88.             <AppenderRef ref="errorLog" />
  89.             <AppenderRef ref="Console"  />
  90.         </Logger>
  92.         <Logger name="org.framework.package" additivity="false" level="info">
  93.             <AppenderRef ref="perfLog" />
  94.             <AppenderRef ref="Console"/>
  95.         </Logger>
  97.         <Root level="warn">
  98.             <AppenderRef ref="Console"/>
  99.         </Root>
  101.     </Loggers>
  103. </Configuration>

学习愉快！