SpringBoot项目配置JSON日志格式输出

SpringBoot项目配置JSON日志格式输出

采用logstash-logback-encoder来实现JSON日志输出

引入依赖
implementation 'net.logstash.logback:logstash-logback-encoder:5.0'
compileOnly 'org.projectlombok:lombok'
compile group: 'org.codehaus.janino', name: 'janino', version: '3.1.0'
compile group: 'org.codehaus.janino', name: 'commons-compiler', version: '3.1.0'
创建日志配置文件logback-spring.xml
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false" scan="true" scanPeriod="600000">
    <!--定义日志文件的存储地址 勿在 LogBack 的配置中使用相对路径 -->
    <!--    <property name="LOG_HOME" value="/data/logs" />-->
    <property name="LOG_HOME" value="/data/logs" />
    <contextName>${HOSTNAME}</contextName>
    <springProperty scope="context" name="appName"
                    source="spring.application.name" />
    <springProperty scope="context" name="ip"
                    source="spring.cloud.client.ipAddress" />
    <property name="osName" value="${os.name}" />

    <!--格式化输出:%d表示日期,%thread表示线程名,%-5level:级别从左显示5个字符宽度%msg:日志消息,%n是换行符 -->
    <property name="CONSOLE_LOG_PATTERN"
              value="%d{yyyy-MM-dd HH:mm:ss.SSS} %highlight(%-5level) %line [%yellow(%X{X-B3-TraceId}),%green(%X{X-B3-SpanId})] [%yellow(%thread)] %green(%logger{30}) %msg%n" />

    <!-- 控制台输出 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
            <charset>utf-8</charset>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>debug</level>
        </filter>
    </appender>

    <if condition='p("osName").contains("Linux")'>
        <then>
            <!-- 按照每天生成日志文件 -->
            <appender name="FILE"
                      class="ch.qos.logback.core.rolling.RollingFileAppender">
                <!-- 正在记录的日志文件的路径及文件名 -->
                <file>${LOG_HOME}/${appName}.log</file>
                <rollingPolicy
                        class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
                    <!--日志文件输出的文件名 -->
                    <FileNamePattern>${LOG_HOME}/${appName}.%d{yyyy-MM-dd}.%i.log.gz</FileNamePattern>
                    <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                        <maxFileSize>1MB</maxFileSize>
                    </timeBasedFileNamingAndTriggeringPolicy>
                    <!-- 每个日志文件到100MB的时候开始切分,最多保留30天,但最大到20GB,哪怕没到30天也要删除多余的日志 -->
                    <MaxHistory>30</MaxHistory>
                    <maxFileSize>100MB</maxFileSize>
                    <totalSizeCap>20GB</totalSizeCap>
                </rollingPolicy>
                <encoder
                        class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder">
                    <providers>
                        <timestamp>
                            <timeZone>UTC</timeZone>
                        </timestamp>
                        <pattern>
                            <pattern>
                                {
                                "level": "%level",
                                "appName": "${appName}",
                                "requestId": "%X{requestId}",
                                "remoteIp": "%X{remoteIp}",
                                "traceId": "%X{X-B3-TraceId:-}",
                                "spanId": "%X{X-B3-SpanId:-}",
                                "parent": "%X{X-B3-ParentSpanId:-}",
                                "thread": "%thread",
                                "class": "%logger{40}",
                                "line": "%line",
                                "message": "%message",
                                "stack_trace": "%exception"
                                }
                            </pattern>
                        </pattern>
                        <stackTrace>
                            <throwableConverter class="net.logstash.logback.stacktrace.ShortenedThrowableConverter">
                                <maxDepthPerThrowable>100</maxDepthPerThrowable>
                                <maxLength>20480</maxLength>
                                <rootCauseFirst>true</rootCauseFirst>
                            </throwableConverter>
                        </stackTrace>
                    </providers>
                </encoder>
            </appender>
        </then>
    </if>

    <!-- 日志输出级别 -->
    <root level="INFO">
        <appender-ref ref="STDOUT" />

        <if condition='p("osName").contains("Linux")'>
            <then>
                <appender-ref ref="FILE" />
            </then>
        </if>
    </root>
</configuration>
  • LOG_HOME: 日志输出目录
  • appName:服务名称
  • osName:操作系统名称
  • CONSOLE_LOG_PATTERN:控制台日志输出格式
  • p(“osName”).contains(“Linux”):判断是否是linux系统,设置只有Linux系统下才输出JSON格式日志,本地开发一般都是windows或者Mac,所以可以按照操作系统来判断是否输出JSON日志
### 配置 Spring Boot 使用 Log4j2 输出 JSON 格式日志 为了使 Spring Boot 应用程序能够使用 Log4j2 并输出 JSON 格式日志,需执行几个关键步骤。 #### 添加依赖项 首先,在 `pom.xml` 文件中添加必要的 Maven 依赖项以支持 Log4j2: ```xml <dependencies> <!-- 排除默认的 spring-boot-starter-logging --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-logging</artifactId> </exclusion> </exclusions> </dependency> <!-- 引入 log4j2 的 starter --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-log4j2</artifactId> </dependency> <!-- Jackson-databind 是用于处理 JSON 日志格式的核心库 --> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> </dependency> </dependencies> ``` #### 创建 Log4j2 配置文件 接着,在项目的资源目录下创建名为 `log4j2-spring.json` 或者 `log4j2.xml` 的配置文件。这里提供一个基于 JSON 格式的例子: ```json { "configuration": { "status": "WARN", "appenders": { "Console": { "name": "ConsoleAppender", "target": "SYSTEM_OUT", "PatternLayout": { "pattern": "%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{36} - %msg%n" }, "JsonTemplateLayout": { "eventTemplateUri": "classpath:LogstashJsonEventLayoutV1.json" } } }, "loggers": { "root": { "appender-ref": [ { "ref": "ConsoleAppender", "level": "info" } ] } } } } ``` 此配置指定了控制台作为日志目的地,并设置了特定于应用程序的日志级别和模式布局。值得注意的是,通过指定 `JsonTemplateLayout` 和其对应的模板 URI 来实现 JSON 格式输出[^1]。 #### 自定义 JSON 模板 (可选) 如果希望进一步自定义 JSON 结构,则可以在 classpath 下放置一个 `.json` 文件,比如命名为 `LogstashJsonEventLayoutV1.json`,并在此文件内定义所需的字段映射关系。 例如,可以包含时间戳、线程名、日志消息等标准属性以及任何业务特有的元数据。 #### 启动类设置 确保在 Spring Boot 主启动类上加入适当注解以便加载外部化的配置属性: ```java @SpringBootApplication @EnableConfigurationProperties public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` 完成上述操作之后,当运行该 Spring Boot 应用时将会按照所设定的方式记录带有结构化信息的日志条目到终端或文件系统中去。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值