1. 程式人生 > >logback 配置解析

logback 配置解析

大小 coder top 命名 ${} imp amp 日誌級別 eap

http://www.cnblogs.com/cb0327/p/5759441.html

正文

回到頂部

1、根節點<configuration>包含的屬性

scan:

當此屬性設置為true時,配置文件如果發生改變,將會被重新加載,默認值為true。

scanPeriod:

設置監測配置文件是否有修改的時間間隔,如果沒有給出時間單位,默認單位是毫秒。當scan為true時,此屬性生效。默認的時間間隔為1分鐘。

debug:

當此屬性設置為true時,將打印出logback內部日誌信息,實時查看logback運行狀態。默認值為false。

例如:

 <configuration scan="true" scanPeriod="60 seconds" debug="false">  
      <!-- 其他配置省略-->  
</configuration>
回到頂部

2、根節點<configuration>的子節點

  技術分享

 2.1、設置上下文名稱:<contextName>

  1. 默認方式:<contextName>
    每個logger都關聯到logger上下文,默認上下文名稱為“default”。但可以使用<contextName>設置成其他名字,用於區分不同應用程序的記錄。一旦設置,不能修改。
     <configuration scan="true" scanPeriod="60 seconds" debug="false">  
          <contextName>myAppName</contextName>  
          <!-- 其他配置省略-->  
    </configuration>
  2. 設置變量: <property>
    用來定義變量值的標簽,<property> 有兩個屬性,name和value;其中name的值是變量的名稱,value的值時變量定義的值。通過<property>定義的值會被插入到logger上下文中。定義變量後,可以使“${}”來使用變量。
    例如使用<property>定義上下文名稱,然後在<contentName>設置logger上下文時使用。
     <configuration scan="true" scanPeriod="60 seconds" debug="false">  
          <property name="APP_Name" value="myAppName" />   
          <contextName>${APP_Name}</contextName>  
          <!-- 其他配置省略-->  
    </configuration>
  3. 獲取時間戳字符串:<timestamp>
    兩個屬性 key:標識此<timestamp> 的名字;datePattern:設置將當前時間(解析配置文件的時間)轉換為字符串的模式,遵循java.txt.SimpleDateFormat的格式。
    例如將解析配置文件的時間作為上下文名稱:
     <configuration scan="true" scanPeriod="60 seconds" debug="false">  
          <timestamp key="bySecond" datePattern="yyyyMMdd‘T‘HHmmss"/>   
          <contextName>${bySecond}</contextName>  
          <!-- 其他配置省略-->  
    </configuration>

 2.2、設置loger、root

  1. 設置loger
    用來設置某一個包或者具體的某一個類的日誌打印級別、以及指定<appender>。<loger>僅有一個name屬性,一個可選的level和一個可選的addtivity屬性。
    name:用來指定受此loger約束的某一個包或者具體的某一個類。
    level:用來設置打印級別,大小寫無關:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,還有一個特俗值INHERITED或者同義詞NULL,代表強制執行上級的級別。如果未設置此屬性,那麽當前loger將會繼承上級的級別。
    addtivity:是否向上級loger傳遞打印信息。默認是true。

    <loger>可以包含零個或多個<appender-ref>元素,標識這個appender將會添加到這個loger。
  2. 設置root
    也是<loger>元素,但是它是根loger。只有一個level屬性,應為已經被命名為"root".
    level:用來設置打印級別,大小寫無關:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,不能設置為INHERITED或者同義詞NULL。默認是DEBUG。

    <root>可以包含零個或多個<appender-ref>元素,標識這個appender將會添加到這個loger。
  3. 舉例說明-demo
    例如:LogbackDemo.java類
    技術分享
     package logback;  
      
    import org.slf4j.Logger;  
    import org.slf4j.LoggerFactory;  
      
    public class LogbackDemo {  
        private static Logger log = LoggerFactory.getLogger(LogbackDemo.class);  
        public static void main(String[] args) {  
            log.trace("======trace");  
            log.debug("======debug");  
            log.info("======info");  
            log.warn("======warn");  
            log.error("======error");  
        }  
    }
    技術分享

    logback.xml配置文件

    第1種:只配置root

    按 Ctrl+C 復制代碼 按 Ctrl+C 復制代碼

    其中appender的配置表示打印到控制臺(稍後詳細講解appender );
    <root level="INFO">將root的打印級別設置為“INFO”,指定了名字為“STDOUT”的appender。

    當執行logback.LogbackDemo類的main方法時,root將級別為“INFO”及大於“INFO”的日誌信息交給已經配置好的名為“STDOUT”的appender處理,“STDOUT”appender將信息打印到控制臺;
    打印結果如下:

    13:30:38.484 [main] INFO  logback.LogbackDemo - ======info  
    13:30:38.500 [main] WARN  logback.LogbackDemo - ======warn  
    13:30:38.500 [main] ERROR logback.LogbackDemo - ======error

    第2種:帶有loger的配置,不指定級別,不指定appender,

    技術分享
     <configuration>   
       
      <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">   
        <!-- encoder 默認配置為PatternLayoutEncoder -->   
        <encoder>   
          <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>   
        </encoder>   
      </appender>   
       
      <!-- logback為java中的包 -->   
      <logger name="logback"/>   
       
      <root level="DEBUG">             
        <appender-ref ref="STDOUT" />   
      </root>     
         
     </configuration>
    技術分享

    其中appender的配置表示打印到控制臺(稍後詳細講解appender );
    <logger name="logback" />將控制logback包下的所有類的日誌的打印,但是並沒用設置打印級別,所以繼承他的上級<root>的日誌級別“DEBUG”;
    沒有設置addtivity,默認為true,將此loger的打印信息向上級傳遞;
    沒有設置appender,此loger本身不打印任何信息。
    <root level="DEBUG">將root的打印級別設置為“DEBUG”,指定了名字為“STDOUT”的appender。

    當執行logback.LogbackDemo類的main方法時,因為LogbackDemo 在包logback中,所以首先執行<logger name="logback" />,將級別為“DEBUG”及大於“DEBUG”的日誌信息傳遞給root,本身並不打印;
    root接到下級傳遞的信息,交給已經配置好的名為“STDOUT”的appender處理,“STDOUT”appender將信息打印到控制臺;
    打印結果如下:

    13:19:15.406 [main] DEBUG logback.LogbackDemo - ======debug  
    13:19:15.406 [main] INFO  logback.LogbackDemo - ======info  
    13:19:15.406 [main] WARN  logback.LogbackDemo - ======warn  
    13:19:15.406 [main] ERROR logback.LogbackDemo - ======error

    第3種:帶有多個loger的配置,指定級別,指定appender

    技術分享
     <configuration>   
       <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">   
        <!-- encoder 默認配置為PatternLayoutEncoder -->   
        <encoder>   
          <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>   
        </encoder>   
      </appender>   
       
      <!-- logback為java中的包 -->   
      <logger name="logback"/>   
      <!--logback.LogbackDemo:類的全路徑 -->   
      <logger name="logback.LogbackDemo" level="INFO" additivity="false">  
        <appender-ref ref="STDOUT"/>  
      </logger>   
        
      <root level="DEBUG">             
        <appender-ref ref="STDOUT" />   
      </root>     
    </configuration>
    技術分享

    其中appender的配置表示打印到控制臺(稍後詳細講解appender );

    <logger name="logback" />將控制logback包下的所有類的日誌的打印,但是並沒用設置打印級別,所以繼承他的上級<root>的日誌級別“DEBUG”;
    沒有設置addtivity,默認為true,將此loger的打印信息向上級傳遞;
    沒有設置appender,此loger本身不打印任何信息。

    <logger name="logback.LogbackDemo" level="INFO" additivity="false">控制logback.LogbackDemo類的日誌打印,打印級別為“INFO”;

    additivity屬性為false,表示此loger的打印信息不再向上級傳遞,

    指定了名字為“STDOUT”的appender。

    <root level="DEBUG">將root的打印級別設置為“DEBUG”,指定了名字為“STDOUT”的appender。

    當執行logback.LogbackDemo類的main方法時,先執行<logger name="logback.LogbackDemo" level="INFO" additivity="false">,將級別為“INFO”及大於“INFO”的日誌信息交給此loger指定的名為“STDOUT”的appender處理,在控制臺中打出日誌,不再向次loger的上級 <logger name="logback"/> 傳遞打印信息;

    <logger name="logback"/>未接到任何打印信息,當然也不會給它的上級root傳遞任何打印信息;
    打印結果如下:

    14:05:35.937 [main] INFO  logback.LogbackDemo - ======info  
    14:05:35.937 [main] WARN  logback.LogbackDemo - ======warn  
    14:05:35.937 [main] ERROR logback.LogbackDemo - ======error

    如果將<logger name="logback.LogbackDemo" level="INFO" additivity="false">修改為 <logger name="logback.LogbackDemo" level="INFO" additivity="true">那打印結果將是什麽呢?
    沒錯,日誌打印了兩次,想必大家都知道原因了,因為打印信息向上級傳遞,logger本身打印一次,root接到後又打印一次
    打印結果如下:

    技術分享
    14:09:01.531 [main] INFO  logback.LogbackDemo - ======info  
    14:09:01.531 [main] INFO  logback.LogbackDemo - ======info  
    14:09:01.531 [main] WARN  logback.LogbackDemo - ======warn  
    14:09:01.531 [main] WARN  logback.LogbackDemo - ======warn  
    14:09:01.531 [main] ERROR logback.LogbackDemo - ======error  
    14:09:01.531 [main] ERROR logback.LogbackDemo - ======error
    技術分享

分類: logback

logback 配置解析