一、日志概述

1.1、Spring Boot日志簡介

Spring Boot 作為Java生態(tài)中廣泛使用的框架，提供了強大的日志功能，幫助開發(fā)者高效記錄和追蹤應用運行狀態(tài)。日志系統(tǒng)在調(diào)試、監(jiān)控和問題排查中扮演著關鍵角色，而 Spring Boot 默認集成了流行的日志框架（如Logback、Log4j2），并支持靈活的配置方式

1.2、日志框架與默認配置

Spring Boot默認采用 Logback 作為日志實現(xiàn)，通過 pring-boot-starter-logging 依賴自動引入。開發(fā)者無需額外配置即可使用基礎的日志功能，如控制臺輸出和文件記錄。日志級別（如INFO、DEBUG、ERROR）可通過配置文件（application.properties或application.yml）動態(tài)調(diào)整

1.3、日志的核心作用

• 問題診斷：通過日志快速定位異常或性能瓶頸
• 行為追蹤：記錄關鍵業(yè)務流程，便于審計和分析
• 性能監(jiān)控：結合日志聚合工具（如ELK、Graylog）實現(xiàn)實時監(jiān)控

二、日志的使用

Spring Boot項目在啟動時默認有日志輸出

顯而易見，日志輸出的內(nèi)容與我們使用 System.out.println() 輸出的格式不一樣，我們輸出的內(nèi)容相比日志缺少了很多內(nèi)容

2.1、打印日志

2.1.1、獲取日志對象

程序中獲取日志對象需要使用日志工廠 LoggerFactory，代碼如下：

@Controller
public class LoggerController {
    private Logger logger= LoggerFactory.getLogger(LoggerController.class);
}

LoggerFactory.getLogger() 方法需要傳入一個參數(shù)來標識日志名稱，這樣可以明確日志來源的類名，便于在出現(xiàn)錯誤時快速定位問題。

2.1.2、使用日志對象打印日志

下面我們使用 info() 方法來輸出日志：

@Controller
public class LoggerController {
    private Logger  logger = LoggerFactory.getLogger(LoggerController.class);
    @PostConstruct
    public void loggerTest(){
        logger.info("凡王之血，必以劍終");
    }
}

日志輸出效果：

2.2、日志格式的說明

日志輸出包含以下關鍵元素：

1. 時間戳（精確到毫秒級）
2. 日志級別（ERROR /WARN / INFO / DEBUG / TRACE）
3. 進程ID
4. 應用名稱
5. 線程名稱
6. Logger名稱（通常對應源代碼的類名）
7. 日志正文內(nèi)容

2.3、日志級別

我們在編寫代碼測試時，難免會出現(xiàn)錯誤，當出現(xiàn)錯誤時，我們觀察日志信息：

發(fā)現(xiàn)控制臺有不同的日志級別，那么日志級別是用來干什么的呢？

答：通過設置日志級別，可以篩選出我們所需的信息。例如，若僅需關注 error 級別的日志，系統(tǒng)就會自動過濾出相關記錄，從而節(jié)省開發(fā)者篩選信息的時間

2.3.1、日志級別的分類

日志級別從高到低依次為：FATAL、ERROR、WARN、INFO、DEBUG、TRACE

• FATAL：致命錯誤，表示需要立即處理的系統(tǒng)級嚴重問題
• ERROR：錯誤信息，記錄較高級別的錯誤，但不會影響系統(tǒng)繼續(xù)運行
• WARN：警告信息，表示可能存在但不影響系統(tǒng)使用的問題
• INFO：常規(guī)信息，記錄應用程序正常運行時的狀態(tài)（如系統(tǒng)啟動完成、請求處理完畢等）
• DEBUG：調(diào)試信息，用于開發(fā)和排查問題時輸出關鍵數(shù)據(jù)
• TRACE：追蹤信息，提供比DEBUG更細粒度的日志記錄（若無特殊需求，建議使用DEBUG級別）

2.3.2、日志級別的使用

Logger 對象針對不同級別提供了相應的日志輸出方法

@Controller
public class LoggerController {
    private Logger  logger = LoggerFactory.getLogger(LoggerController.class);
    @PostConstruct
    public void loggerTest(){
        logger.trace("================= trace ===============");
        logger.debug("================= debug ===============");
        logger.info("================= info ===============");
        logger.warn("================= warn ===============");
        logger.error("================= error ===============");
    }
}

結果顯示僅輸出了 info、warn 、error 和 debug 級別的日志，這是因為我們在 properties 配置文件中配置了 logging.level.root=debug，因此才顯示出這四類日志，但日志級別配置默認為 info，系統(tǒng)會輸出等于或高于該級別的日志信息

2.5、日志配置

2.5.1、配置日志級別

日志級別配置只需在配置文件中設置 "logging.level" 項即可，即可得出上文運行結果，示例如下：

2.5.2、日志持久化

以上的日志都是輸出在控制臺上的，但在實際應用中，控制臺輸出的日志需要被保存下來以便后續(xù)問題排查，這種將日志存儲起來的過程稱為日志持久化

配置日志文件的路徑和文件名

運行后，發(fā)現(xiàn) logger 目錄下自動創(chuàng)建了 springboot.log 文件，文件中也保存了運行的日志信息：

配置日志文件的保存路徑

該方法僅能設置日志的存儲路徑，默認生成固定文件名的 spring.log，程序運行時，會在指定路徑下自動創(chuàng)建該日志文件

我們使用記事本打開觀察：可見剛剛程序運行的日志信息都存儲到該文件中

請注意：

當同時配置 logging.file.name 和 logging.file.path 時，僅其中一個配置會生效，系統(tǒng)會優(yōu)先采用 logging.file.name 的設置

2.6、Slf4j 注解

Lombok 的 @Slf4j 注解會自動為我們生成一個日志對象 log，可以直接使用

@Slf4j
@Controller
public class LoggerController {
    @PostConstruct
    public void loggerTest(){
       log.info("---------------注解生成日志對象");
    }
}

查看控制臺輸出結果：

到此這篇關于Spring Boot集成/輸出/日志級別控制/持久化開發(fā)實踐的文章就介紹到這了,更多相關Spring Boot日志級別內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論