一、日志概述

1.1、Spring Boot日志簡(jiǎn)介

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

1.2、日志框架與默認(rèn)配置

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

1.3、日志的核心作用

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

二、日志的使用

Spring Boot項(xiàng)目在啟動(dòng)時(shí)默認(rèn)有日志輸出

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

2.1、打印日志

2.1.1、獲取日志對(duì)象

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

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

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

2.1.2、使用日志對(duì)象打印日志

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

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

日志輸出效果：

2.2、日志格式的說明

日志輸出包含以下關(guān)鍵元素：

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

2.3、日志級(jí)別

我們?cè)诰帉懘a測(cè)試時(shí)，難免會(huì)出現(xiàn)錯(cuò)誤，當(dāng)出現(xiàn)錯(cuò)誤時(shí)，我們觀察日志信息：

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

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

2.3.1、日志級(jí)別的分類

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

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

2.3.2、日志級(jí)別的使用

Logger 對(duì)象針對(duì)不同級(jí)別提供了相應(yīng)的日志輸出方法

@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 ===============");
    }
}

結(jié)果顯示僅輸出了 info、warn 、error 和 debug 級(jí)別的日志，這是因?yàn)槲覀冊(cè)?properties 配置文件中配置了 logging.level.root=debug，因此才顯示出這四類日志，但日志級(jí)別配置默認(rèn)為 info，系統(tǒng)會(huì)輸出等于或高于該級(jí)別的日志信息

2.5、日志配置

2.5.1、配置日志級(jí)別

日志級(jí)別配置只需在配置文件中設(shè)置 "logging.level" 項(xiàng)即可，即可得出上文運(yùn)行結(jié)果，示例如下：

2.5.2、日志持久化

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

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

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

配置日志文件的保存路徑

該方法僅能設(shè)置日志的存儲(chǔ)路徑，默認(rèn)生成固定文件名的 spring.log，程序運(yùn)行時(shí)，會(huì)在指定路徑下自動(dòng)創(chuàng)建該日志文件

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

請(qǐng)注意：

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

2.6、Slf4j 注解

Lombok 的 @Slf4j 注解會(huì)自動(dòng)為我們生成一個(gè)日志對(duì)象 log，可以直接使用

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

查看控制臺(tái)輸出結(jié)果：

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

最新評(píng)論