Log4j2 配置文件

Log4j2 配置文件

    一、默认配置：

           本来想着以为Log4j2应该有一个默认的配置文件，不过一直没有找到，查阅了一下官网Configuration文档，原文如下：

    Log4j will provide a default configuration if it cannot locate a configuration file. The default configuration, provided in the DefaultConfiguration class, will set up:       

• A ConsoleAppender attached to the root logger.
• A PatternLayout set to the pattern "%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n" attached to the ConsoleAppender

Note that by default Log4j assigns the root logger to Level.ERROR.

看不懂? 没关系，继续看：

        As was described previously, Log4j will first attempt to configure itself from configuration files. A configuration equivalent to the default would look like:

意思下面这个配置文件等同于缺省配置：

<?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>

    

    二、配置详解：

        1、关于配置文件的名称以及在项目中的存放位置：

            log4j2 版本不再支持像 1.x中的.properties后缀的文件配置方式，2.x版本配置文件后缀名只能为“.xml”,“.json”或者“.jsn”。

            系统选择配置文件的优先级（从先到后）如下：

                （1）.classpath下的名为log4j2-test.json 或者 log4j2-test.jsn的文件.

                （2）.classpath下的名为log4j2-test.xml的文件.

                （3）.classpath下的名为log4j2.json 或者 log4j2.jsn的文件.

                （4）.classpath下的名为log4j2.xml的文件.

            一般情况，我们默认使用log4j2.xml 进行命名。如果要进行本地测试，可以把log4j2-test.xml 放置 classpath，而正式环境使用log4j2.xml，在打包部署的时候不要打包log4j2-test.xml即可。

        2、缺省默认配置文件

<?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>
    <Logger name="com.foo.Bar" level="trace">
      <AppenderRef ref="Console"/>
    </Logger>
    <Root level="error">
      <AppenderRef ref="Console"/>
    </Root>
  </Loggers>
</Configuration>

        3、配置文件节点解析

            （1）Configuration根节点，有两个属性：status 和 monitorinterval，有两个子节点：Appenders 和 Loggers（表明可以定义多个Appender 和 Logger）。

                    status：用来指定log4j本身的打印日志的级别。

                    monitorinterval：用于指定log4j自动重新配置的监测间隔时间，单位是s，最小是5s。

            （2）Appenders节点，常见的有三种子节点：Console、RollingFile、File。

                    Console：用来定义输出到控制台的Appender。

                            name：指定Appender的名字。

                            target：包括“SYSTEM_OUT”和 “SYSTEM_ERR”，一般默认设置为SYSTEM_OUT。

                            PatternLayout：输出格式，不设置默认为：%msg%n。

                    RollingFile：用来定义超过指定打消自动删除旧的创建新的Appender。

                            name：指定Appender的名字。

                            fileName：指定输出日志的目的文件带全路径的文件名。

                            PatternLayout：输出格式，不设置默认为：%msg%n。

                            filePattern：指定新建日志文件的名称格式。

                            Policies：指定滚动日志的策略，就是什么时候进行新建日志文件输出日志。

                    File：用来定义输出到指定位置的文件的Appender。

                            name：指定Appender的名字。

                            fileName：指定输出日志的目的文件带全路径的文件名。

                            PatternLayout：输出格式，不设置默认为：%msg%n。

            （3）Loggers节点，常见的有两种：Root 和 Logger。

                    Root：用来指定项目的根日志，如果没有单独指定Logger，那么就会默认使用该Root日志输出

                            level：日志输出级别，共有8个级别，按照从低到高为：ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF。

                            AppenderRef：Root的子节点，用来指定该日志输出到哪个Appender。

                    Logger：用来单独指定日志的形式，比如要为指定包下的class指定不同的日志级别等。

                              level：日志输出级别，共有8个级别，按照从低到高为：ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF。

                                name：用来指定该Logger所使用的类火灾类所在的包全路径，继承自Root节点。

                                AppenderRef：Logger的子节点，用来指定该日志输出到哪个Appender，如果没有指定，就会默认继承自Root，如果指定了，那么会在指定的这个Appender 和 Root 的Appender中都会输出，此时我们可以设置Logger的additivity=“false”只在自定义的Appender中进行输出。

            （4）关于日志Level

                        共有8个级别，按照从低到高为：ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF。

                                        All:最低等级的，用于打开所有日志记录.

　　　　　                   　Trace:是追踪，就是程序推进一下.

　　　　　　                   Debug:指出细粒度信息事件对调试应用程序是非常有帮助的.

　　　　　                   　Info:消息在粗粒度级别上突出强调应用程序的运行过程.

　　　　　                　   Warn:输出警告及warn以下级别的日志.

　　　　　　                   Error:输出错误信息日志.

　　　　　　                   Fatal:输出每个严重的错误事件将会导致应用程序的退出的日志.

　　　　　　                   OFF:最高等级的，用于关闭所有日志记录.

        程序会打印高于或等于所设置级别的日志，设置的日志等级越高，打印出来的日志就越少 。

转载于:https://www.cnblogs.com/Remenber-Ray/p/8858036.html