Log4j2 2.7版本配置：如何将Java堆栈跟踪合并为Kibana单文档

针对你遇到的异常堆栈跟踪被拆分为多个Elasticsearch文档、导致Kibana显示混乱的问题，结合你使用Log4j2.properties配置的场景，分两种核心场景给出解决方案：

场景1：直接使用Log4j2 Elasticsearch Appender写入ES #

若你是通过Log4j2官方的ElasticsearchAppender直接将日志写入Elasticsearch，需要在Elasticsearch Appender对应的布局中配置stacktraceAsString=true（而非仅配置ConsoleAppender）。

示例Log4j2.properties配置片段：

# 定义Elasticsearch Appender
appender.es.type = Elasticsearch
appender.es.name = ElasticsearchAppender
appender.es.layout.type = PatternLayout
# 日志格式模板，包含时间、线程、级别、类名和消息
appender.es.layout.pattern = %d{ISO8601} [%t] %-5level %logger{36} - %msg%n
# 关键配置：将完整堆栈跟踪合并为单个字符串，避免拆分
appender.es.layout.stacktraceAsString = true
# Elasticsearch连接配置（根据实际环境调整）
appender.es.hosts = http://localhost:9200
appender.es.index = application-logs-%d{yyyy-MM-dd}

# 关联Appender到Root Logger
rootLogger.level = INFO
rootLogger.appenderRef.es.ref = ElasticsearchAppender

如果使用JsonLayout（更适合结构化日志存储），同样支持该配置：

appender.es.layout.type = JsonLayout
appender.es.layout.stacktraceAsString = true
appender.es.layout.compact = false
appender.es.layout.includeStacktrace = true

场景2：通过ConsoleAppender + 采集工具（如Filebeat）写入ES #

若你是先将日志输出到控制台，再由采集工具（如Filebeat）同步到Elasticsearch，需要两步配置：

1. 确保ConsoleAppender正确合并堆栈跟踪 #

在Log4j2.properties中给ConsoleAppender的布局添加stacktraceAsString=true：

appender.console.type = Console
appender.console.name = STDOUT
appender.console.layout.type = PatternLayout
appender.console.layout.pattern = %d{ISO8601} [%t] %-5level %logger{36} - %msg%n
appender.console.layout.stacktraceAsString = true

rootLogger.level = INFO
rootLogger.appenderRef.console.ref = STDOUT

2. 配置采集工具的多行合并规则 #

以Filebeat为例，需要在配置文件中设置多行匹配规则，将堆栈跟踪的后续行合并到初始日志事件中：

filebeat.inputs:
- type: log
  paths:
    - /var/log/your-app/*.log
  # 匹配日志开头的时间戳格式（需和你的日志pattern对应）
  multiline.pattern: '^\d{4}-\d{2}-\d{2}'
  multiline.negate: true
  multiline.match: after

这样Filebeat会将堆栈跟踪的所有行合并为一个事件，再发送到Elasticsearch，Kibana中即可看到完整的单文档堆栈信息。

额外排查点 #

• 检查项目依赖，确保没有混合Log4j 1.x或其他冲突的日志框架依赖，避免配置不生效。
• 验证Log4j2配置是否正确加载：可以通过添加status = debug到Log4j2.properties开头，查看启动时的配置加载日志，确认stacktraceAsString参数已被正确解析。

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