當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

(二)：集成日志框架：springboot使用logback日志框架

發(fā)布時間：2024/10/5 编程问答 33 豆豆

生活随笔收集整理的這篇文章主要介紹了 (二)：集成日志框架：springboot使用logback日志框架小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.

前言

? ? ? ?項目中日志系統(tǒng)是必不可少的，目前比較流行的日志框架有l(wèi)og4j、logback等，可能大家還不知道，這兩個框架的作者是同一個人，Logback旨在作為流行的log4j項目的后續(xù)版本，從而恢復log4j離開的位置。另外 slf4j(Simple Logging Facade for Java) 則是一個日志門面框架，提供了日志系統(tǒng)中常用的接口，logback 和 log4j 則對slf4j 進行了實現(xiàn)。我們本文將講述如何在spring boot 中應(yīng)用 logback+slf4j實現(xiàn)日志的記錄。

為什么使用logback

Logback 是log4j 框架的作者開發(fā)的新一代日志框架，它效率更高、能夠適應(yīng)諸多的運行環(huán)境，同時天然支持SLF4J
Logback的定制性更加靈活，同時也是spring boot的內(nèi)置日志框架

開始使用

一：添加依賴：maven依賴中添加了spring-boot-starter-logging

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-logging</artifactId> </dependency>

但是呢，實際開發(fā)中我們不需要直接添加該依賴，你會發(fā)現(xiàn)spring-boot-starter其中包含了 spring-boot-starter-logging，該依賴內(nèi)容就是 Spring Boot 默認的日志框架 Logback+SLF4J。而 spring-boot-starter-web 包含了spring-boot-starte，所以我們只需要引入web組件即可：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId> </dependency>

二：默認配置：默認情況下Spring Boot將日志輸出到控制臺，不會寫到日志文件。如果要編寫除控制臺輸出之外的日志文件，則需在application.properties中設(shè)置logging.file或logging.path屬性

注：二者不能同時使用，如若同時使用，則只有l(wèi)ogging.file生效 logging.file=文件名 logging.path=日志文件路徑logging.level.包名=指定包下的日志級別 logging.pattern.console=日志打印規(guī)則

logging.file，設(shè)置文件，可以是絕對路徑，也可以是相對路徑。如：logging.file=my.log
logging.path，設(shè)置目錄，會在該目錄下創(chuàng)建spring.log文件，并寫入日志內(nèi)容，如：logging.path=/var/log

注：二者不能同時使用，如若同時使用，則只有l(wèi)ogging.file生效，可以看到這種方式配置簡單，但是能實現(xiàn)的功能也非常有限，如果想要更復雜的需求，就需要下面的定制化配置了。

三：logback-spring.xml詳解

Spring Boot官方推薦優(yōu)先使用帶有-spring的文件名作為你的日志配置（如使用logback-spring.xml，而不是logback.xml），命名為logback-spring.xml的日志配置文件，將xml放至 src/main/resource下面。

也可以使用自定義的名稱，比如logback-config.xml，只需要在application.properties文件中使用logging.config=classpath:logback-config.xml指定即可。

在講解 log'back-spring.xml之前我們先來了解三個單詞：Logger, Appenders and Layouts（記錄器、附加器、布局）：Logback基于三個主要類：Logger，Appender和Layout。這三種類型的組件協(xié)同工作，使開發(fā)人員能夠根據(jù)消息類型和級別記錄消息，并在運行時控制這些消息的格式以及報告的位置。首先給出一個基本的xml配置如下：

<configuration><appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><logger name="chapters.configuration" level="INFO"/><root level="DEBUG"> ? ? ? ? ?<appender-ref ref="STDOUT" /></root> ?</configuration>

3.1：<configuration>元素

logback.xml配置文件的基本結(jié)構(gòu)可以描述為<configuration>元素，包含零個或多個<appender>元素，后跟零個或多個<logger>元素，后跟最多一個<root>元素(也可以沒有)。下圖說明了這種基本結(jié)構(gòu)：

3.2：<logger>元素

<logger>元素只接受一個必需的name屬性，一個可選的level屬性和一個可選的additivity屬性，允許值為true或false。 level屬性的值允許一個不區(qū)分大小寫的字符串值TRACE，DEBUG，INFO，WARN，ERROR，ALL或OFF。特殊于大小寫不敏感的值INHERITED或其同義詞NULL將強制記錄器的級別從層次結(jié)構(gòu)中的較高級別繼承，<logger>元素可以包含零個或多個<appender-ref>元素; 這樣引用的每個appender都被添加到指定的logger中，(注：additivity屬性下面詳說)，logger元素級別具有繼承性。

例1：示例中，僅為根記錄器分配了級別。此級別值DEBUG由其他記錄器X，X.Y和X.Y.Z繼承

Logger nameAssigned levelEffective level

root	DEBUG	DEBUG
X	none	DEBUG
X.Y	none	DEBUG
X.Y.Z	none	DEBUG

例2：所有記錄器都有一個指定的級別值。級別繼承不起作用

Logger nameAssigned levelEffective level

root	ERROR	ERROR
X	INFO	INFO
X.Y	DEBUG	DEBUG
X.Y.Z	WARN	WARN

例3：記錄器root，X和X.Y.Z分別被分配了DEBUG，INFO和ERROR級別。 Logger X.Y從其父X繼承其級別值。

Logger nameAssigned levelEffective level

root	DEBUG	DEBUG
X	INFO	INFO
X.Y	none	INFO
X.Y.Z	ERROR	ERROR

例4：在示例4中，記錄器root和X分別被分配了DEBUG和INFO級別。記錄器X.Y和X.Y.Z從其最近的父X繼承其級別值，該父級具有指定的級別。

Logger nameAssigned levelEffective level

root	DEBUG	DEBUG
X	INFO	INFO
X.Y	none	INFO
X.Y.Z	none	INFO

3.3：<root>元素

<root>元素配置根記錄器。它支持單個屬性，即level屬性。它不允許任何其他屬性，因為additivity標志不適用于根記錄器。此外，由于根記錄器已被命名為“ROOT”，因此它也不允許使用name屬性。 level屬性的值可以是不區(qū)分大小寫的字符串TRACE，DEBUG，INFO，WARN，ERROR，ALL或OFF之一<root>元素可以包含零個或多個<appender-ref>元素; 這樣引用的每個appender都被添加到根記錄器中(注：additivity屬性下面詳說)。

3.4：<appender>元素

appender使用<appender>元素配置，該元素采用兩個必需屬性name和class。 name屬性指定appender的名稱，而class屬性指定要實例化的appender類的完全限定名稱。 <appender>元素可以包含零個或一個<layout>元素，零個或多個<encoder>元素以及零個或多個<filter>元素，下圖說明了常見的結(jié)構(gòu)：

重要：在logback中，輸出目標稱為appender，addAppender方法將appender添加到給定的記錄器logger。給定記錄器的每個啟用的日志記錄請求都將轉(zhuǎn)發(fā)到該記錄器中的所有appender以及層次結(jié)構(gòu)中較高的appender。換句話說，appender是從記錄器層次結(jié)構(gòu)中附加地繼承的。例如，如果將控制臺appender添加到根記錄器，則所有啟用的日志記錄請求將至少在控制臺上打印。如果另外將文件追加器添加到記錄器（例如L），則對L和L的子項啟用的記錄請求將打印在文件和控制臺上。通過將記錄器的additivity標志設(shè)置為false，可以覆蓋此默認行為，以便不再添加appender累積。

Appender是一個接口，它有許多子接口和實現(xiàn)類，具體如下圖所示：

其中最重要的兩個Appender為：ConsoleAppender 、RollingFileAppender。

3.4.1：ConsoleAppender

ConsoleAppender，如名稱所示，將日志輸出到控制臺上。

3.4.2：RollingFileAppender

RollingFileAppender，是FileAppender的一個子類，擴展了FileAppender，具有翻轉(zhuǎn)日志文件的功能。例如，RollingFileAppender 可以記錄到名為log.txt文件的文件，并且一旦滿足某個條件，就將其日志記錄目標更改為另一個文件。

有兩個與RollingFileAppender交互的重要子組件。第一個RollingFileAppender子組件，即 RollingPolicy 負責執(zhí)行翻轉(zhuǎn)所需的操作。 RollingFileAppender的第二個子組件，即 TriggeringPolicy 將確定是否以及何時發(fā)生翻轉(zhuǎn)。因此，RollingPolicy 負責什么和TriggeringPolicy 負責什么時候。

作為任何用途，RollingFileAppender 必須同時設(shè)置 RollingPolicy 和 TriggeringPolicy。但是，如果其 RollingPolicy 也實現(xiàn)了TriggeringPolicy 接口，則只需要顯式指定前者。

3.4.3：滾動策略

TimeBasedRollingPolicy：可能是最受歡迎的滾動策略。它根據(jù)時間定義翻轉(zhuǎn)策略，例如按天或按月。 TimeBasedRollingPolicy承擔滾動和觸發(fā)所述翻轉(zhuǎn)的責任。實際上，TimeBasedTriggeringPolicy實現(xiàn)了RollingPolicy和TriggeringPolicy接口。

SizeAndTimeBasedRollingPolicy：有時您可能希望按日期歸檔文件，但同時限制每個日志文件的大小，特別是如果后處理工具對日志文件施加大小限制。為了滿足此要求，logback 提供了 SizeAndTimeBasedRollingPolicy ，它是TimeBasedRollingPolicy的一個子類，實現(xiàn)了基于時間和日志文件大小的翻滾策略。

3.5：<encoder>元素

?encoder中最重要就是pattern屬性，它負責控制輸出日志的格式，這里給出一個我自己寫的示例：

<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %highlight(%-5level) --- [%15.15(%thread)] %cyan(%-40.40(%logger{40})) : %msg%n</pattern>

使用后的輸出格式如下圖所示

其中：%d{yyyy-MM-dd HH:mm:ss.SSS}：日期

? ? ? ? ? %-5level：日志級別

? ? ? ? ? %highlight()：顏色，info為藍色，warn為淺紅，error為加粗紅，debug為黑色

? ? ? ? ? %thread：打印日志的線程

? ? ? ? ? %15.15():如果記錄的線程字符長度小于15(第一個)則用空格在左側(cè)補齊,如果字符長度大于15(第二個),則從開頭開始截斷多余的字符?

? ? ? ? ? %logger：日志輸出的類名

? ? ? ? ? %-40.40()：如果記錄的logger字符長度小于40(第一個)則用空格在右側(cè)補齊,如果字符長度大于40(第二個),則從開頭開始截斷多余的字符

? ? ? ? ?%cyan：顏色

? ? ? ? ?%msg：日志輸出內(nèi)容

? ? ? ? ?%n：換行符

3.6：<filter>元素

filter中最重要的兩個過濾器為：LevelFilter、ThresholdFilter。

LevelFilter 根據(jù)精確的級別匹配過濾事件。如果事件的級別等于配置的級別，則篩選器接受或拒絕該事件，具體取決于onMatch和onMismatch屬性的配置。例如下面配置將只打印INFO級別的日志，其余的全部禁止打印輸出：

<configuration><appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"><filter class="ch.qos.logback.classic.filter.LevelFilter"><level>INFO</level><onMatch>ACCEPT</onMatch><onMismatch>DENY</onMismatch></filter><encoder><pattern>%-4relative [%thread] %-5level %logger{30} - %msg%n</pattern></encoder></appender><root level="DEBUG"><appender-ref ref="CONSOLE" /></root> </configuration>

ThresholdFilter 過濾低于指定閾值的事件。對于等于或高于閾值的事件，ThresholdFilter將在調(diào)用其decision（）方法時響應(yīng)NEUTRAL。但是，將拒絕級別低于閾值的事件，例如下面的配置將拒絕所有低于INFO級別的日志，只輸出INFO以及以上級別的日志：

<configuration><appender name="CONSOLE"class="ch.qos.logback.core.ConsoleAppender"><filter class="ch.qos.logback.classic.filter.ThresholdFilter"><level>INFO</level></filter><encoder><pattern>%-4relative [%thread] %-5level %logger{30} - %msg%n</pattern></encoder></appender><root level="DEBUG"><appender-ref ref="CONSOLE" /></root> </configuration>

四：詳細的logback-spring.xml示例：

以上介紹了xml中重要的幾個元素，下面將我配置的xml貼出來以供參考（實現(xiàn)了基于日期和大小翻滾的策略，以及經(jīng)INFO和ERROR日志區(qū)分輸出，還有規(guī)范日志輸出格式等）：

<?xml version="1.0" encoding="UTF-8"?> <configuration debug="true"><appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"><encoder>? ? ? ? ? ? <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %highlight(%-5level) --- [%15.15(%thread)] %cyan(%-40.40(%logger{40})) : %msg%n</pattern><charset>UTF-8</charset></encoder></appender><appender name="info_log" class="ch.qos.logback.core.rolling.RollingFileAppender"><File>logs/project_info.log</File><append>true</append><filter class="ch.qos.logback.classic.filter.LevelFilter"><level>ERROR</level><onMatch>DENY</onMatch><onMismatch>ACCEPT</onMismatch></filter><rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"><fileNamePattern>logs/project_info.%d.%i.log</fileNamePattern><maxHistory>30</maxHistory><totalSizeCap>20GB</totalSizeCap><maxFileSize>10MB</maxFileSize></rollingPolicy><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level --- [%15.15(%thread)] %-40.40(%logger{40}) : %msg%n</pattern><charset>UTF-8</charset></encoder></appender><appender name="error_log" class="ch.qos.logback.core.rolling.RollingFileAppender"><File>logs/project_error.log</File><append>true</append><filter class="ch.qos.logback.classic.filter.ThresholdFilter"><level>ERROR</level></filter><rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"><fileNamePattern>logs/project_error.%d.%i.log</fileNamePattern><maxHistory>30</maxHistory><totalSizeCap>20GB</totalSizeCap><maxFileSize>10MB</maxFileSize></rollingPolicy><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level --- [%15.15(%thread)] %-40.40(%logger{40}) : %msg%n</pattern><charset>UTF-8</charset></encoder></appender><root level="INFO"><appender-ref ref="STDOUT" /></root><logger name="com.sailing.springbootmybatis" level="INFO"><appender-ref ref="info_log" /><appender-ref ref="error_log" /></logger><logger name="com.sailing.springbootmybatis.mapper" level="DEBUG" additivity="false"><appender-ref ref="info_log" /><appender-ref ref="error_log" /></logger><logger name="com.atomikos" level="INFO" additivity="false"><appender-ref ref="info_log" /><appender-ref ref="error_log" /></logger></configuration>

五：附加內(nèi)容

5.1：這里再說下log日志輸出代碼，一般有人可能在代碼中使用如下方式輸出：

Object entry = new SomeObject();? logger.debug("The entry is " + entry);

5.2：上面看起來沒什么問題，但是會存在構(gòu)造消息參數(shù)的成本，即將entry轉(zhuǎn)換成字符串相加。并且無論是否記錄消息，都是如此，即：那怕日志級別為INFO，也會執(zhí)行括號里面的操作，但是日志不會輸出，下面是優(yōu)化后的寫法：

if(logger.isDebugEnabled()) {?Object entry = new SomeObject();?logger.debug("The entry is " + entry); }

5.3：5.2的寫法，首先對設(shè)置的日志級別進行了判斷，如果為debug模式，才進行參數(shù)的構(gòu)造，對第一種寫法進行了改善。不過還有最好的寫法，使用占位符：

Object entry = new SomeObject();? logger.debug("The entry is {}.", entry);

只有在評估是否記錄之后，并且只有在決策是肯定的情況下，記錄器實現(xiàn)才會格式化消息并將“{}”對替換為條目的字符串值。換句話說，當禁用日志語句時，此表單不會產(chǎn)生參數(shù)構(gòu)造的成本。

logback作者進行測試得出：第一種和第三種寫法將產(chǎn)生完全相同的輸出。但是，在禁用日志記錄語句的情況下，第三個變體將比第一個變體優(yōu)于至少30倍。

如果有多個參數(shù)，寫法如下：

logger.debug("The new entry is {}. It replaces {}.", entry, oldEntry); 如果需要傳遞三個或更多參數(shù)，則還可以使用Object []變體：Object[] paramArray = {newVal, below, above}; logger.debug("Value {} was inserted between {} and {}.", paramArray);

5.4：記錄日志的時候我們可能需要在文件中記錄下異常的堆棧信息，經(jīng)過測試，logger.error(e) 不會打印出堆棧信息，正確的寫法是：

logger.error("程序異常, 詳細信息:{}", e.getLocalizedMessage() , e);

完~

關(guān)于集成其實java school的有篇文章是很不錯的：

springboot配置集成log4jhttp://www.51gjie.com/javaweb/1104.html

總結(jié)

以上是生活随笔為你收集整理的(二)：集成日志框架：springboot使用logback日志框架的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。

上一篇： linux系统给jvm分配来多少内存
下一篇： HttpClient：绕开https证书