Log4j 2 + Slf4j 的配置和使用

最新推荐文章于 2024-08-12 08:09:07 发布

JIESA

最新推荐文章于 2024-08-12 08:09:07 发布

阅读量842

点赞数

分类专栏： java log4j

java 同时被 2 个专栏收录

228 篇文章 0 订阅

订阅专栏

log4j

7 篇文章 0 订阅

订阅专栏

Log4j 2是log4j 1.x和logback的改进版，据说采用了一些新技术（无锁异步、等等），使得日志的吞吐量、性能比log4j 1.x提高10倍，并解决了一些死锁的bug，而且配置更加简单灵活。下面是结合slf4j的配置和使用过程：

1、引用依赖包及相关注释：
   
   1

<!-- log配置：Log4j2 + Slf4j -->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>2.2</version>
</dependency>
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.2</version>
</dependency>
<dependency> <!-- 桥接：告诉Slf4j使用Log4j2 -->
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-slf4j-impl</artifactId>
    <version>2.2</version>
</dependency>
<dependency> <!-- 桥接：告诉commons logging使用Log4j2 -->
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-jcl</artifactId>
    <version>2.2</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.10</version>
</dependency>
   
   1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

**注：**log4j-api-2.x 和 log4j-core-2.x是必须的，其他包根据需要引入，如下图所示：
这里写图片描述

2、代码中使用：

@RunWith(SpringJUnit4ClassRunner.class)  //使用Spring Junit4进行测试  
@ContextConfiguration ({"classpath:spring/applicationContext.xml"}) //加载配置文件
public abstract class BaseJunit4Test {
}

import org.junit.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
mport com.xjj.test.BaseJunit4Test; 
public class Log4j2Test extends BaseJunit4Test {
 static public Logger logger = LoggerFactory.getLogger(Log4j2Test.class); 

   @Test
   public void logTC1(){
      logger.error("error");
      logger.debug("debug");
      logger.info("info");
      logger.trace("trace");
      logger.warn("warn");
      logger.error("error {}", "param");
 }
}
   
   1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

输出结果：

16:19:28.779 [main] ERROR com.xjj.test.mytest.Log4j2Test - error
16:19:28.781 [main] ERROR com.xjj.test.mytest.Log4j2Test - error param
   
   1
2

注：如果没有任何配置，Log4j2会使用缺省配置：

root logger：ConsoleAppender
PatternLayout："%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"
   
   1
2

级别：ERROR

3、配置（使用xml配置文件）：
官网配置指南：http://logging.apache.org/log4j/2.x/manual/configuration.html

在classpath中创建名字为log4j2.xml的配置文件。

Configuration标签中的常用元素说明：
monitorInterval：Log4j 2 定期检查和应用配置文件的时间间隔（单位：秒，如果更改配置文件，不用重启系统）。
status：Log4j内部事件记录的等级，只对Log4j本身的事件有效。
strict：是否使用XML Schema来检查配置文件。
schema：Shema文件的位置。
例子：

<Configuration status="warn" monitorInterval="30" strict="true" schema="Log4J-V2.2.xsd">
    ……
</Configuration>
   
   1
2
3

Loggers标签说明：
它被用来配置LoggerConfig，包含一个root logger和若干个普通logger
普通必须有一个name元素，root logger不用name元素
每个logger可以指定一个level（TRACE, DEBUG, INFO, WARN, ERROR, ALL or OFF），不指定时level默认为ERROR
additivity指定是否同时输出log到父类的appender，缺省为true。（层级关系与java包类似，例如：com.foo是com.foo.Bar的父级；java是java.util的父级，是java.util.vector的祖先。root是最顶层。）
每个logger可以包含若干个属性：AppenderRef, Filter, Layout, 等
例子：

<Loggers>
    <Root level="warn"> <!-- 全局配置 -->
         <AppenderRef ref="Console"/>
    </Root>

    <!-- 为某些包/类配置Log级别，这些logger继承了root logger -->
    <Logger name="com.xjj.test" level="TRACE"/>
    <Logger name="com.xjj.test2" level="DEBUG" additivity="false">
         <AppenderRef ref="Console"/>
    </Logger>
</Loggers>
   
   1
2
3
4
5
6
7
8
9
10
11

Filters标签说明：
与防火墙过滤的规则相似，log4j2的过滤器也将返回三类状态：Accept（接受）, Deny（拒绝）或Neutral（中立）。其中，Accept意味着不用再调用其他过滤器了，这个LogEvent将被执行；Deny意味着马上忽略这个event，并将此event的控制权交还给过滤器的调用者；Neutral则意味着这个event应该传递给别的过滤器，如果再没有别的过滤器可以传递了，那么就由现在这个过滤器来处理。

Appenders标签说明：
Appender用来定义不同的输出位置，可以是console、文件、远程socket服务器、Apache Flume、JMS以及远程 UNIX 系统日志守护进程。一个Logger可以绑定多个不同的Appender。

Layout/PatternLayout：
定义log的格式（一种类似C语言printf函数的打印格式）。

配置例子和注解如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xml>
<!-- Log4j 2.x 配置文件。每30秒自动检查和应用配置文件的更新； -->
<Configuration status="warn" monitorInterval="30" strict="true" schema="Log4J-V2.2.xsd">
    <Appenders>
           <!-- 输出到控制台 -->
           <Console name="Console" target="SYSTEM_OUT">
               <!-- 需要记录的级别 -->
               <!-- <ThresholdFilter level="debug" onMatch="ACCEPT" onMismatch="DENY" /> -->
               <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS}:%4p %t (%F:%L) - %m%n" />
          </Console>

          <!-- 输出到文件，按天或者超过80MB分割 -->
          <RollingFile name="RollingFile" fileName="../logs/xjj.log"    filePattern="../logs/$${date:yyyy-MM}/xjj-%d{yyyy-MM-dd}-%i.log.gz">
               <!-- 需要记录的级别 -->
               <!-- <ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY" /> -->
               <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS}:%4p %t (%F:%L) - %m%n" />
               <Policies>
                    <OnStartupTriggeringPolicy />
                    <TimeBasedTriggeringPolicy />
                    <SizeBasedTriggeringPolicy size="80 MB" />
               </Policies>
          </RollingFile>
     </Appenders>
     <Loggers>
          <Root level="info"> <!-- 全局配置 -->
               <AppenderRef ref="Console" />
               <AppenderRef ref="RollingFile"/>
          </Root>
          <!-- 为sql语句配置特殊的Log级别，方便调试 -->
          <Logger name="com.xjj.dao" level="${log.sql.level}" additivity="false">
               <AppenderRef ref="Console" />
          </Logger>
     </Loggers>
</Configuration>
   
   1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

实际使用的例子（用slf4j接口）：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

private final static Logger logger = LoggerFactory.getLogger(MyClass.class);
try {
    ……
} catch (Exception e) {
    logger.error("发生了异常：", e);
}
logger.info("请求处理结束，耗时：{}毫秒", (System.currentTimeMillis() - beginTime));    //第一种用法
logger.info("请求处理结束，耗时：" + (System.currentTimeMillis() - beginTime)  + "毫秒");    //第二种用法
   
   1
2
3
4
5
6
7
8
9
10
11

Tips：根据官方测试的数据，第一种用法比第二种快47倍！

http://blog.csdn.net/clementad/article/details/44625787

=====================================================================

使用Slf4j集成Log4j2构建项目日志系统的完美解决方案

一、背景

　　最近因为公司项目性能需要，我们考虑把以前基于的log4j的日志系统重构成基于Slf4j和log4j2的日志系统，因为，使用slf4j可以很好的保证我们的日志系统具有良好的兼容性，兼容当前常见几种日志系统，而使用log4j2而不是log4j是因为Log4j 1.x 在高并发情况下出现死锁导致cpu使用率异常飙升，而Log4j2.0基于LMAX Disruptor的异步日志在多线程环境下性能会远远优于Log4j 1.x和logback（官方数据是10倍以上）。

　　关于slf4j的原理以及优点，请参见我的另一篇博客：slf4j介绍以及实现原理窥探

二、搭建步骤

　　1.依赖管理

　　　　1).删除项目中存在的Log4j1.x所必须的log4j和slf4j-log4j12等依赖。

　　　　　　可以到项目的根目录，执行：mvn dependency:tree > tree.log，之后使用 cat tree.log | grep log4j命令进行查找。

 1     <exclusions>  
 2         <exclusion>  
 3             <groupId>org.slf4j</groupId>  
 4             <artifactId>slf4j-log4j12</artifactId>  
 5         </exclusion>  
 6         <exclusion>  
 7             <groupId>log4j</groupId>  
 8             <artifactId>log4j</artifactId>  
 9         </exclusion>  
10     </exclusions>

　　　　2).添加以下slf4j和log4j2的依赖.

 1     <!-- slf4j核心包-->  
 2         <dependency>  
 3             <groupId>org.slf4j</groupId>  
 4             <artifactId>slf4j-api</artifactId>  
 5             <version>1.7.13</version>  
 6         </dependency>  
 7         <dependency>  
 8             <groupId>org.slf4j</groupId>  
 9             <artifactId>jcl-over-slf4j</artifactId>  
10             <version>1.7.13</version>  
11             <scope>runtime</scope>  
12         </dependency>  
13   
14         <!--核心log4j2jar包-->  
15         <dependency>  
16             <groupId>org.apache.logging.log4j</groupId>  
17             <artifactId>log4j-api</artifactId>  
18             <version>2.4.1</version>  
19         </dependency>  
20         <dependency>  
21             <groupId>org.apache.logging.log4j</groupId>  
22             <artifactId>log4j-core</artifactId>  
23             <version>2.4.1</version>  
24         </dependency>  
25         <!--用于与slf4j保持桥接-->  
26         <dependency>  
27             <groupId>org.apache.logging.log4j</groupId>  
28             <artifactId>log4j-slf4j-impl</artifactId>  
29             <version>2.4.1</version>  
30         </dependency>  
31         <!--web工程需要包含log4j-web，非web工程不需要-->  
32         <dependency>  
33             <groupId>org.apache.logging.log4j</groupId>  
34             <artifactId>log4j-web</artifactId>  
35             <version>2.4.1</version>  
36             <scope>runtime</scope>  
37         </dependency>  
38   
39         <!--需要使用log4j2的AsyncLogger需要包含disruptor-->  
40         <dependency>  
41             <groupId>com.lmax</groupId>  
42             <artifactId>disruptor</artifactId>  
43             <version>3.2.0</version>  
44         </dependency>

　　2.web.xml中设置log4j2的监听器和过滤器（servlet3.0及以上版本不需要该步操作）

 1 <!--对于log4j2，Servlet2.5以前的版本需要-->  
 2   <listener>  
 3      <listener-class>org.apache.logging.log4j.web.Log4jServletContextListener</listener-class>  
 4   </listener>  
 5   <filter>  
 6      <filter-name>log4jServletFilter</filter-name>  
 7      <filter-class>org.apache.logging.log4j.web.Log4jServletFilter</filter-class>  
 8   </filter>  
 9   <filter-mapping>  
10      <filter-name>log4jServletFilter</filter-name>  
11      <url-pattern>/*</url-pattern>  
12      <dispatcher>REQUEST</dispatcher>  
13      <dispatcher>FORWARD</dispatcher>  
14      <dispatcher>INCLUDE</dispatcher>  
15      <dispatcher>ERROR</dispatcher>  
16   </filter-mapping>

　　注意：log4j2不再支持properties文件了，只支持xml，json或是yaml，不指定位置的情况下默认在src/main/resources下查找。

　　　　　如果需要自定义位置，需要在上面的web.xml中添加以下代码

1 <context-param>  
2   <param-name>log4jConfiguration</param-name>  
3   <param-value>/WEB-INF/classes/log4j2.xml</param-value>  
4 </context-param>

　　3.log4j2.xml

 1 <?xml version="1.0" encoding="UTF-8"?>  
 2   
 3 <Configuration status="off" monitorInterval="1800">  
 4   
 5     <properties>  
 6         <property name="LOG_HOME">/opt/logs/hafiz/log4j2Demo/logs</property>  
 7         <property name="ERROR_LOG_FILE_NAME">error</property>  
 8     </properties>  
 9   
10   
11     <Appenders>  
12         <Console name="Console" target="SYSTEM_OUT">  
13             <PatternLayout pattern="%d %-5p (%F:%L) - %m%n" />  
14         </Console>  
15   
16         <RollingRandomAccessFile name="ErrorLog"  
17                                  fileName="${LOG_HOME}/${ERROR_LOG_FILE_NAME}.log"  
18                                  filePattern="${LOG_HOME}/${ERROR_LOG_FILE_NAME}.log.%d{yyyy-MM-dd}.gz">  
19             <PatternLayout  
20                     pattern="%d %-5p (%F:%L) - %m%n"/>  
21             <Policies>  
22                 <TimeBasedTriggeringPolicy/>  
23                 <SizeBasedTriggeringPolicy size="100 MB"/>  
24             </Policies>  
25             <DefaultRolloverStrategy max="20"/>  
26         </RollingRandomAccessFile>  
27   
28     </Appenders>  
29   
30     <Loggers>  
31         <!-- 3rdparty Loggers -->  
32         <logger name="org.springframework.core" level="info">  
33         </logger>  
34         <logger name="org.springframework.beans" level="info">  
35         </logger>  
36         <logger name="org.springframework.context" level="info">  
37         </logger>  
38         <logger name="org.springframework.web" level="info">  
39         </logger>  
40   
41         <logger name="com.hafiz.www.controller" level="error" includeLocation="true" additivity="false">  
42             <appender-ref ref="ErrorLog"/>  
43             <appender-ref ref="Console"/>  
44         </logger>  
45   
46         <root level="info" includeLocation="true">  
47             <appender-ref ref="Console"/>  
48         </root>  
49     </Loggers>  
50 </Configuration>

　　4.测试类UserController.java

 1 package com.hafiz.www.controller;
 2 
 3 import com.hafiz.www.po.UserEntity;
 4 import com.hafiz.www.service.UserService;
 5 import org.slf4j.Logger;
 6 import org.slf4j.LoggerFactory;
 7 import org.springframework.beans.factory.annotation.Autowired;
 8 import org.springframework.stereotype.Controller;
 9 import org.springframework.web.bind.annotation.RequestMapping;
10 import org.springframework.web.bind.annotation.RequestMethod;
11 import org.springframework.web.bind.annotation.ResponseBody;
12 
13 import java.util.ArrayList;
14 import java.util.List;
15 
16 /**
17  * Desc:用户信息控制器
18  * Created by hafiz.zhang on 2016/8/27.
19  */
20 @Controller
21 @RequestMapping("/user")
22 public class UserController {
23 
24     private static final Logger logger = LoggerFactory.getLogger(UserController.class);
25 
26     @Autowired
27     private UserService userService;
28 
29     @RequestMapping(value = "/all", method = RequestMethod.GET)
30     @ResponseBody
31     public List<UserEntity> getAllUsers(){
32         logger.info("[GET] /user/all getAllUsers");
33         List<UserEntity> list = userService.getAllUsers();
34         logger.debug("This is log of level of debug");
35         logger.trace("log4j2 Demo");
36         logger.error("哎呀，出错啦~");
37         return list;
38     }
39 }

注意：在JVM启动参数中增加 -DLog4jContextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector 开启异步日志.

三、小问题：

　　项目不打印日志并且报：SLF4J: Class path contains multiple SLF4J bindings.主要问题在于在项目中既存在slf4j-log4j12的jar包又存在log4j-slf4j-impl的jar包，导致出现了两个打印日志实现类，所以slf4j门面不知道具体应该使用哪一个进行输出日志，所以导致不打印日志。

　　因为我之前是log4j 1.x，并且我在web.xml里面指定了log4j.properties文件的位置，第一次运行项目，忘了修改其值为log4j2.xml，出现了"Context [] startup failed due to previous errors"的错误，导致项目启动不起来，web.xml中修改为如下方式以后就正常了。

1 <context-param>
2     <param-name>log4jConfiguration</param-name>
3     <param-value>/WEB-INF/classes/log4j2.xml</param-value>
4  </context-param>

http://www.cnblogs.com/hafiz/p/6160298.html

JIESA

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
复制链接

分享到 QQ

分享到新浪微博

扫一扫

专栏目录