日誌管理-log4j與slf4j的使用

時間 2020-01-03

標籤日誌管理 log4j log slf4j slf 使用欄目 Log4j 简体版

原文原文鏈接

1、概述

一、log4j：

Log4j是Apache的一個開源項目，經過使用Log4j，咱們能夠控制日誌信息輸送的目的地是控制檯、文件、GUI組件，甚至是套接口服務器、NT的事件記錄器、UNIX Syslog守護進程等；咱們也能夠控制每一條日誌的輸出格式；經過定義每一條日誌信息的級別，咱們可以更加細緻地控制日誌的生成過程。最使人感興趣的就是，這些能夠經過一個配置文件來靈活地進行配置，而不須要修改應用的代碼。java

二、slf4j：

SLF4J，即簡單日誌門面（Simple Logging Facade for Java），不是具體的日誌解決方案，它只服務於各類各樣的日誌系統。按照官方的說法，SLF4J是一個用於日誌系統的簡單Facade，容許最終用戶在部署其應用時使用其所但願的日誌系統。實際上，SLF4J所提供的核心API是一些接口以及一個LoggerFactory的工廠類。從某種程度上，SLF4J有點相似JDBC，不過比JDBC更簡單，在JDBC中，你須要指定驅動程序，而在使用SLF4J的時候，不須要在代碼中或配置文件中指定你打算使用那個具體的日誌系統。如同使用JDBC基本不用考慮具體數據庫同樣，SLF4J提供了統一的記錄日誌的接口，只要按照其提供的方法記錄便可，最終日誌的格式、記錄級別、輸出方式等經過具體日誌系統的配置來實現，所以能夠在應用中靈活切換日誌系統。程序員

2、實踐

一、導入對應的jar包,推薦使用maven工程導入。

　　a、使用傳統jar的方式引入web

　　b、使用maven工程導入數據庫

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.turtle</groupId>
  <artifactId>log</artifactId>
  <version>1.0-SNAPSHOT</version>

  <name>log</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <dependencies>

    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>

    <!-- https://mvnrepository.com/artifact/log4j/log4j -->
    <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.17</version>
    </dependency>

    <!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-api -->
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
      <version>1.7.25</version>
    </dependency>

    <!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-log4j12 -->
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.7.25</version>
    </dependency>

  </dependencies>

</project>

二、編寫測試代碼：

package com.turtle.log; import com.turtle.OutputStreamUtil; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.text.SimpleDateFormat; import java.util.Date; public class TestLog_01 { private final static Logger logger = LoggerFactory.getLogger(TestLog_01.class); public static void main(String[] args) { logger.info("programer processing......"); try{ // 會產生除以0的異常信息
            System.out.println(1/0); }catch (Exception e){ // 將異常信息打印到日誌文件中去
            String exception = new OutputStreamUtil().util(e); // 輸出日誌文件
            logger.error("Programer error:"+ exception+"\t"+"【"+new SimpleDateFormat("yyyy-MM-dd/HH.mm.ss").format(new Date())+"】"); } logger.debug("start Debug detail......"); } }

三、配置文件

### set log levels ###
log4j.rootLogger = DEBUG,stdout,D,E

# 配置日誌信息輸出目的地
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
# Target是輸出目的地的目標
log4j.appender.stdout.Target = System.out
# 指定日誌消息的輸出最低層次
log4j.appender.stdout.Threshold = INFO
# 定義名爲stdout的輸出端的layout類型
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
# 若是使用pattern佈局就要指定的打印信息的具體格式ConversionPattern
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss} %l%m%n



# 名字爲D的對應日誌處理
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
# File是輸出目的地的文件名
log4j.appender.D.File = LOG//app_debug.log
#false:默認值是true,即將消息增長到指定文件中，false指將消息覆蓋指定的文件內容
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.D.layout = org.apache.log4j.TTCCLayout



# 名字爲E的對應日誌處理
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File = LOG//app_error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

3、詳細解釋

一、og4j定義了8個級別的log（除去OFF和ALL，能夠說分爲6個級別）

優先級從高到低依次爲：OFF、FATAL、ERROR、WARN、INFO、DEBUG、TRACE、 ALL。apache

　　　　ALL LEVEL 最低等級的，用於打開全部日誌記錄。
　　　　TRACE 很低的日誌級別，通常不會使用。
　　　　DEBUG 指出細粒度信息事件對調試應用程序是很是有幫助的，主要用於開發過程當中打印一些運行信息。
　　　　INFO 消息在粗粒度級別上突出強調應用程序的運行過程。打印一些你感興趣的或者重要的信息，這個能夠用於生產環境中輸出程序運行的一些重要信息，可是不能濫用，避免打印過多的日誌。
　　　　WARN 代表會出現潛在錯誤的情形，有些信息不是錯誤信息，可是也要給程序員的一些提示。
　　　　ERROR 指出雖然發生錯誤事件，但仍然不影響系統的繼續運行。打印錯誤和異常信息，若是不想輸出太多的日誌，可使用這個級別。
　　　　FATAL 指出每一個嚴重的錯誤事件將會致使應用程序的退出。這個級別比較高了。重大錯誤，這種級別你能夠直接中止程序了。
　　　　OFF LEVEL 最高等級的，用於關閉全部日誌記錄。

　　若是將log level設置在某一個級別上，那麼比此級別優先級高的log都能打印出來。例如，若是設置優先級爲WARN，那麼OFF、FATAL、ERROR、WARN 4個級別的log能正常輸出，而INFO、DEBUG、TRACE、 ALL級別的log則會被忽略。Log4j建議只使用四個級別，優先級從高到低分別是ERROR、WARN、INFO、DEBUG。api

二、rootLogger = DEBUG,stdout,D,E #配置根logger，

基本格式爲 log4j.rootLogger = LEVEL, appenderName1 , appenderName2 ，只能有一個等級的哦，不能存在多個等級，不然會報錯服務器

三、log4j.appender.stdout=org.apache.log4j.ConsoleAppender #配置日誌信息輸出目的地Appender多線程

　　org.apache.log4j.ConsoleAppender（控制檯）
　　org.apache.log4j.FileAppender（文件）
　　org.apache.log4j.DailyRollingFileAppender（天天產生一個日誌文件）
　　org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產生一個新的文件）
　　org.apache.log4j.WriterAppender（將日誌信息以流格式發送到任意指定的地方）

四、Target , File 分別就是輸出目的地的目標、文件名啦。此處可將相應的內容寫到相應的目的地及文件中.

五、Append=false:默認值是true,即將消息增長到指定文件中，false指將消息覆蓋指定的文件內容。

六、Threshold=DEBUG:指定日誌消息的輸出最低層次。

　　應當注意每一個appender的級別應該是不一樣的，好比error類的單獨放到一個文件中，更方便咱們排除錯誤，因此推薦對不一樣級別的日誌輸出到不一樣的日誌文件中。app

七、當選擇RollingFileAppender時，MaxFileSize=100KB

　　後綴能夠是KB, MB 或者是 GB. 在日誌文件到達該大小時，將會自動滾動，即將原來的內容移到mylog.log.1文件。MaxBackupIndex=2:指定能夠產生的滾動文件的最大數。maven

八、log4j.appender.stdout.layout=org.apache.log4j.PatternLayout # 定義名爲stdout的輸出端的layout類型

　　org.apache.log4j.HTMLLayout（以HTML表格形式佈局）
　　org.apache.log4j.PatternLayout（能夠靈活地指定佈局模式）
　　org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串）
　　org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息）

九、log4j.appender.stdout.layout.ConversionPattern= [%-5p] %d{yyyy-MM-dd HH:mm:ss} %l%m%n

若是使用pattern佈局就要指定的打印信息的具體格式ConversionPattern，打印參數以下：

　　%p: 輸出日誌信息優先級，即DEBUG，INFO，WARN，ERROR，FATAL,
　　%r: 輸出自應用啓動到輸出該log信息耗費的毫秒數
　　%c: 輸出日誌信息所屬的類目，一般就是所在類的全名
　　%t: 輸出產生該日誌事件的線程名
　　%l: 輸出日誌事件的發生位置，至關於%C.%M(%F:%L)的組合,包括類目名、發生的線程，以及在代碼中的行數。舉例：Testlog4.main (TestLog4.Java:10)
　　%x: 輸出和當前線程相關聯的NDC(嵌套診斷環境),尤爲用到像Java servlets這樣的多客戶多線程的應用中。
　　%%: 輸出一個"%"字符
　　%F: 輸出日誌消息產生時所在的文件名稱
　　%L: 輸出代碼中的行號
　　%m: 輸出代碼中指定的消息,產生的日誌具體信息（注意下文log的使用時傳入的參數）
　　%n: 輸出一個回車換行符，Windows平臺爲"/r/n"，Unix平臺爲"/n"輸出日誌信息換行
　　%d: 輸出日誌時間點的日期或時間，默認格式爲ISO8601，也能夠在其後指定格式

　　能夠在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如：

　　%20c：指定輸出category的名稱，最小的寬度是20，若是category的名稱小於20的話，默認的狀況下右對齊。
　　%-20c:指定輸出category的名稱，最小的寬度是20，若是category的名稱小於20的話，"-"號指定左對齊。
　　%.30c:指定輸出category的名稱，最大的寬度是30，若是category的名稱大於30的話，就會將左邊多出的字符截掉，但小於30的話也不會有空格。
　　%20.30c:若是category的名稱小於20就補空格，而且右對齊，若是其名稱長於30字符，就從左邊較遠輸出的字符截掉。

4、案例：

運行對應的代碼，就能夠獲得對應的日誌，這是log4j與slf4j日誌系統的使用　　　　　　　　　

代碼：

package com.turtle.log;

import com.turtle.utils.ExceptionOutputStreamUtil;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.text.SimpleDateFormat;
import java.util.Date;

public class LogTest {

    private final static Logger logger = LoggerFactory.getLogger(LogTest.class);

    public static void main(String[] args) {
        logger.info("programer processing......");
        try{
            // 會產生除以0的異常信息
            System.out.println(1/0);
        }catch (Exception e){
            // 將異常信息打印到日誌文件中去
            String exception = ExceptionOutputStreamUtil.getTrace(e);
            // 輸出日誌文件
            logger.error("Programer error:"+ exception+"\t"+"【"+new SimpleDateFormat("yyyy-MM-dd/HH.mm.ss").format(new Date())+"】");
        }
        logger.debug("start Debug detail......");
    }
}

com.turtle.log.LogTest

package com.turtle.log1;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class LogTest {

    private final  static Logger logger = LoggerFactory.getLogger(LogTest.class);

    public static void main(String [] args){

        logger.info("com.turtle.log1.LogTest的Info級別日誌");
        logger.debug("com.turtle.log1.LogTest的Debug級別日誌");

    }
}

com.turtle.log1.LogTest

package com.turtle.log2;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class LogTest {

    private final  static Logger logger = LoggerFactory.getLogger(LogTest.class);

    public static void main(String [] args){

        logger.info("com.turtle.log2.LogTest的Info級別日誌");
        logger.debug("com.turtle.log2.LogTest的Debug級別日誌");

    }
}

com.turtle.log2.LogTest

package com.turtle.utils;

import java.io.PrintWriter;
import java.io.StringWriter;

public class ExceptionOutputStreamUtil {

    /**
     * 將傳入的具體錯誤信息轉換爲輸出流進行輸出
     * @param t
     * @return
     */
    public static String getTrace(Throwable t) {
        StringWriter stringWriter= new StringWriter();
        PrintWriter writer= new PrintWriter(stringWriter);
        t.printStackTrace(writer);
        writer.close();
        StringBuffer buffer= stringWriter.getBuffer();
        return buffer.toString();
    }
}

com.turtle.utils.ExceptionOutputStreamUtil

### set log levels ###
log4j.rootLogger = DEBUG,stdout,D,E

# 配置日誌信息輸出目的地
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
# Target是輸出目的地的目標
log4j.appender.stdout.Target = System.out
# 指定日誌消息的輸出最低層次
log4j.appender.stdout.Threshold = INFO
# 定義名爲stdout的輸出端的layout類型
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
# 若是使用pattern佈局就要指定的打印信息的具體格式ConversionPattern
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss} %l%m%n


# 名字爲D的對應日誌處理
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
# File是輸出目的地的文件名
log4j.appender.D.File = LOG//app_debug.log
#false:默認值是true,即將消息增長到指定文件中，false指將消息覆蓋指定的文件內容
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.D.layout = org.apache.log4j.TTCCLayout

# 名字爲E的對應日誌處理
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File = LOG//app_error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n



log4j.logger.com.turtle.log1 = DEBUG,A1
log4j.logger.com.turtle.log2 = ERROR,A2

log4j.appender.A1 = org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File = LOG//A1_app_debug.log
log4j.appender.A1.Append = true
log4j.appender.A1.Threshold = DEBUG
log4j.appender.A1.layout = org.apache.log4j.TTCCLayout

log4j.appender.A2 = org.apache.log4j.DailyRollingFileAppender
log4j.appender.A2.File = LOG//A2_app_error.log
log4j.appender.A2.Append = true
log4j.appender.A2.Threshold = ERROR
log4j.appender.A2.layout = org.apache.log4j.TTCCLayout

log4j.properties

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.turtle</groupId>
  <artifactId>log</artifactId>
  <version>1.0-SNAPSHOT</version>

  <name>log</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <dependencies>

    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>

    <!-- https://mvnrepository.com/artifact/log4j/log4j -->
    <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.17</version>
    </dependency>

    <!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-api -->
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
      <version>1.7.25</version>
    </dependency>

    <!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-log4j12 -->
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.7.25</version>
    </dependency>

  </dependencies>

</project>

pom.xml

5、總結：

日誌的關鍵配置包括輸出目標，信息等級，文件形式和格式控制，各個配置靈活調整，可在不一樣的文件中找到不一樣的有用的信息，格式控制中%c/%t/%l在一個龐大的項目中十分有用。有些配置文件本身總是會忘記，因此花點時間，把log4j與slf4j的使用進行一個彙總，總結一下，理出屬於本身的思路，方便後面的複習。

相關標籤/搜索

log4j+logback+slf4j+commons

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。