log4j到log4j2升级迁移方案

序：这段时间因为维护的项目存在大量日志打印，严重拖慢整体响应时间，在做性能优化的工作中对这块内容进行了升级换代，由以前的log4j升级为log4j2，以实现日志异步打印。接下来记录一下这个费时半个月的迁移踩过的坑！

相关操作步骤：

1. 在项目中移除log4j的依赖，并添加log4j2的相关依赖.(选择log4j2的版本时请留意，2.10.x之后的版本是基于java9的！如果有使用到某些特性，请考虑当前项目的jdk版本！)

    org.apache.logging.log4j
    log4j-web
    2.9.1



    org.apache.logging.log4j
    log4j-core
    2.9.1



    org.apache.logging.log4j
    log4j-api
    2.9.1

我最开始使用的2.11.2版本，因为jdk原因退回到2.9.1(请注意如果你的项目是通过jenkins构建，请将api,core包的依赖直接添加进来！)　　

2.修改项目中所有的报错！(这些都是jar包替换造成的！注意log4j2在实现方面与log4j是有区别的，常用的3个为：自定义appender，自定义日志等级，获取logger的方式)

自定义appender方式：

@Plugin(
        name = "CustomerAppender",
        category = "Core",
        elementType = "appender",
        printObject = true
)

public final class CustomerAppender extends AbstractOutputStreamAppender {


//TODO
//此部分为自定义内容    


}

　　

3.本文以maven依赖管理为例，查看dependencies树，确保项目中没有其他依赖的依赖引入log4j相关jar包

这个步骤自行解决～～举例如下：

   
            net.sourceforge.jexcelapi
            jxl
            2.6.12
            
                
                    log4j
                    log4j
                
            
        

　　

4.为步骤三中找到并移除的实现引入需要的桥接包！(此处注意大多数的项目中使用的 都是slf4j的框架,不同的版本使用Log4j2的实现需要的桥接包版本是不一样的！请仔细查看相关版本)

        
            org.slf4j
            jcl-over-slf4j
            x.x.x
        

        
            org.apache.logging.log4j
            log4j-slf4j-impl
            x.x.x
        

　　请根据实际需要修改对应版本，建议在maven repository中查询版本对应关系

 

5.根据原有log4j.xml的配置文件改造log4j2.xml(原来通过java定义的日志等级可以迁移到此处)

　　这里可以根据需要定义name，一级level,注意这个值与log4j定义的不太一样，具体请参考源码中的定义规则，我此处给的350在info等级以上

 

6.解决kafka日志推送问题.(log4j推送kafka一般是通过kafka-log4j-appender这个中间包去实现的,在lo4j2下需要更换推送方式,有内置的kafkaAppender，需要在依赖管理中根据需要推送的kafka服务端版本号添加对应的客户端版本号:kafka-clients)

        
            
            x.x.x.x:端口号,x.x.x.x:端口号
            2000
        

　　此处还可以设置ignoreException=false;这个时候需要去对异常做处理，可以获取异常信息.

需要添加的kafka-clients依赖如下(请修改具体版本):

        
            org.apache.kafka
            kafka-clients
            0.10.0.0
        

 

7.解决容器问题！这个并非所有的容器都需要（至少tomcat不需要。。）目前我们服务器端使用的为jboss。在对日志升级后有可能出现对应业务日志打印到jboss的server日志中！这肯定是不允许的！解决办法：在项目的WEB-INF或者META-INF目录下添加：jboss-deployment-structure.xml文件,注意此处放置的位置和文件名都必须是这个！这是jboos规定的。此文件的作用是可以管理jboss的相关依赖,可以在此处排除它的log4j2的实包

　　请根据项目实际需要做相关排除

8.解决因为包装自定义的logger导致的日志记录中不能正常记录logger打印位置的问题。（这个问题对于直接使用原生logger的项目不会有）在log4j2的api包下我们会发现没有提供可以传递FQCN的接口！所以此处我们需要直接引入core下的具体实现。在实现类中有log.logIfEnabled()方法，此方法允许传入(FQCN，level,maker,message).

import org.apache.logging.log4j.Level;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.Logger;

public abstract class AbstractABFrameLogger {

    /** 线程栈查找方法深度 */
    private final static int STACK_DEEP_SIZE = 2;


    /** log4j把传递进来的callerFQCN在堆栈中一一比较，相等后，再往上一层即认为是用户的调用类 */
    final static String FQCN = AbstractABFrameLogger.class.getName();

    protected Logger log;


    /**
     *
     * @param name name
     */
    public AbstractABFrameLogger(String name) {
        this.log = (Logger) LogManager.getLogger(name);
    }



    /**
     * 基本debug基本,封装打印信息
     * @param objLogInfo Object
     */
    public void debug(Object objLogInfo) {
        log.logIfEnabled(FQCN,Level.DEBUG,null,objLogInfo);
    }

}

　　

完成上述步骤后，整个log4j的升级工作也就差不多做完啦～恭喜