Spring Boot日志框架實踐

CASIO G-SHOCK

概述

Java應(yīng)用中，日志一般分為以下5個級別：

  • ERROR 錯誤信息
  • WARN 警告信息
  • INFO 一般信息
  • DEBUG 調(diào)試信息
  • TRACE 跟蹤信息

Spring Boot使用Apache的Commons Logging作為內(nèi)部的日志框架，其僅僅是一個日志接口，在實際應(yīng)用中需要為該接口來指定相應(yīng)的日志實現(xiàn)。

SpringBt默認(rèn)的日志實現(xiàn)是Java Util Logging，是JDK自帶的日志包，此外SpringBt當(dāng)然也支持Log4J、Logback這類很流行的日志實現(xiàn)。

統(tǒng)一將上面這些日志實現(xiàn)統(tǒng)稱為日志框架

下面我們來實踐一下！

注： 本文原載于 My Personal Blog：， CodeSheep · 程序羊 ！

使用Spring Boot Logging插件

  • 首先application.properties文件中加配置：
logging.level.root=INFO
  • 控制器部分代碼如下：
package com.hansonwang99.controller;

import com.hansonwang99.K8sresctrlApplication;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/testlogging")
public class LoggingTestController {
    private static Logger logger = LoggerFactory.getLogger(K8sresctrlApplication.class);
    @GetMapping("/hello")
    public String hello() {
        logger.info("test logging...");
        return "hello";
    }
}
  • 運行結(jié)果
運行結(jié)果

由于將日志等級設(shè)置為INFO，因此包含INFO及以上級別的日志信息都會打印出來

這里可以看出，很多大部分的INFO日志均來自于SpringBt框架本身，如果我們想屏蔽它們，可以將日志級別統(tǒng)一先全部設(shè)置為ERROR，這樣框架自身的INFO信息不會被打印。然后再將應(yīng)用中特定的包設(shè)置為DEBUG級別的日志，這樣就可以只看到所關(guān)心的包中的DEBUG及以上級別的日志了。

  • 控制特定包的日志級別

application.yml中改配置

logging:
  level:
    root: error
    com.hansonwang99.controller: debug

很明顯，將root日志級別設(shè)置為ERROR，然后再將com.hansonwang99.controller包的日志級別設(shè)為DEBUG，此即：即先禁止所有再允許個別的 設(shè)置方法

  • 控制器代碼
package com.hansonwang99.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/testlogging")
public class LoggingTestController {
    private Logger logger = LoggerFactory.getLogger(this.getClass());
    @GetMapping("/hello")
    public String hello() {
        logger.info("test logging...");
        return "hello";
    }
}
  • 運行結(jié)果
運行結(jié)果

可見框架自身的INFO級別日志全部藏匿，而指定包中的日志按級別順利地打印出來

  • 將日志輸出到某個文件中
logging:
  level:
    root: error
    com.hansonwang99.controller: debug
  file: ${user.home}/logs/hello.log
  • 運行結(jié)果
運行結(jié)果
運行結(jié)果

使用Spring Boot Logging，我們發(fā)現(xiàn)雖然日志已輸出到文件中，但控制臺中依然會打印一份，發(fā)現(xiàn)用org.slf4j.Logger是無法解決這個問題的

v運行結(jié)果

集成Log4J日志框架

  • pom.xml中添加依賴
       <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>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-log4j2</artifactId>
        </dependency>
  • 在resources目錄下添加log4j2.xml文件，內(nèi)容如下：
<?xml version="1.0" encoding="UTF-8"?>
<configuration>

    <appenders>
        <File name="file" fileName="${sys:user.home}/logs/hello2.log">
            <PatternLayout pattern="%d{HH:mm:ss,SSS} %p %c (%L) - %m%n"/>
        </File>
    </appenders>

    <loggers>

        <root level="ERROR">
            <appender-ref ref="file"/>
        </root>
        <logger name="com.hansonwang99.controller" level="DEBUG" />
    </loggers>

</configuration>
  • 其他代碼都保持不變

運行程序發(fā)現(xiàn)控制臺沒有日志輸出，而hello2.log文件中有內(nèi)容，這符合我們的預(yù)期：

運行結(jié)果
運行結(jié)果
運行結(jié)果

而且日志格式和pattern="%d{HH:mm:ss,SSS} %p %c (%L) - %m%n"格式中定義的相匹配

Log4J更進一步實踐

  • pom.xml配置：
        <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>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-log4j2</artifactId>
        </dependency>
  • log4j2.xml配置
<?xml version="1.0" encoding="UTF-8"?>
<configuration status="warn">
    <properties>

        <Property name="app_name">springboot-web</Property>
        <Property name="log_path">logs/${app_name}</Property>

    </properties>
    <appenders>
        <console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="[%d][%t][%p][%l] %m%n" />
        </console>

        <RollingFile name="RollingFileInfo" fileName="${log_path}/info.log"
                     filePattern="${log_path}/$${date:yyyy-MM}/info-%d{yyyy-MM-dd}-%i.log.gz">
            <Filters>
                <ThresholdFilter level="INFO" />
                <ThresholdFilter level="WARN" onMatch="DENY"
                                 onMismatch="NEUTRAL" />
            </Filters>
            <PatternLayout pattern="[%d][%t][%p][%c:%L] %m%n" />
            <Policies>
                <!-- 歸檔每天的文件 -->
                <TimeBasedTriggeringPolicy interval="1" modulate="true" />
                <!-- 限制單個文件大小 -->
                <SizeBasedTriggeringPolicy size="2 MB" />
            </Policies>
            <!-- 限制每天文件個數(shù) -->
            <DefaultRolloverStrategy compressionLevel="0" max="10"/>
        </RollingFile>

        <RollingFile name="RollingFileWarn" fileName="${log_path}/warn.log"
                     filePattern="${log_path}/$${date:yyyy-MM}/warn-%d{yyyy-MM-dd}-%i.log.gz">
            <Filters>
                <ThresholdFilter level="WARN" />
                <ThresholdFilter level="ERROR" onMatch="DENY"
                                 onMismatch="NEUTRAL" />
            </Filters>
            <PatternLayout pattern="[%d][%t][%p][%c:%L] %m%n" />
            <Policies>
                <!-- 歸檔每天的文件 -->
                <TimeBasedTriggeringPolicy interval="1" modulate="true" />
                <!-- 限制單個文件大小 -->
                <SizeBasedTriggeringPolicy size="2 MB" />
            </Policies>
            <!-- 限制每天文件個數(shù) -->
            <DefaultRolloverStrategy compressionLevel="0" max="10"/>
        </RollingFile>

        <RollingFile name="RollingFileError" fileName="${log_path}/error.log"
                     filePattern="${log_path}/$${date:yyyy-MM}/error-%d{yyyy-MM-dd}-%i.log.gz">
            <ThresholdFilter level="ERROR" />
            <PatternLayout pattern="[%d][%t][%p][%c:%L] %m%n" />
            <Policies>
                <!-- 歸檔每天的文件 -->
                <TimeBasedTriggeringPolicy interval="1" modulate="true" />
                <!-- 限制單個文件大小 -->
                <SizeBasedTriggeringPolicy size="2 MB" />
            </Policies>
            <!-- 限制每天文件個數(shù) -->
            <DefaultRolloverStrategy compressionLevel="0" max="10"/>
        </RollingFile>

    </appenders>

    <loggers>


        <root level="info">
            <appender-ref ref="Console" />
            <appender-ref ref="RollingFileInfo" />
            <appender-ref ref="RollingFileWarn" />
            <appender-ref ref="RollingFileError" />
        </root>

    </loggers>

</configuration>
  • 控制器代碼：
package com.hansonwang99.controller;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/testlogging")
public class LoggingTestController {
    private final Logger logger = LogManager.getLogger(this.getClass());
    @GetMapping("/hello")
    public String hello() {
        for(int i=0;i<10_0000;i++){
            logger.info("info execute index method");
            logger.warn("warn execute index method");
            logger.error("error execute index method");
        }
        return "My First SpringBoot Application";
    }
}
  • 運行結(jié)果
運行結(jié)果
運行結(jié)果
運行結(jié)果

日志會根據(jù)不同的級別存儲在不同的文件，當(dāng)日志文件大小超過2M以后會分多個文件壓縮存儲，生產(chǎn)環(huán)境的日志文件大小建議調(diào)整為20-50MB。

后記

由于能力有限，若有錯誤或者不當(dāng)之處，還請大家批評指正，一起學(xué)習(xí)交流！

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容