Java日志体系 —— log4j2

1.1 简介

　　　　　　　　　　　　

log4j2，一个日志的实现框架，是log4j的升级版本，于2014年7月正式亮相。与第一代log4j不同，log4j2完全重写了log4j的日志实现，并不是在原有基础上进行的升级，解决了log4j中的一些问题，例如：多线程下性能低下、api不支持占位符{}的使用、配置文件不能自动重新加载等。

为什么说log4j在多线程情况下性能低下呢？主要是synchronized锁在作怪，当我们的log4jzai 获取appender对象时，需要进行加锁处理；而接下来对appender操作(将要进行日志打印)时，也进行了加锁处理，这样一来性能自然得不到提升，从而导致整个应用的qps下降。

而在log4j2中，由于引入了异步logger，使得log4j2的性能得到了巨大的提升，相比于log4j，logback而言，提升了数10倍之多。关于异步logger的情况，我们后面进行讲解。

1.2 log4j2结构

　　　　　　　　　　　　　　　　

LoggerContext：Logger上下文，主要负责读取log4j2的配置以及获取Logger对象的工作；

Logger：日志对象，负责日志信息的打印；跟之前的几个日志框架相同，log4j2也包含了5大日志级别，分别为TRACE,DEBUG,INFO,WARN,ERROR 以及FATAL；具体等级如下：TRACE < DEBUG < INFO < WARN < ERROR < FATAL;

LoggerConfig：Logger的配置对象，每一个Logger的配置信息就是一个LoggerConfig对象；

Configuration：log4j2配置文件的解析，当我们的配置文件是xml的格式时，具体的实现是XmlConfiguration；每一个LoggerContext都有一个Configuration对象，包含了所有的Appender、Filter、LoggerConfig

1.3 使用

首先，需要在应用的pom.xml中添加依赖：

  <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-api</artifactId>
        <version>2.8.2</version>
    </dependency>
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-core</artifactId>
        <version>2.8.2</version>
    </dependency>

其次，声明测试代码：

public class log4j2Demo {

    private Logger logger = LogManager.getLogger(log4j2Demo.class);

    @Test
    public void test() throws InterruptedException {
        logger.error("Error Message!");
        logger.warn("Warn Message!");
        logger.info("Info Message!");
        logger.debug("Debug Message!");
        logger.trace("Trace Message!");
    }
}

最后，在classpath下声明配置文件：log4j2.xml:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="info" monitorInterval="30">
    <Appenders>
        <!--控制台-->
        <Console name="Console" target="SYSTEM_OUT">-->
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </Console>

        <!--普通文件：-->
        <File name="File" fileName="e:/log.out" append="true" immediateFlush="true" >
            <PatternLayout>
                <Pattern>%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %L- %msg%n</Pattern>
            </PatternLayout>
        </File>
    </Appenders>
    <Loggers>
        <Root level="debug" >
            <AppenderRef ref="File"/>
            <AppenderRef ref="Console"/>
        </Root>
    </Loggers>
</Configuration>

通过以上步骤，log4j2就可以正常的运行了。

1.4 log4j2配置文件详解

与log4j不同的是，log4j2只支持.xml或者.json格式的配置文件，不在支持.properties格式的配置文件。那么，下面我们就以.xml来进行讲解：

默认情况下，系统会在classpath下查找配置文件：（按照以下顺序）

1.classpath下名为 log4j-test.json 或者log4j-test.jsn文件
2.classpath下名为 log4j2-test.xml
3.classpath下名为 log4j.json 或者log4j.jsn文件
4.classpath下名为 log4j2.xml

请注意，此处我们常用的是log4j2.xml，这块与log4j不同；

以下是log4j2常用的配置信息：（逐一进行讲解）

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="info" monitorInterval="30">
    <Appenders>

        <!--控制台-->
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </Console>

        <!--普通文件：-->
        <File name="File" fileName="e:/log.out" append="true" immediateFlush="false" bufferedIO="true" bufferSize="1024">
            <PatternLayout>
                <Pattern>%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %L- %msg%n</Pattern>
            </PatternLayout>
        </File>

        <!--异步appender：-->
        <Async name="Async">
            <AppenderRef ref="File"/>
        </Async>

        <!--循环写入文件：-->
        <RollingFile name="RollingFile" fileName="e:/log.out" filePattern="e:/app-%d{yyyy-MM-dd_HH-mm}-%i.out">
            <PatternLayout>
                <Pattern>%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n</Pattern>
            </PatternLayout>
            <!--滚动策略：-->
            <Policies>
                <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
                <SizeBasedTriggeringPolicy size="100 kb"/>
            </Policies>
            <DefaultRolloverStrategy max="5"/>
        </RollingFile>

    </Appenders>

    <Loggers>

        <!--单独指定logger-->
        <Logger name="com.jiaboyan.logDemo.log4j2Demo" level="info" additivity="false" includeLocation="true">
            <AppenderRef ref="File"/>
        </Logger>

        <!--根logger-->
        <Root level="info" >
            <AppenderRef ref="Async"/>
            <AppenderRef ref="File"/>
            <AppenderRef ref="Console"/>
        </Root>

        <!--异步logger-->
        <AsyncRoot level="info">
            <AppenderRef ref="File"/>
        </AsyncRoot>
    </Loggers>

</Configuration>

1.Configuration -- 根节点

<Configuration status="debug" monitorInterval="30"></Configuration>
    Configuration：表示log4j2中的Configuration对象，实际为XmlConfiguration;

    status：表示log4j2本身的日志信息打印级别，当设置为TRACE 或者 DEBUG 级别时，便会打印出log4j2内部初始化的一些日志信息； 

    monitorInterval：表示每隔一定时间重新加载log4j2配置文件，单位秒；

2.Appenders -- Console

<Console name="Console" target="SYSTEM_OUT">
    <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>

name：表示控制台Appender的名称，<logger>中会依赖此名称，起名没有具体要求，但最好简明直译；

target：表示ConsoleAppender使用哪种方式将日志输出到控制台，一般调用System.out.println()方法；

PatternLayout--pattern：表示日志信息输出的格式；

3.Appenders -- File

<File name="File" fileName="e:/log.out" append="true" immediateFlush="false" bufferedIO="true" bufferSize="8096">
    <PatternLayout>
        <Pattern>%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %L- %msg%n</Pattern>
    </PatternLayout>
</File>

name：表示文件Appender的名称，<logger>中会依赖此名称，起名没有具体要求，但最好简明直译；

fileName：表示生成的日志文件名称；

append：表示新生成的日志是否追加到日志文件中，如果为true则表示追加，false表示覆盖原有日志信息；

immediateFlush：表示日志打印请求是否立即输出，true为立即，false表示使用缓存；

bufferedIO：表示日志打印请求是否使用缓存，true为使用，false为不使用；

bufferSize：表示日志打印请求的使用缓存的大小，默认为8096字节；

PatternLayout--pattern：同上；

4.Appenders -- RollingFile

<RollingFile name="RollingFile" fileName="e:/log.out" filePattern="e:/app-%d{yyyy-MM-dd_HH-mm}-%i.out">
    <PatternLayout>
        <Pattern>%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n</Pattern>
    </PatternLayout>
    <Policies>
        <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
        <CronTriggeringPolicy schedule="0 0 * * * ?"/>
        <SizeBasedTriggeringPolicy size="100 kb"/>
    </Policies>
    <DefaultRolloverStrategy max="5"/>
</RollingFile>

name：表示滚动文件Appender的名称，<logger>中会依赖此名称，起名没有具体要求，但最好简明直译；

fileName：表示当前日志所在的日志文件名称； 

filePattern：表示滚动日志的文件名称模板，当日志文件进行滚动后，滚动后的文件按照此模板进行命名；

PatternLayout--pattern：同上；

Policies：表示日志文件滚动策略；

Policies -- TimeBasedTriggeringPolicy：表示日志文件按照时间间隔来进行滚动；

Policies -- CronTriggeringPolicy：表示日志文件按照设置的时间点来进行滚动；

Policies -- SizeBasedTriggeringPolicy：表示日志文件按照文件大小来进行滚动；

DefaultRolloverStrategy：表示log4j2进行滚动后保存的日志文件数量，默认为7个；

5.TimeBasedTriggeringPolicy

<TimeBasedTriggeringPolicy interval="1" modulate="true"/>

TimeBasedTriggeringPolicy表示按照时间间隔来进行日志文件的滚动，间隔单位可以是分钟、小时，具体需要根据filePattern的格式来进行判别；
例如filePattern="e:/app-%d{yyyy-MM-dd_HH-mm}-%i.out"，则表示mm（分钟）为单位；

interval：表示分隔日志的时间间隔大小，如果时间间隔单位是分钟，则表示相隔1分钟、10分钟等进行一次日志分隔；

modulate：表示是否对分隔时间进行调制；如果设置为true则表示分隔的时间从每天的0点、每小时的0分钟开始进行计算，每间隔多久进行一次切割；比如，modulate=true，interval=4hours，那么假设上次封存日志的时间为03:00，则下次封存日志的时间为04:00，之后的封存时间依次为08:00，12:00，16:00。。。

6.CronTriggeringPolicy

<CronTriggeringPolicy schedule="0 0 * * * ?"/>

CronTriggeringPolicy表示按照Cron表达式设置的时间点进行切割日志；

schedule：表示设置的cron表达式；

7.SizeBasedTriggeringPolicy

<SizeBasedTriggeringPolicy size="100 kb"/> 

SizeBasedTriggeringPolicy表示按照规定的日志文件大小进行切割日志；

size：表示进行切割日志文件大小的极值，当日志文件大小满足size的值时，就会进行日志的切割；

DefaultRolloverStrategy

<DefaultRolloverStrategy max="5"/>

DefaultRolloverStrategy表示log4j2每单位时间内最多能保存多少个日志切割文件，一般与SizeBasedTriggeringPolicy结合使用；

max:表示保存的最大值，默认为7；

例如：你的log4j2.xml设置如下：fileName="e:/log.out" filePattern="e:/app-%d{yyyy-MM-dd_HH-mm}-%i.out"
那么在每分钟内，你可以保留2个日志切割文件，多余的日志进行覆盖；

8.Appenders -- Async

<Async name="Async">
    <AppenderRef ref="File"/>
</Async>

name：表示异步Appender的名称，<logger>中会依赖此名称，起名没有具体要求，但最好简明直译；
异步Appender使用消费者生产者模式进行日志信息的打印，适用于并发量较大的情况；

9.PatternLayout

<PatternLayout>
    <Pattern>%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n</Pattern>
</PatternLayout>

Pattern:设置输出的日志信息格式；具体格式如下：

%d{yyyy-MM-dd HH:mm:ss, SSS} : 日志生产时间
%t : 线程名称
%p : 日志级别
%level : 日志级别
%c : logger的名称
%logger : logger的名称
%C : Java类名
%m : 日志内容
%n : 换行符
%L : 日志输出所在行数
%M : 日志输出所在方法名

10.Loggers -- Logger

<Logger name="com.jiaboyan.logDemo.log4j2Demo" level="info" additivity="false">
    <AppenderRef ref="File"/>
</Logger>

在<Loggers>节点下，对某个类单独进行日志配置，便可使用<logger>节点；
上例中，我们对名称为com.jiaboyan.logDemo.log4j2Demo的类进行日志配置。
level指定级别，additivity表示是否向上传递打印日志信息（若为true则向上传递，那么root根对象也会进行日志打印）；

11.Loggers -- Root

<Root level="info" >
    <AppenderRef ref="Async"/>
    <AppenderRef ref="File"/>
    <AppenderRef ref="Console"/>
</Root>

Root根日志节点，指定具体的日志级别，以及使用何种Appender进行日志输出；

12.Loggers -- AsyncRoot

<AsyncRoot level="info" includeLocation="false">
    <AppenderRef ref="File"/>
</AsyncRoot>

如果想使用异步logger，还需要在pom.xml中添加disruptor的依赖。
includeLocation结合异步logger使用，当其设置为true时，才会显示具体的行号，以及日志所在的类名；
如果设置为false，哪怕<Pattern>设置了输出行号也不会显示出来；

参考：https://www.jianshu.com/p/474eaecac699

原文地址：https://www.cnblogs.com/caoweixiong/p/11273521.html

时间： 2024-10-09 09:38:47

Java日志体系 —— log4j2的相关文章

混乱的 Java 日志体系

混乱的 Java 日志体系 2016/09/10 | 分类: 基础技术 | 0 条评论 | 标签: LOG 分享到: 原文出处: xirong 一.困扰的疑惑 目前的日志框架有 jdk 自带的 logging,log4j1.log4j2.logback ,这些框架都自己定制了日志 API ,并且有相应的实现:目前用于实现日志统一的框架 Apache commons-logging.slf4j ,遵循「面向接口编程」的原则,这两大框架可以让用户在程序运行期间去选择具体的日志实现系统(log4j1\

Java 日志体系（二）jcl 和 slf4j

Java 日志体系(二)jcl 和 slf4j <java 日志体系(一)统一日志>:https://www.cnblogs.com/binarylei/p/9828166.html <Java 日志体系(二)jcl 和 slf4j>:https://www.cnblogs.com/binarylei/p/10781582.html 前面介绍了 jdk 自带的 logging.log4j1.log4j2.logback 等实际的日志框架.对于开发者而言,每种日志都有不同的写法.如果

Java日志体系居然这么复杂？——架构篇

摘自:https://www.cnblogs.com/xuningfans/p/12151851.html 本文是一个系列,欢迎关注 日志到底是何方神圣?为什么要使用日志框架? 想必大家都有过使用System.out来进行输出调试,开发开发环境下这样做当然很方便,但是线上这样做就有麻烦了: 系统一直运行,输出越来越多,磁盘空间逐渐被写满 不同的业务想要把日志输出在不同的位置 有些场合为了更高性能,尽量控制减少日志输出,需要动态调整日志输出量 自动输出日志相关信息,比如:日期.线程.方法名称等等

Java 日志体系

参考资料: 混乱的 Java 日志体系 Java常用日志框架介绍 Java常用的日志框架对比和深入分析

Java日志体系 —— logback

1.1 简介 师出同门,与log4j一样,logback也是由Ceki Gülcü开发的开源日志组件,可以说是log4j的改进版:在现如今的项目中,logback的出现次数越来越多,是目前主流首选的日志记录工具. 1.2 logback结构 logback分成三个模块:logback-core,logback- classic,logback-access. logback-core提供了logBack的核心功能,是另外两个组件的基础: logback-classic模块实现了SLF4J API

Java日志体系 —— slf4j

1.1 简介 与commons-logging相同,slf4j也是一个通用的日志接口,在程序中与其他日志框架结合使用,并对外提供服务. Simple Logging Facade for Java简称 slf4j,Java简单日志门面系统.在我们的代码中,不需要显式指定具体日志框架(例如:java.util.logging.logback.log4j),而是使用slf4j的API来记录日志便可,最终日志的格式.记录级别.输出方式等通过具体日志框架的配置来实现,因此可以在应用中灵活切换日志系统.

架构师必备，带你弄清混乱的JAVA日志体系

引言还在为弄不清 commons-logging-xx.jar . log4j-xx.jar . sl4j-api-xx.jar 等日志框架之间复杂的关系而感到烦恼吗? 还在为如何统一系统的日志输出而感到不知所措嘛? 您是否依然存在这样的烦恼.比如,要更改spring的日志输出为log4j 2,却不知该引哪些jar包,只知道去百度一下所谓的博客,照着人家复制,却无法弄懂其中的原理? 不要急,不要方!本文带你们弄懂其中的原理,只要你静下心看本文,你就能随心所欲更改你系统里的日志框架,统一日志输出!

Java日志体系（八）最佳实践

java常用日志框架关系 Log4j 2与Log4j 1发生了很大的变化,Log4j 2不兼容Log4j 1. Logback必须配合Slf4j使用.由于Logback和Slf4j是同一个作者,其兼容性不言而喻. 比较常用的组合使用方式是Slf4j与Logback组合使用,Commons Logging与Log4j组合使用. 项目中选择日志框架选择 如果是在一个新的项目中建议使用Slf4j与Logback组合,这样有如下的几个优点. Slf4j实现机制决定Slf4j限制较少,使用范围更广.由于S

Java日志体系 —— 日志框架切换

通过 SLF4J 统一日志 在实际的日志转换过程中,SLF4J其实是充当了一个中介的角色.例如当我们一个项目原来是使用LOG4J进行日志记录,但是我们要换成LogBack进行日志记录. 此时我们需要先将LOG4J转换成SLF4J日志系统,再从SLF4J日志系统转成LogBack日志系统. 从日志框架转向SLF4J jul-to-slf4j:jdk-logging到slf4j的桥梁 log4j-over-slf4j:log4j1到slf4j的桥梁 jcl-over-slf4j:commons-lo