开发日志解决方案

来源:互联网 发布:淘宝怎样设置秒杀 编辑:程序博客网 时间:2024/05/17 04:45

日志解决方案

1、org.apache.commons.logging.Log方案

如果对于commons-loging、log4j、slf4j、LogBack等都已经非常清楚了,可以忽略本文。几次解决日志冲突问题时对这几个概念的简单总结,希望对这块基础没有理解透的同学能有所帮助,当然如果对这块有更深刻理解的同学,也贡献出自己的知识和见解。

一、    概念

Commons-logging:apache最早提供的日志的门面接口。避免和具体的日志方案直接耦合。类似于JDBC的api接口,具体的的JDBC driver实现由各数据库提供商实现。通过统一接口解耦,不过其内部也实现了一些简单日志方案。

Log4j:经典的一种日志解决方案。内部把日志系统抽象封装成Logger、appender、pattern等实现。我们可以通过配置文件轻松的实现日志系统的管理和多样化配置。

Slf4j: 全称为Simple Logging Facade for JAVA:java简单日志门面。是对不同日志框架提供的一个门面封装。可以在部署的时候不修改任何配置即可接入一种日志实现方案。和commons-loging应该有一样的初衷。个人感觉设从计上更好一些,没有commons那么多潜规则。同时有两个额外特点:

1. 能支持多个参数,并通过{}占位符进行替换,避免老写logger.isXXXEnabled这种无奈的判断,带来性能提升见:http://www.slf4j.org/faq.html#logging_performance。

2.OSGI机制更好兼容支持

一图胜千言,官网上的一个图:


 

从上图可以发现,选择还是很多的。

Logback: LOGBack作为一个通用可靠、快速灵活的日志框架,将作为Log4j的替代和SLF4J组成新的日志系统的完整实现。官网上称具有极佳的性能,在关键路径上执行速度是log4j的10倍,且内存消耗更少。具体优势见:

http://logback.qos.ch/reasonsToSwitch.html

二、    常见日志方案和注意事项

1.Commons-logging+log4j:经典的一个日志实现方案。出现在各种框架里。如spring、webx、ibatis等等。直接使用log4j即可满足我们的日志方案。但是一般为了避免直接依赖具体的日志实现,一般都是结合commons-logging来实现。常见代码如下:

import org.apache.commons.logging.Log;

import org.apache.commons.logging.LogFactory;

private static Log logger = LogFactory.getLog(CommonsLoggingTest.class);

代码上,没有依赖任何的log4j内部的类。那么log4j是如何被装载的?

Log是一个接口声明。LogFactory的内部会去装载具体的日志系统,并获得实现该Log接口的实现类。而内部有一个Log4JLogger实现类对Log接口同时内部提供了对log4j logger的代理。LogFactory内部装载日志系统流程:

1.  首先,寻找org.apache.commons.logging.LogFactory属性配置

2.  否则,利用JDK1.3开始提供的service发现机制,会扫描classpah下的META-INF/services/org.apache.commons.logging.LogFactory文件,若找到则装载里面的配置,使用里面的配置。

3.  否则,从Classpath里寻找commons-logging.properties,找到则根据里面的配置加载。

4.  否则,使用默认的配置:如果能找到Log4j则默认使用log4j实现,如果没有则使用JDK14Logger实现,再没有则使用commons-logging内部提供的SimpleLog实现。

从上述加载流程来看,如果没有做任何配置,只要引入了log4j并在classpath配置了log4j.xml,则commons-logging就会使log4j使用正常,而代码里不需要依赖任何log4j的代码。

 

 

2.Commons-logging+log4j+slf4j

如果在原有commons-logging系统里,如果要迁移到slf4j,使用slf4j替换commons-logging,也是可以做到的。原理使用到了上述commons-logging加载的第二点。需要引入Org.slf4j.jcl-over-slf4j-1.5.6.jar。这个jar包提供了一个桥接,让底层实现是基于slf4j。原理是在该jar包里存放了配置META-INF/services/org.apache.commons.logging.LogFactory =org.apache.commons.logging.impl.SLF4JLogFactory,而commons-logging在初始化的时候会找到这个serviceId,并把它作为LogFactory。

完成桥接后,那么那么简单日志门面SLF4J内部又是如何来装载合适的log呢?

原理是SLF4J会在编译时会绑定import org.slf4j.impl.StaticLoggerBinder;该类里面实现对具体日志方案的绑定接入。任何一种基于slf4j的实现都要有一个这个类。如:

org.slf4j.slf4j-log4j12-1.5.6:提供对log4j的一种适配实现。

Org.slf4j.slf4j-simple-1.5.6:是一种simple实现,会将log直接打到控制台。

……

那么这个地方就要注意了:如果有任意两个实现slf4j的包同时出现,那就有可能酿就悲剧,你可能会发现日志不见了、或都打到控制台了。原因是这两个jar包里都有各自的org.slf4j.impl.StaticLoggerBinder,编译时候绑定的是哪个是不确定的。这个地方要特别注意!!出现过几次因为这个导致日志错乱的问题。

 

 

3.Slf4j+logback

Slf4j和log4j作者都是同一个人。

Logback号称在性能各方面有很多优势,也很诱人。

直接使用SLf4j也很简单:

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

public class HelloWorld {
  public static void main(String[] args) {
    Logger logger = LoggerFactory.getLogger(HelloWorld.class);
    logger.info("Hello World");
  }
}

代码里也看不到任何具体日志实现方案的痕迹。

Logback没用过,看到过一些诱人介绍。具体大家可以去研究。logback。

注意事项

使用日志配置的时候一定要明白需求,同时避免冲突。

如使用SLF4j的时候为了避免冲突,一定要保障只有一种实现类jar包在里面。

当遇到日志错乱等问题时,可以从这几个方面来排查

  • 查看图片附件
二、slf4j方案

一. Log4j+commons-logging
 JAR包
commons-logging-1.1.jar
log4j-1.2.15.jar
 配置文件
commons-logging.properties
log4j.xml
 commons-logging.jar包读取commons-logging.properties中指定的log,自动加载日志配置
在commons-logging+log4j组合中commons-logging.properties指定的日志为:
org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JLogger
 log4j指定具体日志输出配置
 如果未选用commons-logging,可以在启动项目中,主动加载log4j的配置文件
二. Logback+slf4j
 JAR包
slf4j-api-1.5.2.jar
logback-classic-0.9.9.jar
logback-core-0.9.9.jar
 配置文件
Logback.xml
 logback的加载采用编码加载

Java代码  收藏代码
  1. String logbackCfg = "/config/logback.xml";  
  2. URL logURL = new ClassPathResource(logbackCfg).getURL();  
  3. ILoggerFactory loggerFactory = LoggerFactory.getILoggerFactory();  
  4. LoggerContext loggerContext = (LoggerContext) loggerFactory;  
  5. loggerContext.shutdownAndReset();  
  6. JoranConfigurator configurator = new JoranConfigurator();  
  7. configurator.setContext(loggerContext);  
  8. configurator.doConfigure(logURL);  

三. Slf4j+log4j
 JAR包
slf4j-api-1.5.2.jar
slf4j-log4j12-1.5.2.jar
log4j-1.2.15.jar
 配置文件
Logback.xml
四. Slf4j+logback+logback
注:这种情况下是项目中有log4j输出的日志以及logback数据的日志.老项目改造,log4j和logback共存的情况下.(当选用spring+slf4j+logback的时候,spring的日志输出是log4j的,这个时候采用这种配置.)
 JARbao
log4j-over-slf4j-1.5.2.jar
logback-classic-0.9.9.jar
logback-core-0.9.9.jar
slf4j-api-1.5.2.jar
 配置文件
Logback.xml
 配置加载
Java代码  收藏代码
  1. String logbackCfg = "/config/logback.xml";  
  2. URL logURL = new ClassPathResource(logbackCfg).getURL();  
  3. ILoggerFactory loggerFactory = LoggerFactory.getILoggerFactory();  
  4. LoggerContext loggerContext = (LoggerContext) loggerFactory;  
  5. loggerContext.shutdownAndReset();  
  6. JoranConfigurator configurator = new JoranConfigurator();  
  7. configurator.setContext(loggerContext);  
  8. configurator.doConfigure(logURL);  

五. Log4j配置文件示例
Java代码  收藏代码
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">  
  3. <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">  
  4.   
  5.     <!-- 控制台输出-->  
  6.     <appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">  
  7.         <param name="Target" value="System.out" />  
  8.         <param name="Threshold" value="INFO" />  
  9.         <layout class="org.apache.log4j.PatternLayout">  
  10.             <param name="ConversionPattern"  
  11.                 value="%d{yyyy-MM-dd HH:mm:ss sss}[%-p][%-c][line:%-L] \r\n  %m%n" />  
  12.         </layout>  
  13.   
  14. <!— 以下是过滤一些不需要输出的log信息 -->  
  15.         <filter class="org.apache.log4j.varia.StringMatchFilter">  
  16.             <param name="StringToMatch" value="new a seq no spend" />  
  17.             <param name="AcceptOnMatch" value="false" />  
  18.         </filter>  
  19.         <filter class="org.apache.log4j.varia.StringMatchFilter">  
  20.             <param name="StringToMatch" value="new hi[type=" />  
  21.             <param name="AcceptOnMatch" value="false" />  
  22.         </filter>  
  23.         <filter class="org.apache.log4j.varia.StringMatchFilter">  
  24.             <param name="StringToMatch" value="FileTransfer.execCommand()" />  
  25.             <param name="AcceptOnMatch" value="false" />  
  26.         </filter>  
  27.     </appender>  
  28.   
  29.     <!--文件输出 按照文件大小滚动文件-->  
  30.     <appender name="xxxx_file" class="org.apache.log4j.RollingFileAppender">  
  31.         <param name="Append" value="true" />  
  32.         <param name="Threshold" value="INFO" />  
  33.         <param name="File" value="xxxx.log" />  
  34.         <param name="MaxFileSize" value="100MB" />  
  35.         <param name="MaxBackupIndex" value="15" />  
  36.         <layout class="org.apache.log4j.PatternLayout">  
  37.             <param name="ConversionPattern"  
  38.                 value="%d{yyyy-MM-dd HH:mm:ss sss}[%-p][%-c][line:%-L] \r\n  %m%n" />  
  39.         </layout>  
  40.         <filter class="org.apache.log4j.varia.StringMatchFilter">  
  41.             <param name="StringToMatch" value="new a seq no spend" />  
  42.             <param name="AcceptOnMatch" value="false" />  
  43.         </filter>  
  44.         <filter class="org.apache.log4j.varia.StringMatchFilter">  
  45.             <param name="StringToMatch" value="new hi[type=" />  
  46.             <param name="AcceptOnMatch" value="false" />  
  47.         </filter>  
  48.         <filter class="org.apache.log4j.varia.StringMatchFilter">  
  49.             <param name="StringToMatch" value="FileTransfer.execCommand()" />  
  50.             <param name="AcceptOnMatch" value="false" />  
  51.         </filter>  
  52.     </appender>  
  53.       
  54.     <!-- 错误输出 过滤出错误日志信息-->  
  55.     <appender name="xxxx_error" class="org.apache.log4j.RollingFileAppender">  
  56.         <param name="Append" value="true" />  
  57.         <param name="Threshold" value="ERROR" />  
  58.         <param name="File" value="xxxx-error.log" />  
  59.         <param name="MaxFileSize" value="100MB" />  
  60.         <param name="MaxBackupIndex" value="4" />  
  61.         <layout class="org.apache.log4j.PatternLayout">  
  62.             <param name="ConversionPattern"  
  63.                 value="%d{yyyy-MM-dd HH:mm:ss sss}[%-p][%-c][line:%-L] \r\n  %m%n" />  
  64.         </layout>  
  65.     </appender>  
  66.      
  67.   <!-- 根loggr -->  
  68.     <root>  
  69.         <appender-ref ref="CONSOLE" />  
  70.         <appender-ref ref="xxxx_file" />  
  71.         <appender-ref ref="xxxx_file_error" />  
  72.     </root>  
  73. </log4j:configuration>  

六. Logback配置文件示例
Java代码  收藏代码
  1. <?xml version="1.0" encoding="UTF-8" ?>  
  2. <!DOCTYPE configuration>  
  3.   
  4. <configuration>  
  5.     <jmxConfigurator />  
  6.       
  7.     <!-- 控制台输出日志 -->  
  8.     <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">  
  9.         <layout class="ch.qos.logback.classic.PatternLayout">  
  10.             <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>  
  11.         </layout>  
  12.     </appender>  
  13.       
  14.     <!-- 文件输出日志 (文件大小策略进行文件输出,超过指定大小对文件备份)-->  
  15.     <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">  
  16.         <File>xxxx.log</File>  
  17.         <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">  
  18.             <FileNamePattern>xxxx.log.%i.bak</FileNamePattern>  
  19.             <MinIndex>1</MinIndex>  
  20.             <MaxIndex>12</MaxIndex>  
  21.         </rollingPolicy>  
  22.   
  23.         <triggeringPolicy  
  24.             class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">  
  25.             <MaxFileSize>100MB</MaxFileSize>  
  26.         </triggeringPolicy>  
  27.         <layout class="ch.qos.logback.classic.PatternLayout">  
  28.             <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</Pattern>  
  29.         </layout>  
  30.     </appender>  
  31.     
  32.     <appender name="FILE-ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">  
  33.          <filter class="ch.qos.logback.classic.filter.LevelFilter">  
  34.             <level>ERROR</level>  
  35.             <OnMismatch>DENY</OnMismatch>  
  36.             <OnMatch>ACCEPT</OnMatch>  
  37.         </filter>  
  38.           
  39.         <File>xxxx-err.log</File>  
  40.         <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">  
  41.             <FileNamePattern>xxxx-err.log.%i.bak</FileNamePattern>  
  42.             <MinIndex>1</MinIndex>  
  43.             <MaxIndex>3</MaxIndex>  
  44.         </rollingPolicy>  
  45.         <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">  
  46.             <MaxFileSize>100MB</MaxFileSize>  
  47.         </triggeringPolicy>  
  48.         <layout class="ch.qos.logback.classic.PatternLayout">  
  49.             <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</Pattern>  
  50.         </layout>  
  51.     </appender>  
  52.   
  53.   <!--这里指定logger name 是为jmx设置日志级别做铺垫 -->         
  54.     <logger name="com.xxx.xxx">  
  55.         <level value="INFO" />  
  56.         <appender-ref ref="STDOUT" />  
  57.         <appender-ref ref="FILE" />  
  58.         <appender-ref ref="FILE-ERROR" />  
  59.     </logger>  
  60.   
  61.   
  62.   
  63. </configuration>  


七. 相关简单说明
 Log4j
Log4j是Apache的一个开放源代码项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI组件、甚至是套接口服务 器、NT的事件记录器、UNIX Syslog守护进程等;用户也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,用户能够更加细致地控制日志的生成过程。这些可以通过一个 配置文件来灵活地进行配置,而不需要修改程序代码

 Slf4j
简单日记门面(Facade)SLF4J是为各种loging APIs提供一个简单统一的接口,从而使得最终用户能够在部署的时候配置自己希望的loging APIs实现。 Logging API实现既可以选择直接实现SLF4J接的loging APIs如: NLOG4J、SimpleLogger。也可以通过SLF4J提供的API实现来开发相应的适配器如Log4jLoggerAdapter、JDK14LoggerAdapter。

 Logback
Logback是由log4j创始人设计的又一个开源日记组件。logback当前分成三个模块:logback-core,logback- classic和logback-access。logback-core是其它两个模块的基础模块。logback-classic是log4j的一个 改良版本。此外logback-classic完整实现SLF4J API使你可以很方便地更换成其它日记系统如log4j或JDK14 Logging。logback-access访问模块与Servlet容器集成提供通过Http来访问日记的功能。


原创粉丝点击