Spring Boot日志框架實踐

CASIO G-SHOCK

概述

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是無法解決這個問題的

v運行結果

集成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。


后記

由于能力有限尖奔,若有錯誤或者不當之處搭儒,還請大家批評指正,一起學習交流提茁!



最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末淹禾,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子茴扁,更是在濱河造成了極大的恐慌铃岔,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,126評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件峭火,死亡現(xiàn)場離奇詭異毁习,居然都是意外死亡,警方通過查閱死者的電腦和手機卖丸,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,254評論 2 382
  • 文/潘曉璐 我一進店門纺且,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人稍浆,你說我怎么就攤上這事载碌。” “怎么了衅枫?”我有些...
    開封第一講書人閱讀 152,445評論 0 341
  • 文/不壞的土叔 我叫張陵嫁艇,是天一觀的道長。 經(jīng)常有香客問我为鳄,道長裳仆,這世上最難降的妖魔是什么腕让? 我笑而不...
    開封第一講書人閱讀 55,185評論 1 278
  • 正文 為了忘掉前任孤钦,我火速辦了婚禮,結果婚禮上纯丸,老公的妹妹穿的比我還像新娘偏形。我一直安慰自己,他們只是感情好觉鼻,可當我...
    茶點故事閱讀 64,178評論 5 371
  • 文/花漫 我一把揭開白布俊扭。 她就那樣靜靜地躺著,像睡著了一般坠陈。 火紅的嫁衣襯著肌膚如雪萨惑。 梳的紋絲不亂的頭發(fā)上捐康,一...
    開封第一講書人閱讀 48,970評論 1 284
  • 那天,我揣著相機與錄音庸蔼,去河邊找鬼解总。 笑死,一個胖子當著我的面吹牛姐仅,可吹牛的內容都是我干的花枫。 我是一名探鬼主播,決...
    沈念sama閱讀 38,276評論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼掏膏,長吁一口氣:“原來是場噩夢啊……” “哼劳翰!你這毒婦竟也來了?” 一聲冷哼從身側響起馒疹,我...
    開封第一講書人閱讀 36,927評論 0 259
  • 序言:老撾萬榮一對情侶失蹤佳簸,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后行冰,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體溺蕉,經(jīng)...
    沈念sama閱讀 43,400評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 35,883評論 2 323
  • 正文 我和宋清朗相戀三年悼做,在試婚紗的時候發(fā)現(xiàn)自己被綠了疯特。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 37,997評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡肛走,死狀恐怖漓雅,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情朽色,我是刑警寧澤邻吞,帶...
    沈念sama閱讀 33,646評論 4 322
  • 正文 年R本政府宣布,位于F島的核電站葫男,受9級特大地震影響抱冷,放射性物質發(fā)生泄漏。R本人自食惡果不足惜梢褐,卻給世界環(huán)境...
    茶點故事閱讀 39,213評論 3 307
  • 文/蒙蒙 一旺遮、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧盈咳,春花似錦耿眉、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,204評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春筐骇,著一層夾襖步出監(jiān)牢的瞬間债鸡,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,423評論 1 260
  • 我被黑心中介騙來泰國打工铛纬, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留娘锁,地道東北人。 一個月前我還...
    沈念sama閱讀 45,423評論 2 352
  • 正文 我出身青樓饺鹃,卻偏偏與公主長得像莫秆,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子悔详,可洞房花燭夜當晚...
    茶點故事閱讀 42,722評論 2 345

推薦閱讀更多精彩內容