前言
java web 下有好幾種日誌框架,比如:logback,log4j,log4j2(slj4f 並不是一種日誌框架,它相當於定義了規範,實現了這個規範的日誌框架就能夠用 slj4f 呼叫)。其中效能最高的應該使 logback 了,而且 springboot 預設使用的也是 logback 日誌,所以本篇將會詳細的講解 logback 的日誌配置方案。
本篇主要內容如下:
- logback 配置檔案的構成
- 如何將日誌輸出到檔案
- 如何按時間,按大小切分日誌
- 如何將讓一個日誌檔案中只有一種日誌級別
- 如何將指定包下的日誌輸出到指定的日誌檔案中
簡單使用
如果無需複雜的日誌配置,執行簡單設定日誌列印級別,列印方式可直接再 application.yml 中配置。
預設情況下 Spring Boot 將 info 級別的日誌輸出到控制檯中,不會寫到日誌檔案,且不能進行復雜配置。
列印到檔案中
想要將日誌輸出到檔案中,可通過如下兩個配置:
logging:
# 配置輸出額日誌檔名,可以帶路徑
# file: out.log
# 配置日誌存放路徑,日誌檔名為:spring.log
path: ./log
file:
# 設定日誌檔案大小
max-size: 10MB
注意:file 和 path 是不能同時配置的,如果同時配置path
不會生效。
列印級別控制
可通過配置控制日誌列印級別,格式如下:
logging.level.*=TRACE/DEBUG/INFO/...
*可以為包名或 Logger 名,如下:
logging:
level:
# root日誌以WARN級別輸出
root: info
# 此包下所有class以DEBUG級別輸出
com.example.log_demo.log1: warn
logback 詳細配置
接下來說明如何通過獨立的 xml 配置檔案來配置日誌列印。雖然 springboot 是要消滅 xml 的,但是有些複雜功能還是得編寫 xml。使用 xml 後要將 application.yml 中的配置去掉,避免衝突.
根據不同的日誌系統,按照指定的規則組織配置檔名,並放在 resources 目錄下,就能自動被 spring boot 載入:
- Logback:logback-spring.xml, logback-spring.groovy, logback.xml, logback.groovy
- Log4j: log4j-spring.properties, log4j-spring.xml, log4j.properties, log4j.xml
- Log4j2: log4j2-spring.xml, log4j2.xml
- JDK (Java Util Logging): logging.properties
想要自定義檔名的可配置:logging.config
指定配置檔名:
logging.config=classpath:logging-config.xml
Spring Boot 官方推薦優先使用帶有 -spring 的檔名作為你的日誌配置(如使用 logback-spring.xml ,而不是 logback.xml ),命名為 logback-spring.xml 的日誌配置檔案, spring boot 可以為它新增一些 spring boot 特有的配置項(下面會提到)。
logback 配置檔案的組成
根節點<configuration>
有 5 個子節點,下面來進行一一介紹。
<root>
節點
root 節點是必選節點,用來指定最基礎的日誌輸出級別,只有一個 level 屬性,用於設定列印級別,可選如下:TRACE
,DEBUG
,INFO
,WARN
,ERROR
,ALL
,OFF
。
root 節點可以包含 0 個或多個元素,將appender
新增進來。如下:
<root level="debug">
<appender-ref ref="console" />
<appender-ref ref="file" />
</root>
appender 也是子節點之一,將會在後面說明。
<contextName>
節點
設定上下文名稱,預設為default
,可通過%contextName
來列印上下文名稱,一般不使用此屬性。
<property>
節點
用於定義變數,方便使用。有兩個屬性:name,value。定義變數後,可以使用${}
來使用變數。如下:
<property name="path" value="./log"/>
<property name="appname" value="app"/>
<appender>
節點
appender 用來格式化日誌輸出的節點,這個最重要。有兩個屬性:
- name:該本 appender 命名
- class:指定輸出策略,通常有兩種:控制檯輸出,檔案輸出
下面通過例子來說明這個怎麼用:
- 輸出到控制檯/按時間輸出日誌
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">
<!--設定儲存路徑變數-->
<property name="LOG_HOME" value="./log"/>
<!--控制檯輸出appender-->
<appender name="console" class="ch.qos.logback.core.ConsoleAppender">
<!--設定輸出格式-->
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
<!--格式化輸出:%d表示日期,%thread表示執行緒名,%-5level:級別從左顯示5個字元寬度%msg:日誌訊息,%n是換行符-->
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
<!--設定編碼-->
<charset>UTF-8</charset>
</encoder>
</appender>
<!--檔案輸出,時間視窗滾動-->
<appender name="timeFileOutput" class="ch.qos.logback.core.rolling.RollingFileAppender">
<!--日誌名,指定最新的檔名,其他檔名使用FileNamePattern -->
<File>${LOG_HOME}/timeFile/out.log</File>
<!--檔案滾動模式-->
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!--日誌檔案輸出的檔名,可設定檔案型別為gz,開啟檔案壓縮-->
<FileNamePattern>${LOG_HOME}/timeFile/info.%d{yyyy-MM-dd}.%i.log.gz</FileNamePattern>
<!--日誌檔案保留天數-->
<MaxHistory>30</MaxHistory>
<!--按大小分割同一天的-->
<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
<maxFileSize>10MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
</rollingPolicy>
<!--輸出格式-->
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
<!--格式化輸出:%d表示日期,%thread表示執行緒名,%-5level:級別從左顯示5個字元寬度%msg:日誌訊息,%n是換行符-->
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
<!--設定編碼-->
<charset>UTF-8</charset>
</encoder>
</appender>
<!--指定基礎的日誌輸出級別-->
<root level="INFO">
<!--appender將會新增到這個loger-->
<appender-ref ref="console"/>
<appender-ref ref="timeFileOutput"/>
</root>
</configuration>
- 設定只輸出單個級別
在 appender 中設定,filter 子節點,在預設級別上再此過濾,配置 onMatch,onMismatch 可實現只輸出單個級別
<appender ...>
<filter class="ch.qos.logback.classic.filter.LevelFilter">
<level>INFO</level>
<!--接受匹配-->
<onMatch>ACCEPT</onMatch>
<!--拒絕不匹配的-->
<onMismatch>DENY</onMismatch>
</filter>
</appender>
<logger>
節點
構成
此節點用來設定一個包或具體的某一個類的日誌列印級別、以及指定<appender>
,有以下三個屬性:
- name: 必須。用來指定受此 loger 約束的某個包或者某個具體的類
- level:可選。設定列印級別。預設為 root 的級別。
- addtivity: 可選。是否向上級 loger(也就是 root 節點)傳遞列印資訊。預設為 true。
使用示例如下:
- 不指定級別,不指定 appender
<!-- 控制com.example.service下類的列印,使用root的level和appender -->
<logger name="com.example.service"/>
2.指定級別,不指定 appender
<!-- 控制com.example.service下類的列印,使用root的appender列印warn級別日誌 -->
<logger name="com.example.service" level="WARN"/>
3.指定級別,指定 appender
<!-- 控制com.example.service下類的列印,使用console列印warn級別日誌 -->
<!-- 設定addtivity是因為這裡已經指定了appender,如果再向上傳遞就會被root下的appender再次列印 -->
<logger name="com.example.service" level="WARN" addtivity="false">
<appender-ref ref="console">
</logger>
通過指定 appender 就能將指定的包下的日誌列印到指定的檔案中。
多環境日誌輸出
通過設定檔名為-spring 結尾,可分環境配置 logger,示例如下:
<configuration>
<!-- 測試環境+開發環境. 多個使用逗號隔開. -->
<springProfile name="test,dev">
<logger name="com.example.demo.controller" level="DEBUG" additivity="false">
<appender-ref ref="console"/>
</logger>
</springProfile>
<!-- 生產環境. -->
<springProfile name="prod">
<logger name="com.example.demo" level="INFO" additivity="false">
<appender-ref ref="timeFileOutput"/>
</logger>
</springProfile>
</configuration>
通過配置spring.profiles.active
也能做到切換上面的 logger 列印設定
結束
日誌列印可以很複雜, 這裡只是說明了常用的 logback 配置,程式碼詳見:github