12.Spring-Boot中預設日誌配置
Spring Boot在所有內部日誌中使用Commons Logging,預設使用logbcak,但是預設配置也提供了對常用日誌的支援,如:Java Util Logging,Log4J, Log4J2和Logback。每種Logger都可以通過配置使用控制檯或者檔案輸出日誌內容。
格式化日誌
預設的日誌輸出如下:
2016-04-13 08:23:50.120 INFO 37397 --- [ main] org.hibernate.Version : HHH000412: Hibernate Core {4.3.11.Final} |
輸出內容元素具體如下:
- 時間日期 — 精確到毫秒
- 日誌級別 — ERROR, WARN, INFO, DEBUG or TRACE
- 程序ID
- 分隔符 — --- 標識實際日誌的開始
- 執行緒名 — 方括號括起來(可能會截斷控制檯輸出)
- Logger名 — 通常使用原始碼的類名
- 日誌內容
控制檯輸出
在Spring Boot中預設配置了ERROR、WARN和INFO級別的日誌輸出到控制檯。
我們可以通過兩種方式切換至DEBUG級別:
- 在執行命令後加入--debug標誌,如:$ java -jar myapp.jar --debug
- 在application.properties中配置debug=true,該屬性置為true的時候,核心Logger(包含嵌入式容器、hibernate、spring)會輸出更多內容,但是你自己應用的日誌並不會輸出為DEBUG級別。
多彩輸出
如果你的終端支援ANSI,設定彩色輸出會讓日誌更具可讀性。通過在application.properties中設定spring.output.ansi.enabled引數來支援。
- NEVER:禁用ANSI-colored輸出(預設項)
- DETECT:會檢查終端是否支援ANSI,是的話就採用彩色輸出(推薦項)
- ALWAYS:總是使用ANSI-colored格式輸出,若終端不支援的時候,會有很多幹擾資訊,不推薦使用
檔案輸出
Spring Boot預設配置只會輸出到控制檯,並不會記錄到檔案中,但是我們通常生產環境使用時都需要以檔案方式記錄。
若要增加檔案輸出,需要在application.properties中配置logging.file或logging.path屬性。
- logging.file,設定檔案,可以是絕對路徑,也可以是相對路徑。如:logging.file=my.log
- logging.path,設定目錄,會在該目錄下建立spring.log檔案,並寫入日誌內容,如:logging.path=/var/log
日誌檔案會在10Mb大小的時候被截斷,產生新的日誌檔案,預設級別為:ERROR、WARN、INFO
級別控制
在Spring Boot中只需要在application.properties中進行配置完成日誌記錄的級別控制。
配置格式:logging.level.*=LEVEL
- logging.level:日誌級別控制字首,*為包名或Logger名
- LEVEL:選項TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF
舉例:
- logging.level.com.niugang=DEBUG:com.niugang包下所有class以DEBUG級別輸出
- logging.level.root=WARN:root日誌以WARN級別輸出
自定義日誌配置
這樣springboot就會自動載入自定義配置的日誌檔案
這樣配置就不需要在application.properties進行額外的配置
#logging.config=classpath:logback-boot.xml
由於日誌服務一般都在ApplicationContext建立前就初始化了,它並不是必須通過Spring的配置檔案控制。因此通過系統屬性和傳統的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
Spring Boot官方推薦優先使用帶有-spring的檔名作為你的日誌配置(如使用logback-spring.xml,而不是logback.xml)
自定義輸出格式
在Spring Boot中可以通過在application.properties配置如下引數控制輸出格式:
- logging.pattern.console:定義輸出到控制檯的樣式(不支援JDK Logger)
- logging.pattern.file:定義輸出到檔案的樣式(不支援JDK Logger)Spring Boot在所有內部日誌中使用Commons Logging,但是預設配置也提供了對常用日誌的支援,如:Java Util Logging,Log4J, Log4J2和Logback。每種Logger都可以通過配置使用控制檯或者檔案輸出日誌內容。
微信公眾號:
JAVA程式猿成長之路
分享學習資源,學習方法,記錄程式設計師生活。