log4j2筆記 #04# Appender的三個基本款以及RollingFile的各類示例配置

// 留着備用。

三個基本款分別是ConsoleAppender、FileAppender（以及他的兄弟RandomAccessFileAppender）、RollingFileAppender（以及他的兄弟RollingRandomAccessFileAppender），其中RollingFileAppender是三個appender中的老大，由於他一我的的文檔篇幅就是其它兩個appender文檔篇幅總和的6~7倍左右。。。

關於三個appender的簡單介紹：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <!-- 在Appenders中定義可選的輸出「目的地」 -->
    <Appenders>
        <!-- Appenders官方文檔地址https://logging.apach
        e.org/log4j/2.x/manual/appenders.html，其次是可
        以直接去看org.apache.logging.log4j.core.appender
        包下的appender源代碼 -->
        <Console name="STDOUT" target="SYSTEM_OUT">
            <!-- 在pattern中定義輸出格式，各類佔位符（轉
            義符）的用法、含義可查詢文檔https://logging.a
            pache.org/log4j/2.x/manual/layouts.html -->
            <PatternLayout pattern="%m%n"/>
            <!-- 對於ConsoleAppender而言，Layout是必要的，
            默認就是%m%n -->
        </Console>

        <!-- FileAppender。servlet容器中的兩個web應用程序
        能夠擁有它們各自的配置，若是Log4j位於它們共同使用
        的類加載器中，則能夠安全地將日誌寫入同一個文件。默認
         啓用bufferedIO以及immediateFlush（前者提升性能，後
         者能夠保證寫入，緩衝區沒滿也寫入！每次寫操做都會調
         用flush，不過有點影響性能），若是是異步Logger，即使
         immediateFlush設置爲false，異步Logger和appender也
         將在一批事件結束時自動flush，這樣作比較高效同時
          保證了數據寫入磁盤 -->
        <File name="MyFile" fileName="logs/app.log">
            <PatternLayout pattern="%m%n"/>
        </File>

        <!-- 彷佛能夠看做是FileAppender的進化版，實現上不大
        同樣，根據報導，相比啓用了bufferedIO的FileAppender
        性能提升了20-200%（RandomAccessFile沒有bufferedIO
        這個選項，由於它老是buffered的！） -->
        <RandomAccessFile name="MyRandomAccessFile" fileName="logs/app.log">
            <PatternLayout>
                <Pattern>%d %p %c{1.} [%t] %m%n</Pattern>
            </PatternLayout>
        </RandomAccessFile>

        <!--RollingFileAppender是一個OutputStreamAppender，
        它寫入fileName參數中指定的文件，並根據TriggeringPolicy
        和RolloverPolicy將文件翻轉。對於RollingFileAppender而
        言，這兩個Policy都是必要的，TriggeringPolicy肯定是否應
        該執行滾動，而RolloverStrategy定義如何執行滾動。-->
        <RollingFile name="RollingFileInfo" fileName="logs/info.log"
                     filePattern="logs/$${date:yyyy-MM}/info-%d{yyyy-MM-dd}-%i.log">
            <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY" />
            <PatternLayout pattern="[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%-5level] %l %logger{36} - %msg%n" />
            <Policies>
                <OnStartupTriggeringPolicy />
                <SizeBasedTriggeringPolicy size="20 MB" />
                <TimeBasedTriggeringPolicy />
            </Policies>
            <!-- DefaultRolloverStrategy屬性如不設置，則默認爲最多同一文件夾下7個文件，這裏設置了30 -->
            <DefaultRolloverStrategy max="30" />
        </RollingFile>

        <!-- 故障轉移追加器，若是primary追加器失敗了，
        就繼續按照順序嘗試Failovers中的appenders -->
        <Failover name="Failover" primary="MyFile">
            <Failovers>
                <AppenderRef ref="STDOUT"/>
            </Failovers>
        </Failover>
    </Appenders>

    <Loggers>
        <Root level="debug">
            <AppenderRef ref="STDOUT"/>
        </Root>
    </Loggers>
</Configuration>

針對RollingFileAppender的筆記↓

測試程序，負責源源不斷地打log：

package org.sample.webapp.util;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class TestLog4j2 {

    private static final Logger LOGGER = LogManager.getLogger();

    public static void main(String[] args) {

        for (int i = 0; i < 10000; i++) {
            LOGGER.info("Rolling file appender example...");
            try {
                Thread.sleep(500);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
        }
    }
}

示例之一（DefaultRolloverStrategy ）：

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

<!-- 實時寫到mylog.log，每隔兩分鐘進行一次rollover，
    rollover策略爲按照時間做爲增量命名日誌文件並壓縮歸檔。-->
<Configuration status="WARN">
    <Appenders>
        <!-- 便於在控制檯觀察實際輸出狀況 -->
        <Console name="STDOUT" target="SYSTEM_OUT">
            <PatternLayout>
                <Pattern>%d{yyyy-MMM-dd HH:mm:ss a} [%t] %-5p %c{-2} - %m%n</Pattern>
            </PatternLayout>
        </Console>

        <!-- 大概能夠視爲RollingFileAppender的進化版，沒
        有bufferedIO這個屬性，對於RollingRandomAccessFile，
        緩存是固定開啓的。fileName是實時寫入的（未歸檔）文
        件名，filePattern則是歸檔文件的命名模式，由於開啓了
         異步日誌因此這裏immediateFlush設置爲false（不過好像
         無論它也無所謂），bufferSize緩衝區大小暫時默認，
         最後，TriggeringPolicy和RolloverStrategy是必須有的，
         沒有顯示定義就會採用默認的。-->
        <RollingRandomAccessFile  name="RollingRandomAccessFile" fileName="logs/mylog.log" immediateFlush="false"
                     filePattern="logs/time-based-logs/%d{yyyy-MM-dd-hh-mm}.log.zip">
            <!-- 生成的日誌文件名要麼按照時間來增加，filePattern中須要%d，
            要麼就以整數增加，filePattern中須要%i，又或者兩個搭配（意義彷佛不是很大 由於rollover一次計數器又從1開始了。。），文件名僅按照時間增加的話， RolloverStrategy設置max，min參數彷佛也沒多什麼意義了。-->
            <!-- 若是filePattern以".gz", ".zip", ".bz2", ".deflate", ".pack200",或者".xz"結尾，
            那麼將使用與相對應的壓縮方案壓縮生成的歸檔文件。-->
            <PatternLayout>
                <Pattern>%d{yyyy-MMM-dd HH:mm:ss a} [%t] %-5p %c{-2} - %m%n</Pattern>
            </PatternLayout>
            <!--決定是否應該執行rollover，只要有任何一個
            policy返回true那麼就進行rollover，rollover的
            意思大概能夠理解爲：當日志文件知足特定條件時
            將觸發的事件，例如建立一個新的文件/把原有的文件
            歸檔/刪除等，具體怎樣rollover由RolloverStrategy
            決定 -->
            <Policies>
                <!-- jvm重啓就進行一次rollover-->
                <OnStartupTriggeringPolicy />
                <!-- 文件大小達到20mb進行一次rollover -->
                <SizeBasedTriggeringPolicy size="20 MB" />
                <!-- TimeBasedTriggeringPolicy是最多用到的Policy，
                interval默認值是1，根據filePattern中日期的最小單位，例如
                在該配置裏是mm（分鐘），設置interval="2"則每隔兩分鐘將發生
                一次rollover，按當前配置，具體表現就是隔兩分鐘獲得一個log.zip。
                modulate就是讓第一次rollover發生在區間邊界上（即使還沒到
                interval的時長），按照當前配置，首次rollover會發生在好比
                8點50分0秒，這樣以後的rollover就是8點52分0秒、8點54分0秒..
                這樣作的好處在於rollover的時機就變得頗有規律很好預測，生成的
                文件還很整齊（假設時間最小單位爲天，interval="1"，那麼就
                變成穩定天天0點自動rollover了。。）。還有個屬性叫maxRandomDelay，
                防止不少應用在同一時間一塊兒rollover的，暫時不理它。
                  -->
                <TimeBasedTriggeringPolicy interval="2" modulate="true" />
            </Policies>
            <!-- DefaultRolloverStrategy，默認rollover策略。參數：
            fileIndex有兩個值，max和min，就是決定生成文件是從序號大的到
            序號小的，仍是從序號小的到序號大。min，計數器的起始值，
             默認是1；max，計數器的最大值，默認是7。還有兩個參數暫時無論。-->
            <DefaultRolloverStrategy/>
        </RollingRandomAccessFile>
    </Appenders>

    <Loggers>
        <!-- 用來debug。只要additivity不設置爲false，日誌起碼會被打印到控制檯。-->
        <Root level="debug">
            <AppenderRef ref="STDOUT"/>
        </Root>
        <!-- 測試對象。將日誌轉發給RollingFileAppender -->
        <Logger name="org.sample.webapp.util.TestLog4j2" level="debug" additivity="true">
            <AppenderRef ref="RollingRandomAccessFile" />
        </Logger>
    </Loggers>

</Configuration>

運行若干分鐘後的結果：

下面是官方的example，將反駁上面註釋裏的一些自覺得是的觀點。。

/

示例之二，提速版官方xml（DefaultRolloverStrategy ）：

<?xml version="1.0" encoding="UTF-8"?>
<!-- 將在同一天建立最多7個歸檔(1-7號)，這些歸檔存儲在基於
當前年和月的目錄文件中，並用gzip壓縮每一個歸檔，我把全部時間
相關的變小兩個單位修改爲：每分鐘最多7個歸檔，並存在基於
日和小時的目錄文件中,並用gzip壓縮每一個歸檔 -->
<Configuration status="warn" name="MyApp" packages="">
    <Appenders>
        <!-- 形如$${date:yyyy-MM}參考https://logging.apache.org/log4j/2.x/manual/lookups.html#DateLookup-->
        <RollingFile name="RollingFile" fileName="logs/app.log"
                     filePattern="logs/$${date:dd-HH}/app-%d{HH-mm-dd}-%i.log.gz">
            <!-- 原來的值logs/$${date:yyyy-MM}/app-%d{MM-dd-yyyy}-%i.log.gz -->
            <PatternLayout>
                <Pattern>%d %p %c{1.} [%t] %m%n</Pattern>
            </PatternLayout>
            <Policies>
                <TimeBasedTriggeringPolicy />
                <!-- 因此時間%d和整數%i同時用的意義就在於，當單個日誌文件到達最大size
                的時候建立一個新的文件 -->
                <SizeBasedTriggeringPolicy size="1 KB"/>
            </Policies>
        </RollingFile>
    </Appenders>
    <Loggers>
        <Root level="debug">
            <AppenderRef ref="RollingFile"/>
        </Root>
    </Loggers>
</Configuration>

運行若干分鐘後的結果：

 

/

示例之三，提速版本官方xml（DirectWrite Rollover Strategy，好像和默認的也沒多大差異。。）

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="warn" name="MyApp" packages="">
    <Appenders>
        <RollingFile name="RollingFile" filePattern="logs/app-%d{yyyy-MM-dd-mm}-%i.log.gz">
            <PatternLayout>
                <Pattern>%d %p %c{1.} [%t] %m%n</Pattern>
            </PatternLayout>
            <Policies>
                <SizeBasedTriggeringPolicy size="2 KB"/>
            </Policies>
            <!-- 直接往filePattern所指定的文件寫，沒有rename這個環節-->
            <DirectWriteRolloverStrategy maxFiles="10"/>
        </RollingFile>
    </Appenders>
    <Loggers>
        <Root level="debug">
            <AppenderRef ref="RollingFile"/>
        </Root>
    </Loggers>
</Configuration>

運行若干分鐘的結果：