日志的位置信息包含哪些？

• %C or $class：类名
• %F or %file：文件名
• %L or %line：打印日志的方法所在文件的行数
• %M or %method：打印日志的方法名
• %l or %location：包含以上的位置信息

打印日志位置有什么影响？

官方文档上强调了三遍，位置使用要慎用慎用。相比于不使用位置信息：

• 对于同步日志来说，速度要慢3~5倍
• 对于异步日志来说，速度要慢30~100倍

日志位置是怎么获取到的？

提示：includeLocation必须得设置为true

以AsyncLogger为例， 从处理日志事件开始看起：

• AsyncLoggerConfig

protected void callAppenders(final LogEvent event) {
    	//填充属性
        populateLazilyInitializedFields(event);
        ///把日志事件入队
        if (!delegate.tryEnqueue(event, this)) {
            handleQueueFull(event);
        }
    }
   
   private void populateLazilyInitializedFields(final LogEvent event) {
   		//这里
        event.getSource();
        event.getThreadName();
    }

• MutableLogEvent

public StackTraceElement getSource() {
        if (source != null) {
            return source;
        }
        //检查是否includeLocation为true
        if (loggerFqcn == null || !includeLocation) {
            return null;
        }
        //获取位置信息的步骤
        source = StackLocatorUtil.calcLocation(loggerFqcn);
        return source;
    }

• StackLocatorUtil

public static StackTraceElement calcLocation(final String fqcnOfLogger) {
        return stackLocator.calcLocation(fqcnOfLogger);
    }

• StackLocator

public StackTraceElement calcLocation(final String fqcnOfLogger) {
        if (fqcnOfLogger == null) {
            return null;
        }
        // LOG4J2-1029 new Throwable().getStackTrace is faster than Thread.currentThread().getStackTrace().
        //这个就是获取位置的真正方法了，通过创建一个异常来获取栈信息
        final StackTraceElement[] stackTrace = new Throwable().getStackTrace();
        StackTraceElement last = null;
        for (int i = stackTrace.length - 1; i > 0; i--) {
            final String className = stackTrace[i].getClassName();
            if (fqcnOfLogger.equals(className)) {
                return last;
            }
            last = stackTrace[i];
        }
        return null;
    }

• StackTraceElement: 我们想要的位置信息

public final class StackTraceElement implements java.io.Serializable {
    // Normally initialized by VM (public constructor added in 1.5)
    private String declaringClass;
    private String methodName;
    private String fileName;
    private int    lineNumber;
    //省略部分代码...
}

• Throwable

public StackTraceElement[] getStackTrace() {
        return getOurStackTrace().clone();
    }

    private synchronized StackTraceElement[] getOurStackTrace() {
        //初始化栈信息
        if (stackTrace == UNASSIGNED_STACK ||
            (stackTrace == null && backtrace != null) /* Out of protocol state */) {
            int depth = getStackTraceDepth();
            stackTrace = new StackTraceElement[depth];
            //填充栈信息
            for (int i=0; i < depth; i++)
                stackTrace[i] = getStackTraceElement(i);
        } else if (stackTrace == null) {
            return UNASSIGNED_STACK;
        }
        return stackTrace;
    }
 	
 	//每一层的栈信息是通过本地方法来调用的
 	native StackTraceElement getStackTraceElement(int index);

小结

日志位置以前是通过Thread.currentThread().getStackTrace()获取的， 在2.5版本之后，采用new Throwable().getStackTrace()的方式来获取，性能上有了一定的提升的。改动见jira, 里边有bench mark。