log4j2的重新載入及不同級別日誌輸出到不同日誌檔案
阿新 • • 發佈:2019-02-05
log4j2的配置檔案格式可以是JSON,或者XML。
一般是在classpath路徑中查詢log4j2.json,或者log4j2.xml,
或者也可以通過系統引數來設定配置檔案,比如(一般這個用在命令列啟動的應用):
Java程式碼
在應用啟動時,除了讓log4j2在classpath和系統引數中查詢配置檔案,進行初始化以外,我們還可以在程式碼中隨時重新載入log4j2的配置檔案,進行重新配置。
例如,考慮下如下的常見場景:WEB應用,我們不希望把log4j2.xml打包到自己的jar檔案中(這樣修改log4j2的配置就麻煩了),也不希望把log4j2.xml放到WEB-INF/classes下面(不希望使用者隨便操作WEB-INF下的檔案),那我們可以把log4j2.xml和其他專案中用到的配置檔案,放到一個集中的地方,比如TOMCAT/bin/config下,這時,改如果初始化log4j2呢?我們可以提供一個InitServlet,例如:
Java程式碼
相應的,只要在web.xml配置這個InitServlet,並提供configRoot和log4j2Config兩個路徑即可(也可以不要配置configRoot,而是通過System.getProperty("user.dir")來獲取應用的執行目錄,對tomcat而言,這個目錄就是tomcat/bin,其他如命令列的應用,就是bat/sh的所在目錄)
web.xml
引用
<servlet>
<servlet-name>InitServlet</servlet-name>
<servlet-class>test.InitServlet</servlet-class>
<load-on-startup>0</load-on-startup>
<init-param>
<!-- 配置檔案根目錄 -->
<param-name>configRoot</param-name>
<param-value>d://config</param-value>
</init-param>
<init-param>
<!-- log4j2配置檔案相對路徑 -->
<param-name>log4j2Config</param-name>
<param-value>log4j2/log4j2.xml</param-value>
</init-param>
< /servlet>
好了,講過如何重新初始化log4j2,再講下如何把不同級別的日誌,輸出到不同的日誌檔案中。這個在網上,包括官網上,都沒有一個是說清楚的。
比如,希望trace/debug級別的日誌輸出到debug.log,而info級別的日誌輸出到info.log,其他如warn/error/fatal級別的日誌都輸出到error.log,這樣分開輸出是有好處的。我們按照如下的log42j.xml的配置,即可實現這樣的輸出。
Java程式碼
主要是要理解ThresholdFilter的onMatch/onMismatch的三個選項值:ACCEPT/DENY/NEUTRAL,其實,根據字面意思,也很好理解。
重要的是,如果有多個ThresholdFilter,那麼Filters是必須的,同時在Filters中,首先要過濾不符合的日誌級別,把不需要的首先DENY掉,然後再ACCEPT需要的日誌級別,這個次序不能搞顛倒。
一般是在classpath路徑中查詢log4j2.json,或者log4j2.xml,
或者也可以通過系統引數來設定配置檔案,比如(一般這個用在命令列啟動的應用):
Java程式碼
- -Dlog4j.configurationFile=path/to/log4j2.xml
在應用啟動時,除了讓log4j2在classpath和系統引數中查詢配置檔案,進行初始化以外,我們還可以在程式碼中隨時重新載入log4j2的配置檔案,進行重新配置。
例如,考慮下如下的常見場景:WEB應用,我們不希望把log4j2.xml打包到自己的jar檔案中(這樣修改log4j2的配置就麻煩了),也不希望把log4j2.xml放到WEB-INF/classes下面(不希望使用者隨便操作WEB-INF下的檔案),那我們可以把log4j2.xml和其他專案中用到的配置檔案,放到一個集中的地方,比如TOMCAT/bin/config下,這時,改如果初始化log4j2呢?我們可以提供一個InitServlet,例如:
Java程式碼
- ...
- public void init() throws ServletException {
- String configRoot = this.getInitParameter("configRoot");
- String log4j2Config = configRoot + File.separator + this.getInitParameter("log4j2Config");
- File file = new File(log4j2Config);
- try {
-
LoggerContext context =(LoggerContext)LogManager.getContext(false
- context.setConfigLocation(file.toURI());
- //重新初始化Log4j2的配置上下文
- context.reconfigure();
- } catch (MalformedURLException e) {
- e.printStackTrace();
- }
- //todo: 這裡拿到的logger,已經是按新配置檔案初始化的了
- logger = LogManager.getLogger(DefaultInitServlet.class);
-
}
相應的,只要在web.xml配置這個InitServlet,並提供configRoot和log4j2Config兩個路徑即可(也可以不要配置configRoot,而是通過System.getProperty("user.dir")來獲取應用的執行目錄,對tomcat而言,這個目錄就是tomcat/bin,其他如命令列的應用,就是bat/sh的所在目錄)
web.xml
引用
<servlet>
<servlet-name>InitServlet</servlet-name>
<servlet-class>test.InitServlet</servlet-class>
<load-on-startup>0</load-on-startup>
<init-param>
<!-- 配置檔案根目錄 -->
<param-name>configRoot</param-name>
<param-value>d://config</param-value>
</init-param>
<init-param>
<!-- log4j2配置檔案相對路徑 -->
<param-name>log4j2Config</param-name>
<param-value>log4j2/log4j2.xml</param-value>
</init-param>
< /servlet>
好了,講過如何重新初始化log4j2,再講下如何把不同級別的日誌,輸出到不同的日誌檔案中。這個在網上,包括官網上,都沒有一個是說清楚的。
比如,希望trace/debug級別的日誌輸出到debug.log,而info級別的日誌輸出到info.log,其他如warn/error/fatal級別的日誌都輸出到error.log,這樣分開輸出是有好處的。我們按照如下的log42j.xml的配置,即可實現這樣的輸出。
Java程式碼
- <?xml version="1.0" encoding="UTF-8"?>
- <configuration debug="off" monitorInterval="1800">
- <Properties>
- <Property name="log-path">d://logs</Property>
- </Properties>
- <Appenders>
- <Console name="Console" target="SYSTEM_OUT">
- <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36}.%M()/%L - %msg%xEx%n"/>
- </Console>
- <File name="app_debug" fileName="${log-path}/app/debug.log" append="false">
- <Filters>
- <ThresholdFilter level="info" onMatch="DENY" onMismatch="NEUTRAL"/>
- <ThresholdFilter level="debug" onMatch="ACCEPT" onMismatch="NEUTRAL"/>
- </Filters>
- <PatternLayout pattern="%d{yyyy.MM.dd HH:mm:ss z} %-5level %class{36}.%M()/%L - %msg%xEx%n"/>
- </File>
- <File name="app_info" fileName="${log-path}/app/info.log" append="false">
- <Filters>
- <ThresholdFilter level="warn" onMatch="DENY" onMismatch="NEUTRAL"/>
- <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
- </Filters>
- <PatternLayout pattern="%d{yyyy.MM.dd HH:mm:ss z} %-5level %class{36}.%M()/%L - %msg%xEx%n"/>
- </File>
- <File name="app_error" fileName="${log-path}/app/error.log" append="false">
- <Filters>
- <ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY"/>
- </Filters>
- <PatternLayout pattern="%d{yyyy.MM.dd HH:mm:ss z} %-5level %class{36}.%M()/%L - %msg%xEx%n"/>
- </File>
- </Appenders>
- <Loggers>
- <Logger name="com.test.app" level="trace" additivity="false">
- <appender-ref ref="Console"/>
- <appender-ref ref="app_debug"/>
- <appender-ref ref="app_info"/>
- <appender-ref ref="app_error"/>
- </Logger>
- </Loggers>
- </configuration>
主要是要理解ThresholdFilter的onMatch/onMismatch的三個選項值:ACCEPT/DENY/NEUTRAL,其實,根據字面意思,也很好理解。
重要的是,如果有多個ThresholdFilter,那麼Filters是必須的,同時在Filters中,首先要過濾不符合的日誌級別,把不需要的首先DENY掉,然後再ACCEPT需要的日誌級別,這個次序不能搞顛倒。