如何實現(xiàn)log4j2項目日志組件

這篇文章給大家分享的是有關(guān)如何實現(xiàn)log4j2項目日志組件的內(nèi)容。小編覺得挺實用的，因此分享給大家做個參考，一起跟隨小編過來看看吧。

在項目運行過程中，常常需要進行功能調(diào)試以及用戶行為的跟蹤和記錄，部分人習慣使用System.out，但這并不建議，它僅僅是使用方便但不便于維護也無擴展性。相比log4j的話，log4j可以控制日志信息的輸送目的地、輸出格式以及級別等等，使我們能夠更加細致地控制日志的生成過程。

Log4j2是對Log4j1的升級，在性能和功能上有顯著的改進，包括多線程中吞吐量的增強、占位符的支持、配置文件自動重新加載等

一、入門介紹

1、下載jar包

pox.xml

<dependencies>
 <dependency>
 <groupId>org.apache.logging.log4j</groupId>
 <artifactId>log4j-api</artifactId>
 <version>2.10.0</version>
 </dependency>
 <dependency>
 <groupId>org.apache.logging.log4j</groupId>
 <artifactId>log4j-core</artifactId>
 <version>2.10.0</version>
 </dependency>
</dependencies>

2、配置文件

Log4j包含四個配置工廠實現(xiàn)：JSON、YAML、properties、XML，本文介紹常用的方式XML。

Log4j具有在初始化期間自動配置自身的能力。當Log4j啟動時，它將定位類路徑下所有符合名稱的文件，優(yōu)先級順序：log4j2-test.properties > log4j2-test.xml > log4j2.properties > log4j2.xml

3、一個簡單的實例

xml配置：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
 <Appenders>
 <Console name="Console" target="SYSTEM_OUT">
 <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
 </Console>
 </Appenders>
 <Loggers>
 <Root level="info">
 <AppenderRef ref="Console"/>
 </Root>
 </Loggers>
</Configuration>

java代碼：

private static final Logger logger = LogManager.getLogger(MyApp.class);
 @Test
 public void testLog4j(){
 logger.info("hello world!");
 }
}

控制臺信息

22:17:47.146 [main] INFO MyApp - hello world!

二、模塊介紹

<Configuration>

<Appenders>

Log4j允許將日志請求打印到多個目的地。在log4j語言中，輸出目的地稱為Appender。目前，appender存在于控制臺、文件、遠程套接字服務(wù)器、Apache Flume、JMS、遠程UNIX Syslog守護進程和各種數(shù)據(jù)庫api中。以下介紹幾種比較常用的appender，如需了解更多可以到官網(wǎng)上進行查閱。

1、ConsoleAppender

輸出到控制臺，<Console>

2、FileAppender

輸出到文件，<File>

3、JDBCAppender

JDBCAppender使用標準JDBC將日志事件寫入到關(guān)系數(shù)據(jù)庫表中。它可以配置為使用JNDI數(shù)據(jù)源或自定義工廠方法獲得JDBC連接。無論采用哪種方法，都必須由連接池來支持。

否則，日志記錄性能將受到極大的影響。

如果已配置的JDBC驅(qū)動程序支持批處理語句，并且將緩沖區(qū)大小配置為一個正數(shù)，那么日志事件將被批處理。

（1）<JDBC>

（2）使用<DataSource>來獲得JDBC的連接，這里僅列出jndi：

（3）使用<Column>來指定要寫入表中的哪些列，以及如何對它們進行寫入。它沒有SQL注入漏洞。

實例：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="error">
 <Appenders>
 <JDBC name="databaseAppender" tableName="dbo.application_log">
  <DataSource jndiName="java:/comp/env/jdbc/LoggingDataSource" />
  <Column name="eventDate" isEventTimestamp="true" />
  <Column name="level" pattern="%level" />
  <Column name="logger" pattern="%logger" />
  <Column name="message" pattern="%message" />
  <Column name="exception" pattern="%ex{full}" />
 </JDBC>
 </Appenders>
 <Loggers>
 <Root level="warn">
  <AppenderRef ref="databaseAppender"/>
 </Root>
 </Loggers>
</Configuration>

<PatternLayout>

（1）日期，%d / %date

當然你也可以自定義格式，比如 %d{yyyy-MM-dd HH:mm:ss}

（2）記錄器，%c / %logger

{?} - ?是正整數(shù)時表示從右邊開始取n個部分，負整數(shù)表示從左邊開始移除n個部分，那為什么%c{-10}是完整的名稱我也不清楚，歡迎留言

（3）日志信息，%m / %msg / %message

（4）日志級別，%level

<Filter>

log4j2自帶多種filter供直接使用，也可以由我們自己來定義filter：

MyFilter.java

import org.apache.logging.log4j.Level;
import org.apache.logging.log4j.Marker;
import org.apache.logging.log4j.ThreadContext;
import org.apache.logging.log4j.core.LogEvent;
import org.apache.logging.log4j.core.Logger;
import org.apache.logging.log4j.core.config.plugins.Plugin;
import org.apache.logging.log4j.core.config.plugins.PluginAttribute;
import org.apache.logging.log4j.core.config.plugins.PluginFactory;
import org.apache.logging.log4j.core.filter.AbstractFilter;
import org.apache.logging.log4j.message.Message;
@Plugin(name = "MyFilter", category = "Core", elementType = "filter", printObject = true)
public final class MyFilter extends AbstractFilter {
 private final Level level;
 private MyFilter(Level level, Result onMatch, Result onMismatch) {
  super(onMatch, onMismatch);
  this.level = level;
 }
 public Result filter(Logger logger, Level level, Marker marker, String msg, Object[] params) {
  return filter(level);
 }
 public Result filter(Logger logger, Level level, Marker marker, Object msg, Throwable t) {
  return filter(level);
 }
 public Result filter(Logger logger, Level level, Marker marker, Message msg, Throwable t) {
  return filter(level);
 }
 @Override
 public Result filter(LogEvent event) {
  return filter(event.getLevel());
 }
 private Result filter(Level level) {
  /*
  * 業(yè)務(wù)邏輯
  * */
  
  return level.isMoreSpecificThan(this.level) ? onMatch : onMismatch;
 }
 @Override
 public String toString() {
  return level.toString();
 }
 @PluginFactory
 public static MyFilter createFilter(@PluginAttribute(value = "level", defaultString = "ERROR") Level level,
            @PluginAttribute(value = "onMatch", defaultString = "NEUTRAL") Result onMatch,
            @PluginAttribute(value = "onMismatch", defaultString = "DENY") Result onMismatch) {
  return new MyFilter(level, onMatch, onMismatch);
 }
}

log4j2.xml

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="warn" monitorInterval="5" packages="your packages" verbose="false" strict="true">
 <Appenders>
 <Console name="Console" target="SYSTEM_OUT" ignoreExceptions="true">
  <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %level %logger{10} - %msg"/>
  <MyFilter level="info" onMatch="ACCEPT"/>
 </Console>
 </Appenders>
 <Loggers>
 <Root level="info">
  <AppenderRef ref="Console"/>
 </Root>
 </Loggers>
</Configuration>

補充：

在實際應(yīng)用中，有時需要對用戶的訪問信息進行記錄，比如請求參數(shù)、用戶id等等。在log4j1中我們會使用MDC和NDC來存儲應(yīng)用程序的上下文信息，而log4j2使用ThreadContext來實現(xiàn)MDC和NDC兩者的功能。

（1）NDC采用類似棧的機制來存儲上下文信息，線程獨立。

在PatternLayout中使用 %x 來輸出，注意x是小寫。

實例：

Test.java

ThreadContext.push("hello world!");

log4j2.xml

<Column name="tip" pattern="%x" />

（2）MDC采用類似map的機制來存儲信息，線程獨立。

在PatternLayout中使用 %X{userId} 來輸出，注意X是大寫。

實例：

Test.java

ThreadContext.put("userId","1");

log4j2.xml

<Column name="userId" pattern="%X{userId}" />

注意使用完后調(diào)用clearAll()清除上下文映射和堆棧。

api：http://logging.apache.org/log4j/2.x/javadoc.html

官網(wǎng)地址：https://logging.apache.org/log4j/2.x/index.html

感謝各位的閱讀！關(guān)于“如何實現(xiàn)log4j2項目日志組件”這篇文章就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，讓大家可以學到更多知識，如果覺得文章不錯，可以把它分享出去讓更多的人看到吧！