概述
Java應用中,日志一般分為以下5個級別:
- ERROR 錯誤信息
- WARN 警告信息
- INFO 一般信息
- DEBUG 調試信息
- TRACE 跟蹤信息
Spring Boot使用Apache的Commons Logging作為內部的日志框架,其僅僅是一個日志接口在辆,在實際應用中需要為該接口來指定相應的日志實現(xiàn)筒主。
SpringBt默認的日志實現(xiàn)是Java Util Logging椒振,是JDK自帶的日志包衔憨,此外SpringBt當然也支持Log4J胀滚、Logback這類很流行的日志實現(xiàn)余爆。
統(tǒng)一將上面這些日志實現(xiàn)統(tǒng)稱為日志框架
下面我們來實踐一下茴迁!
注: 本文原載于 My Personal Blog:, CodeSheep · 程序羊 灌闺!
使用Spring Boot Logging插件
- 首先application.properties文件中加配置:
logging.level.root=INFO
- 控制器部分代碼如下:
package com.hansonwang99.controller;
import com.hansonwang99.K8sresctrlApplication;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/testlogging")
public class LoggingTestController {
private static Logger logger = LoggerFactory.getLogger(K8sresctrlApplication.class);
@GetMapping("/hello")
public String hello() {
logger.info("test logging...");
return "hello";
}
}
- 運行結果
由于將日志等級設置為INFO艰争,因此包含INFO及以上級別的日志信息都會打印出來
這里可以看出,很多大部分的INFO日志均來自于SpringBt框架本身桂对,如果我們想屏蔽它們甩卓,可以將日志級別統(tǒng)一先全部設置為ERROR,這樣框架自身的INFO信息不會被打印蕉斜。然后再將應用中特定的包設置為DEBUG級別的日志逾柿,這樣就可以只看到所關心的包中的DEBUG及以上級別的日志了。
- 控制特定包的日志級別
application.yml中改配置
logging:
level:
root: error
com.hansonwang99.controller: debug
很明顯宅此,將root日志級別設置為ERROR机错,然后再將com.hansonwang99.controller
包的日志級別設為DEBUG,此即:即先禁止所有再允許個別的 設置方法
- 控制器代碼
package com.hansonwang99.controller;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/testlogging")
public class LoggingTestController {
private Logger logger = LoggerFactory.getLogger(this.getClass());
@GetMapping("/hello")
public String hello() {
logger.info("test logging...");
return "hello";
}
}
- 運行結果
可見框架自身的INFO級別日志全部藏匿父腕,而指定包中的日志按級別順利地打印出來
- 將日志輸出到某個文件中
logging:
level:
root: error
com.hansonwang99.controller: debug
file: ${user.home}/logs/hello.log
- 運行結果
使用Spring Boot Logging毡熏,我們發(fā)現(xiàn)雖然日志已輸出到文件中,但控制臺中依然會打印一份侣诵,發(fā)現(xiàn)用org.slf4j.Logger
是無法解決這個問題的
集成Log4J日志框架
- pom.xml中添加依賴
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>
- 在resources目錄下添加
log4j2.xml
文件痢法,內容如下:
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<appenders>
<File name="file" fileName="${sys:user.home}/logs/hello2.log">
<PatternLayout pattern="%d{HH:mm:ss,SSS} %p %c (%L) - %m%n"/>
</File>
</appenders>
<loggers>
<root level="ERROR">
<appender-ref ref="file"/>
</root>
<logger name="com.hansonwang99.controller" level="DEBUG" />
</loggers>
</configuration>
- 其他代碼都保持不變
運行程序發(fā)現(xiàn)控制臺沒有日志輸出狱窘,而hello2.log文件中有內容,這符合我們的預期:
而且日志格式和pattern="%d{HH:mm:ss,SSS} %p %c (%L) - %m%n"
格式中定義的相匹配
Log4J更進一步實踐
- pom.xml配置:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>
- log4j2.xml配置
<?xml version="1.0" encoding="UTF-8"?>
<configuration status="warn">
<properties>
<Property name="app_name">springboot-web</Property>
<Property name="log_path">logs/${app_name}</Property>
</properties>
<appenders>
<console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="[%d][%t][%p][%l] %m%n" />
</console>
<RollingFile name="RollingFileInfo" fileName="${log_path}/info.log"
filePattern="${log_path}/$${date:yyyy-MM}/info-%d{yyyy-MM-dd}-%i.log.gz">
<Filters>
<ThresholdFilter level="INFO" />
<ThresholdFilter level="WARN" onMatch="DENY"
onMismatch="NEUTRAL" />
</Filters>
<PatternLayout pattern="[%d][%t][%p][%c:%L] %m%n" />
<Policies>
<!-- 歸檔每天的文件 -->
<TimeBasedTriggeringPolicy interval="1" modulate="true" />
<!-- 限制單個文件大小 -->
<SizeBasedTriggeringPolicy size="2 MB" />
</Policies>
<!-- 限制每天文件個數(shù) -->
<DefaultRolloverStrategy compressionLevel="0" max="10"/>
</RollingFile>
<RollingFile name="RollingFileWarn" fileName="${log_path}/warn.log"
filePattern="${log_path}/$${date:yyyy-MM}/warn-%d{yyyy-MM-dd}-%i.log.gz">
<Filters>
<ThresholdFilter level="WARN" />
<ThresholdFilter level="ERROR" onMatch="DENY"
onMismatch="NEUTRAL" />
</Filters>
<PatternLayout pattern="[%d][%t][%p][%c:%L] %m%n" />
<Policies>
<!-- 歸檔每天的文件 -->
<TimeBasedTriggeringPolicy interval="1" modulate="true" />
<!-- 限制單個文件大小 -->
<SizeBasedTriggeringPolicy size="2 MB" />
</Policies>
<!-- 限制每天文件個數(shù) -->
<DefaultRolloverStrategy compressionLevel="0" max="10"/>
</RollingFile>
<RollingFile name="RollingFileError" fileName="${log_path}/error.log"
filePattern="${log_path}/$${date:yyyy-MM}/error-%d{yyyy-MM-dd}-%i.log.gz">
<ThresholdFilter level="ERROR" />
<PatternLayout pattern="[%d][%t][%p][%c:%L] %m%n" />
<Policies>
<!-- 歸檔每天的文件 -->
<TimeBasedTriggeringPolicy interval="1" modulate="true" />
<!-- 限制單個文件大小 -->
<SizeBasedTriggeringPolicy size="2 MB" />
</Policies>
<!-- 限制每天文件個數(shù) -->
<DefaultRolloverStrategy compressionLevel="0" max="10"/>
</RollingFile>
</appenders>
<loggers>
<root level="info">
<appender-ref ref="Console" />
<appender-ref ref="RollingFileInfo" />
<appender-ref ref="RollingFileWarn" />
<appender-ref ref="RollingFileError" />
</root>
</loggers>
</configuration>
- 控制器代碼:
package com.hansonwang99.controller;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/testlogging")
public class LoggingTestController {
private final Logger logger = LogManager.getLogger(this.getClass());
@GetMapping("/hello")
public String hello() {
for(int i=0;i<10_0000;i++){
logger.info("info execute index method");
logger.warn("warn execute index method");
logger.error("error execute index method");
}
return "My First SpringBoot Application";
}
}
- 運行結果
日志會根據(jù)不同的級別存儲在不同的文件财搁,當日志文件大小超過2M以后會分多個文件壓縮存儲蘸炸,生產(chǎn)環(huán)境的日志文件大小建議調整為20-50MB。
后記
由于能力有限尖奔,若有錯誤或者不當之處搭儒,還請大家批評指正,一起學習交流提茁!