Log4j2 GelfLayout%M占位符不生效 无插件实现Gelf方法名字段输出

完全可以不依赖第三方插件，仅通过Log4j2原生能力实现调用方法名的独立字段输出，不需要引入额外日志依赖。

原配置失效的原因 #

你之前配置中method字段直接输出%M，是因为<KeyValuePair>标签的value属性默认按字面量文本存储，不会自动触发Pattern布局的占位符解析逻辑，所以%M会被当成普通字符串原样输出。

正确实现方式 #

使用Log4j2内置的PatternLookup机制，就可以在自定义字段中动态执行Pattern转换器的解析逻辑，同时需要配合开启调用方数据采集，才能拿到方法名这类依赖调用栈的信息，正确配置如下：

<Socket name="Graylog" protocol="udp" host="127.0.0.1" port="12201">
    <!-- 开启调用方数据采集，否则%M会解析为空 -->
    <GelfLayout includeCallerData="true" includeStacktrace="true">
        <!-- 通过双$$语法实现日志输出时的动态占位符解析 -->
        <KeyValuePair key="method" value="$${pattern:%M}"/>
    </GelfLayout>
</Socket>

关键注意事项 #

• 必须使用双美元符$$包裹Lookup表达式：如果写成单${pattern:%M}，Log4j2会在配置加载阶段就完成值解析，无法在每条日志输出时动态获取当前调用栈的方法名，最终会拿到空值。
• 必须开启includeCallerData：因为方法名、代码行号这类信息需要遍历完整调用栈才能获取，Log4j2为了性能默认不会主动采集这类数据，不开启的话哪怕表达式写对，也会输出空值。
• 实现具备通用性：所有Pattern支持的转换项（比如代码行号%L、线程名称%t、自定义MDC字段等）都可以通过同样的语法注入到Gelf自定义字段中。
• 性能提示：%M对应的调用栈遍历操作本身存在固定性能开销，如果对日志吞吐量要求较高，可以根据业务需要评估是否开启。

内容的提问来源于stack exchange，提问作者DavidZi