如何在应用层将异常栈轨迹写入Logstash appender的stack-trace字段

核心逻辑是绕过日志框架默认把异常栈拼接到message字段的默认行为，在代码层主动将栈轨迹序列化为字符串，通过结构化日志能力写入独立字段，全程不需要修改Logstash侧的任何过滤规则。

注意：你当前代码中log.error("exception : {} ", e)的写法，会被所有主流日志框架识别为“需要打印异常栈”，自动把完整栈轨迹拼接到message字段末尾，这是栈信息混入message的根本原因。

第一步：通用异常栈转字符串工具方法 #

先写一个工具方法把Throwable对象的栈轨迹转成普通字符串，规避日志框架自动拼接逻辑：

import java.io.PrintWriter;
import java.io.StringWriter;

private String extractStackTrace(Throwable e) {
    StringWriter stringWriter = new StringWriter();
    e.printStackTrace(new PrintWriter(stringWriter, true));
    return stringWriter.toString();
}

第二步：按使用的日志框架写入结构化字段 #

场景1：Logback + Logstash Logback Encoder（绝大多数Spring Boot默认选型） #

直接通过Marker追加结构化字段即可，不要把异常对象作为日志方法的最后一个参数传入：

public void exceptionsCatcher(JoinPoint joinPoint, RuntimeException e) {
    String stackTraceContent = extractStackTrace(e);
    // message字段只保留异常消息，栈轨迹写入独立字段
    log.error(Markers.append("stack-trace", stackTraceContent),
        "exception: {}", e.getMessage());
    
    // 其余业务逻辑
}

对应的Logback配置只需要确保自定义Marker字段会被序列化输出即可，不需要加额外过滤规则，示例配置片段：

<appender name="LOGSTASH" class="net.logstash.logback.appender.LogstashTcpSocketAppender">
    <destination>你的logstash地址:端口</destination>
    <encoder class="net.logstash.logback.encoder.LogstashEncoder">
        <!-- 自动识别自定义Marker字段输出到JSON顶层 -->
    </encoder>
</appender>

场景2：Log4j2 #

通过MapMessage传递结构化字段即可：

public void exceptionsCatcher(JoinPoint joinPoint, RuntimeException e) {
    String stackTraceContent = extractStackTrace(e);
    log.error(MapMessage.of("stack-trace", stackTraceContent),
        "exception: {}", e.getMessage());
    
    // 其余业务逻辑
}

避坑说明 #

• 禁止将异常对象直接作为日志方法的最后一个参数传入，否则一定会触发日志框架的默认栈拼接逻辑，导致栈信息重新混入message字段。
• 最终输出到Logstash的日志会自带独立的stack-trace字段，不需要配置grok、dissect等过滤器做二次拆分。
• 如果需要更细粒度的检索能力，可以额外追加结构化字段，比如exception-class字段存储e.getClass().getName()，exception-root-cause存储根异常信息。

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