日誌-logback
參考:http://www.importnew.com/22290.html
一 概述
1.1 LogBack、Slf4j和Log4j之間的關系
1)Slf4j(The Simple Logging Facade for Java)是一個簡單日誌門面抽象框架本身只提供了日誌Facade API和一個簡單的日誌類實現,一般常配合Log4j,LogBack,java.util.logging使用;Slf4j作為應用層的Log接入時,程序可以根據實際應用場景動態調整底層的日誌實現框架(Log4j/LogBack/JdkLog…)。
2)LogBack是Log4j的改良版本詳;細數據可參照下面地址:Reasons to prefer logback over log4j
1.2 logback 結構
分為三個部分:logback-core,logback-classic,logback-access
logback-core:logback核心功能,其他兩部分基礎;
logback-classic:實現了slf4j接口,當想要配合slf4j使用需要將logback-classic加入classpath
logback-access:集成Servlet環境準備,可提供HTTP-acess日誌接口
二 配置詳解
2.1 根節點<configuration>包含的屬性
- scan:當此屬性設置為true時,配置文件如果發生改變,將會被重新加載,默認值為true.
- scanPeriod:設置監測配置文件是否有修改的時間間隔,如果沒有給出時間單位,默認單位是毫秒。當scan為true時,此屬性生效。默認的時間間隔為1分鐘.
- debug:當此屬性設置為true時,將打印出logback內部日誌信息,實時查看logback運行狀態。默認值為false。
XML代碼:
<configuration scan="true" scanPeriod="60 second" debug="false"> <!-- 其他配置省略--> </configuration>
2.2 根節點<configuration>的子節點appender, logger和root
<contextName>:每個logger都關聯到logger上下文,默認上下文名稱為“default”
<property>:類似定義一個變量
<configuration scan="true" scanPeriod="60 second" debug="false"> <property name="APP_Name" value="myAppName" /> <contextName>${APP_Name}</contextName> <!-- 其他配置省略--> </configuration>
<timestamp>:獲取時間戳字符串
<configuration scan="true" scanPeriod="60 second" debug="false"> <timestamp key="bySecond" datePattern="yyyyMMdd‘T‘HHmmss"/> <contextName>${bySecond}</contextName> <!-- 其他配置省略--> </configuration>
2.3 logger和root
logger設置某一個包或者具體的某一個類的日誌打印級別
root:它是根logger
appender配置
ConsoleAppender;FileAppender;RollingFIleAppender;TimeBasedRollingPolicy;FixedWindowRollingPolicy;SizeBasedTriggeringPolicy
三 案例介紹
例子中有詳細功能介紹
<?xml version="1.0" encoding="UTF-8"?> <!-- -scan:當此屬性設置為true時,配置文件如果發生改變,將會被重新加載,默認值為true -scanPeriod:設置監測配置文件是否有修改的時間間隔,如果沒有給出時間單位,默認單位是毫秒。 - 當scan為true時,此屬性生效。默認的時間間隔為1分鐘 -debug:當此屬性設置為true時,將打印出logback內部日誌信息,實時查看logback運行狀態。默認值為false。 - - configuration 子節點為 appender、logger、root --> <configuration scan="true" scanPeriod="60 second" debug="false"> <!-- 負責寫日誌,控制臺日誌 --> <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> <!-- 一是把日誌信息轉換成字節數組,二是把字節數組寫入到輸出流 --> <encoder> <Pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%5level] [%thread] %logger{0} %msg%n</Pattern> <charset>UTF-8</charset> </encoder> </appender> <!-- 文件日誌 --> <appender name="DEBUG" class="ch.qos.logback.core.FileAppender"> <file>debug.log</file> <!-- append: true,日誌被追加到文件結尾; false,清空現存文件;默認是true --> <append>true</append> <filter class="ch.qos.logback.classic.filter.LevelFilter"> <!-- LevelFilter: 級別過濾器,根據日誌級別進行過濾 --> <level>DEBUG</level> <onMatch>ACCEPT</onMatch> <onMismatch>DENY</onMismatch> </filter> <encoder> <Pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%5level] [%thread] %logger{0} %msg%n</Pattern> <charset>UTF-8</charset> </encoder> </appender> <!-- 滾動記錄文件,先將日誌記錄到指定文件,當符合某個條件時,將日誌記錄到其他文件 --> <appender name="INFO" class="ch.qos.logback.core.rolling.RollingFileAppender"> <File>info.log</File> <!-- ThresholdFilter:臨界值過濾器,過濾掉 TRACE 和 DEBUG 級別的日誌 --> <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> <level>INFO</level> </filter> <encoder> <Pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%5level] [%thread] %logger{0} %msg%n</Pattern> <charset>UTF-8</charset> </encoder> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <!-- 每天生成一個日誌文件,保存30天的日誌文件 - 如果隔一段時間沒有輸出日誌,前面過期的日誌不會被刪除,只有再重新打印日誌的時候,會觸發刪除過期日誌的操作。 --> <fileNamePattern>info.%d{yyyy-MM-dd}.log</fileNamePattern> <maxHistory>30</maxHistory> <TimeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP"> <maxFileSize>100MB</maxFileSize> </TimeBasedFileNamingAndTriggeringPolicy> </rollingPolicy> </appender > <!--<!– 異常日誌輸出 –>--> <!--<appender name="EXCEPTION" class="ch.qos.logback.core.rolling.RollingFileAppender">--> <!--<file>exception.log</file>--> <!--<!– 求值過濾器,評估、鑒別日誌是否符合指定條件. 需要額外的兩個JAR包,commons-compiler.jar和janino.jar –>--> <!--<filter class="ch.qos.logback.core.filter.EvaluatorFilter">--> <!--<!– 默認為 ch.qos.logback.classic.boolex.JaninoEventEvaluator –>--> <!--<evaluator>--> <!--<!– 過濾掉所有日誌消息中不包含"Exception"字符串的日誌 –>--> <!--<expression>return message.contains("Exception");</expression>--> <!--</evaluator>--> <!--<OnMatch>ACCEPT</OnMatch>--> <!--<OnMismatch>DENY</OnMismatch>--> <!--</filter>--> <!--<triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">--> <!--<!– 觸發節點,按固定文件大小生成,超過5M,生成新的日誌文件 –>--> <!--<maxFileSize>5MB</maxFileSize>--> <!--</triggeringPolicy>--> <!--</appender>--> <appender name="ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender"> <file>error.log</file> <encoder> <Pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%5level] [%thread] %logger{0} %msg%n</Pattern> <charset>UTF-8</charset> </encoder> <!-- 按照固定窗口模式生成日誌文件,當文件大於20MB時,生成新的日誌文件。 - 窗口大小是1到3,當保存了3個歸檔文件後,將覆蓋最早的日誌。 - 可以指定文件壓縮選項 --> <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy"> <fileNamePattern>error.%d{yyyy-MM}(%i).log.zip</fileNamePattern> <minIndex>1</minIndex> <maxIndex>3</maxIndex> <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP"> <maxFileSize>100MB</maxFileSize> </timeBasedFileNamingAndTriggeringPolicy> <maxHistory>30</maxHistory> </rollingPolicy> </appender> <!-- 異步輸出 --> <appender name ="ASYNC" class= "ch.qos.logback.classic.AsyncAppender"> <!-- 不丟失日誌.默認的,如果隊列的80%已滿,則會丟棄TRACT、DEBUG、INFO級別的日誌 --> <discardingThreshold >0</discardingThreshold> <!-- 更改默認的隊列的深度,該值會影響性能.默認值為256 --> <queueSize>512</queueSize> <!-- 添加附加的appender,最多只能添加一個 --> <appender-ref ref ="ERROR"/> </appender> <!-- - 1.name:包名或類名,用來指定受此logger約束的某一個包或者具體的某一個類 - 2.未設置打印級別,所以繼承他的上級<root>的日誌級別“DEBUG” - 3.未設置additivity,默認為true,將此logger的打印信息向上級傳遞; - 4.未設置appender,此logger本身不打印任何信息,級別為“DEBUG”及大於“DEBUG”的日誌信息傳遞給root, - root接到下級傳遞的信息,交給已經配置好的名為“STDOUT”的appender處理,“STDOUT”appender將信息打印到控制臺; --> <logger name="ch.qos.logback" /> <!-- - 1.將級別為“INFO”及大於“INFO”的日誌信息交給此logger指定的名為“STDOUT”的appender處理,在控制臺中打出日誌, - 不再向次logger的上級 <logger name="logback"/> 傳遞打印信息 - 2.level:設置打印級別(TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF),還有一個特殊值INHERITED或者同義詞NULL,代表強制執行上級的級別。 - 如果未設置此屬性,那麽當前logger將會繼承上級的級別。 - 3.additivity:為false,表示此logger的打印信息不再向上級傳遞,如果設置為true,會打印兩次 - 4.appender-ref:指定了名字為"STDOUT"的appender。 --> <logger name="com.weizhi.common.LogMain" level="INFO" additivity="false"> <appender-ref ref="STDOUT"/> <!--<appender-ref ref="DEBUG"/>--> <!--<appender-ref ref="EXCEPTION"/>--> <!--<appender-ref ref="INFO"/>--> <!--<appender-ref ref="ERROR"/>--> <appender-ref ref="ASYNC"/> </logger> <!-- - 根logger - level:設置打印級別,大小寫無關:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,不能設置為INHERITED或者同義詞NULL。 - 默認是DEBUG。 -appender-ref:可以包含零個或多個<appender-ref>元素,標識這個appender將會添加到這個logger --> <root level="DEBUG"> <appender-ref ref="STDOUT"/> <!--<appender-ref ref="DEBUG"/>--> <!--<appender-ref ref="EXCEPTION"/>--> <!--<appender-ref ref="INFO"/>--> <appender-ref ref="ASYNC"/> </root> </configuration>View Code
日誌-logback