跳到主要內容

Log4j2 - Change log level at runtime

Problem

為了能夠在系統執行期間蒐集發生問題的資訊,有時我們會在執行功能之前,去動態調整log level,儘可能最大化地去蒐集必要資訊。在Log4j 1.x時,我們採用了以下寫法去做到動態切換log level:

Logger logger = LogManager.getLogger(packName);
logger.setLevel(Level.TRACE);

本篇文章主要分享在Log4j2可行的做法。範例程式可參考: link

How to?

SUT

public class TestLogger {
    private static final Logger LOGGER = LoggerFactory.getLogger(TestLogger.class);
 
    public static void debug(String message) {
        LOGGER.debug(message);   
    }
 
    public static void error(String message) {
        LOGGER.error(message);   
    }
}

Configuration properties

預設啟用了ConsoleAppender,而SUT的level是設為error;另外appender.console.follow設為true,讓Log4j可以反應system.out或system.err的變更,這主要和我們測試時會去攔截console有關:

rootLogger.level = info
rootLogger.appenderRef.stdout.ref = STDOUT

status = error
dest = err
name = PropertiesConfig

filter.threshold.type = ThresholdFilter
filter.threshold.level = debug
 
appender.console.type = Console
appender.console.name = STDOUT
appender.console.follow = true
appender.console.layout.type = PatternLayout
appender.console.layout.pattern = %d %p %C{1.} [%t] %m%n
appender.console.filter.threshold.type = ThresholdFilter
appender.console.filter.threshold.level = trace

logger.console.name = org.tonylin.practice.log4j2.example1
logger.console.level = error
logger.console.additivity = false
logger.console.appenderRef.rolling.ref = STDOUT

Unit Test

測試程式我使用了console-captor library讓我可以很容易去捕捉console內容;測試後我會透過Configurator.reconfigure去重置設置內容:

    private ConsoleCaptor captor;
 
    @Before
    public void setup() {
        captor = new ConsoleCaptor();
        Configurator.reconfigure();
    }
 
    @After
    public void teardown() {
      captor.close();
    }

首先讓我們先測試debug level不會有console,而error level會有console且內容符合預期:

    @Test
    public void Should_NotSystemOutToConsole_When_LogDebugWithDefaultConfiguration() {   
        TestLogger.debug("test debug");
        assertEquals(0, captor.getStandardOutput().size());
    }
 
    @Test
    public void Should_SystemOutToConsole_When_LogErrorWithDefaultConfiguration() {
        TestLogger.error("test error");
        assertEquals(1, captor.getStandardOutput().size());
        assertTrue(captor.getStandardOutput().get(0).contains("test error"));
    }

接著就是本篇主角了,第一個方法是直接用Configurator去設定,雖然簡單,但這不是一個public的API,不建議在production code使用:

    @Test
    public void Should_SystemOutToConsole_When_LogDebugAfterChangingLogLevelWithConfigurator() {
        Configurator.setLevel(TestLogger.class.getName(), Level.DEBUG);
 
        TestLogger.debug("test debug");
        assertEquals(1, captor.getStandardOutput().size());
        assertTrue(captor.getStandardOutput().get(0).contains("test debug"));
    }

另外一個方法參考自這裡,其實就是Configurator實作的方法(Configurator像是一個Utility的Class):

    @Test
    public void Should_SystemOutToConsole_When_LogDebugAfterChangingLogLevel() {
        LoggerContext ctx = (LoggerContext) LogManager.getContext(false);
        Configuration config = ctx.getConfiguration();
        LoggerConfig loggerConfig = config.getLoggerConfig(TestLogger.class.getName());
        loggerConfig.setLevel(Level.DEBUG);
        ctx.updateLoggers();
 
        TestLogger.debug("test debug");
        assertEquals(1, captor.getStandardOutput().size());
        assertTrue(captor.getStandardOutput().get(0).contains("test debug"));
    }

註: LogManager.getContext(true)的真正作用情境還不曉得為何,有弄清楚後再分享。

Reference

留言

這個網誌中的熱門文章

PostgreSQL - Unattended installation on windows

Introduction 要將別人軟體包裝到自己軟體中,不可或缺的東西就是Unattended installation。以Unattended installation來說,我們可以選擇透過Installer的silent mode安裝,也可以透過把目標軟體做成portable的版本。本篇文章分享這兩種方法,教導大家如何將PostgreSQL透過Unattended installation方式安裝到目標系統成為service。 Note. 本篇以PostgreSQL 10.7為例。 Install with installer Tips 安裝程式或反安裝程式的參數,除了可以直接上官網搜尋Installation User Guide以外,也可以直接使用help參數查詢: postgresql- 10.7 - 2 -windows-x64.exe --help Windows安裝程式主要有EnterpriseDB與BigSQL兩種。BigSQL版本安裝元件是透過網路下載且支援參數不如EnterpriseDB版本多,以我們需求來說,我們傾向於使用EnterpriseDB版本。接下來分享給大家安裝與反安裝方法。 Installation @ echo off set INSTALL_DIR =C:\postgres10 set INSTALLER =postgresql- 10.7 - 2 -windows-x64.exe   rem options for installation set SSMDB_SERVICE =postgresql- 10 set MODE =--unattendedmodeui none --mode unattended   set DB_PASSWD =--superpassword postgres set DB_PORT =--serverport 5432   set SERVICE_NAME =--servicename % SSMDB_SERVICE %   set PREFIX =--prefix "%INSTALL_DIR%" set DATA_DIR =--datadir "%INSTALL_DIR%\data"   set OPTIONS =

How to install RIDE on Windows?

Introduction 多年沒在Windows上開發RobotFramework,趁著這次整理一下RIDE安裝方法。 目前RIDE最新版本與Python對應版本如下: (3.6 < python <= 3.11) Install current released version (2.0.8.1) with: pip install -U robotframework-ride 安裝Python 直接到Python官網找尋最新的3.11版本,我使用3.11.9: link 。安裝就是一直下一步而已。 安裝wxPython 每次安裝RIDE最困難的都是wxPython。看了一下 官網 描述,我就姑且相信一下: 接著進入下 載頁面 就有安裝教學。基本上就是到Python目錄下的Scripts直接執行以下command: pip install -U wxPython 安裝RIDE 接著就如RIDE官網所說,執行以下command: pip install -U robotframework-ride 啟動RIDE 直接在相同目錄下執行ride就可以啟動了,你也可以直接在桌面建ride連結,加快下次啟動時間。 沒想到這次這麼順利就安裝完成了。因為我是使用java去啟動robot framework,就不特別講要怎麼使用pip安裝robot framework了。

Hello World!

即將要搬家,因此舊網頁內容將慢慢轉移至Blogger。 如果要存取舊網頁,可以使用以下連結: https://wiki.tonylin.idv.tw/dokuwiki/doku.php