Log4j源代码学习

　　了解log4j的源代码来源于项目中一次需求，咱们想将系统全部的warn日志统一收集到common－warn.log的日志中去，以便于系统对其进行监控处理。因而模拟自动生成的error配置完成了warn的配置，可是测试发现common－warn.log中居然有error日志，并且业务的正常日志中居然也存在error和warn日志。这样至关于日志重复打了好多地方，无疑增长了日志量，同时增长了磁盘消耗。

原始配置：

 <appender name="DEFAULT-APPENDER" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="${log_root}/${sys_host_name}/app-service.log"/>
        <param name="append" value="true"/>
        <param name="encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"
                   value="%d [%X{loginUserEmail}/%X{loginUserID}/%X{remoteAddr}/%X{clientId} - %X{requestURIWithQueryString}] %-5p %c{2} - %m%n"/>
        </layout>
    </appender>

    <!-- [公共Appender] 汇总错误 -->
    <appender name="ERROR-APPENDER" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="${log_root}/${sys_host_name}/common-error.log"/>
        <param name="append" value="true"/>
        <param name="encoding" value="UTF-8"/>
        <param name="threshold" value="error"/>`
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"
                   value="%d [%X{loginUserEmail}/%X{loginUserID}/%X{remoteAddr}/%X{clientId} - %X{requestURIWithQueryString}] %-5p %c{2} - %m%n"/>
        </layout>
    </appender>

    <!-- [公共Appender] 汇总警告 -->
    <appender name="WARN-APPENDER" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="${log_root}/${sys_host_name}/common-warn.log"/>
        <param name="append" value="true"/>
        <param name="encoding" value="UTF-8"/>
        <param name="threshold" value="WARN"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"
                   value="%d [%X{loginUserEmail}/%X{loginUserID}/%X{remoteAddr}/%X{clientId} - %X{requestURIWithQueryString}] %-5p %c{2} - %m%n"/>
        </layout>
    </appender>

    <!-- [应用Logger]  - 默认 -->
    <logger name="APP-LOG" additivity="false">
        <level value="${log_level}"/>
        <appender-ref ref="DEFAULT-APPENDER"/>
        <appender-ref ref="WARN-APPENDER"/>
        <appender-ref ref="ERROR-APPENDER"/>
    </logger>

　　

因此个人核心诉求就是：将小于等于info的日志打印到app-service.log,将error打印到common-error.log, 将warn打印到common-warn.log。

1. Log4j核心类

     核心抽象：

• Logger 用于对日志记录行为的抽象，提供记录不一样级别日志的统一接口；
• Level对日志级别的抽象；
• Appender是对记录日志形式的抽象，标示了日志打印的目的地；
• Layout是对日志行格式的抽象；
• LoggingEvent是对一第二天志记录过程当中所须要的信息的抽象,能够理解成一个上下文；

　　整个日志打印的过程能够理解为Loger拿着LoggingEvent去找Appender， 让Appender按照Layout的形式将日志打印到指定的位置。 而Level起的啥做用呢？ Logger和Appender都是有原则的不能说你让我打印我就打印，必须知足个人规则我才给你打印，这里的规则就是指Level（出来混都是要讲原则的）。

核对类图：

 

 

2. 初始化过程

　　核心逻辑在LogManager的静态代码块，根据配置信息解析初始化Logger，Appender和Layout等核心组件；

     

 

 

3. 日志打印　　

　　核心的日志打印流程， 中间还有不少控制的细节，具体能够看源代码：

     

 

4. 日志控制

　　回到咱们的出发点，如何实现：
　　将小于等于info的日志打印到app-service.log,将error打印到common-error.log, 将warn打印到common-warn.log。

• 1. 重写Appender中2.5.2的方法（isAsSevereAsThreshold），自定义三个Appender的类，Appender1判断知足小于等于info的LoggingEvent才进行打印，目标指定为app-service.log；Appender2判断知足等于warn的LoggingEvent才进行打印,目标指定为common-warn.log；Appender3判断知足等于error的LoggingEvent才进行打印，目标指定为common-error.log；这样可以知足咱们的需求，可是这样就会存两个问题
  •  存在一个潜规则就是：开发在配置的时候必需要使用自定义的Appender才能够知足，若是某同窗使用默认的话，就可能存在日志打印错乱，影响监控；
  •  若是某个开发在Logger配置的时候忘记指定error的Appender，那么error日志将不会打印，存在日志丢失，风险很大；
• 2. 添加2.5.3中提到的Filter配置，进行Appender过滤。log4j支持DenyAllFilter，LevelMatchFilter，LevelRangeFilter，StringMatchFilter的配置。经过LevelRangeFilter能够指定该Appender支持的日志范围。该方案解决了上个方案a存在的问题，可是没法解决b可能存在的问题；
• 3. 重写Logger的日志打印的方法，在遍历Appender执行的时候，首先筛选出Level匹配（这里只相等）的Appender进行打印，若是没有匹配的Appender，再按照默认的策略进行打印。这样能够经过设置Appender的threshold便可实现，并且还能够防止Appender漏配置致使的日志缺失问题。该方案既能够兼容日志丢失，又能够知足咱们的需求，可是logger对象中的AppenderAttachableImpl存储Appdender的List ，Logger中直接存放的是实现类，没有提供可扩展的方式，好像不太好实现。 求大神指点。 

      目前项目中使用的方案为2， 同时app-service.log的Appender不配置Filter默认接受error和warn的日志， 可是warn和error经过Fileter进行区分不会相互影响，这样能够知足业务监控warn和error日志的需求，不须要修改任何代码，同时知足不会丢失日志的问题。可是存在error和warn日志重复打印的问题。 

 

最终的解决方案配置：

    <appender name="DEFAULT-APPENDER" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="${log_root}/${sys_host_name}/app-default.log"/>
        <param name="append" value="true"/>
        <param name="encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"
                   value="%d [%X{loginUserEmail}/%X{loginUserID}/%X{remoteAddr}/%X{clientId} - %X{requestURIWithQueryString}] %-5p %c{2} - %m%n"/>
        </layout>
    </appender>

    <!-- [公共Appender] 汇总错误 -->
    <appender name="ERROR-APPENDER" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="${log_root}/${sys_host_name}/common-error.log"/>
        <param name="append" value="true"/>
        <param name="encoding" value="UTF-8"/>
        <param name="threshold" value="error"/>`
        <!-- 仅打印error级别的日志 -->
        <filter class="org.apache.log4j.varia.LevelRangeFilter">
            <param name="levelMin" value="ERROR" />
            <param name="levelMax" value="ERROR"/>
            <param name="acceptOnMatch" value="true"/>
        </filter>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"
                   value="%d [%X{loginUserEmail}/%X{loginUserID}/%X{remoteAddr}/%X{clientId} - %X{requestURIWithQueryString}] %-5p %c{2} - %m%n"/>
        </layout>
    </appender>

    <!-- [公共Appender] 汇总警告 -->
    <appender name="WARN-APPENDER" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="${log_root}/${sys_host_name}/common-warn.log"/>
        <param name="append" value="true"/>
        <param name="encoding" value="UTF-8"/>
        <param name="threshold" value="WARN"/>
        <!-- 仅打印warn级别的日志 -->
        <filter class="org.apache.log4j.varia.LevelRangeFilter">
            <param name="levelMin" value="WARN" />
            <param name="levelMax" value="WARN"/>
            <param name="acceptOnMatch" value="true"/>
        </filter>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"
                   value="%d [%X{loginUserEmail}/%X{loginUserID}/%X{remoteAddr}/%X{clientId} - %X{requestURIWithQueryString}] %-5p %c{2} - %m%n"/>
        </layout>
    </appender>

    <!-- [应用Logger]  - 默认 -->
    <logger name="APP-LOG" additivity="false">
        <level value="${log_level}"/>
        <appender-ref ref="DEFAULT-APPENDER"/>
        <appender-ref ref="WARN-APPENDER"/>
        <appender-ref ref="ERROR-APPENDER"/>
    </logger>