log4j的基本使用和参数设定

1、简介

apache的一个开放源代码项目。

精确控制日志的输出,包括输出的格式,输出的目的地,输出的过滤(不同级别日志的输出)等。

配置简单,不需要在代码中配置环境,支持两种配置文件格式,XML和Java特性文件(键=值,常见的.properties),常用后者如 log4j.properties

maven 中央仓库:http://www.mvnrepository.com/artifact/log4j/log4j


2、核心组件

Log4j中有三个主要的组件,它们分别是 Logger、Appender和Layout。

Log4j 允许开发人员定义多个Logger,每个Logger拥有自己的名字,Logger之间通过名字来表明隶属关系。有一个Logger称为Root,它永远存在,且不能通过名字检索或引用,可以通过Logger.getRootLogger()方法获得,其它Logger通过 Logger.getLogger(String name)方法。

Appender则是用来指明将所有的log信息存放到什么地方,Log4j中支持多种appender,如 console、files、GUI components、NT Event Loggers等,一个Logger可以拥有多个Appender,也就是你既可以将Log信息输出到屏幕,同时存储到一个文件中。

Layout的作用是控制Log信息的输出方式,也就是格式化输出的信息。

Log4j中将要输出的Log信息定义了5种级别,依次为DEBUG、INFO、WARN、ERROR和FATAL,当输出时,只有级别高过配置中规定的级别的信息才能真正的输出,这样就很方便的来配置不同情况下要输出的内容,而不需要更改代码。

2.1 Logger

公共类Logger, 负责处理日志记录的大部分操作。

日志记录器(Logger)将只输出那些级别高于或等于它的级别的信息。如果没有设置日志记录器(Logger)的级别,那么它将会继承最近的祖先的级别。

例如在包com.foo.bar中创建一个日志记录器(Logger)并且没有设置级别,那它将会继承在包com.foo中创建的日志记录器(Logger)的级别。如果在com.foo中没有创建日志记录器(Logger)的话,那么在com.foo.bar中创建的日志记录器(Logger)将继承root日志记录器(Logger)的级别。

可以为日志指定不同的级别,级别从低到高支持以下几种:

ALL     打开所有日志
DEBUG     细粒度信息事件,对调试应用程序是非常有帮助的    
INFO     粗粒度信息事件,突出强调应用程序的运行过程    
WARN     可能出现潜在错误的情形    
ERROR     虽然发生错误事件,但仍然不影响系统的继续运行    
FATAL     指出每个严重的错误事件将会导致应用程序的退出
OFF     关闭所有日志

比较常用的Logger创建方法,就是根据类名实例化一个静态的全局日志记录器:

  1. static Logger logger = Logger.getLogger(test.class);

日志记录器都可以用下面方法设置级别:

  1. logger.setLevel((Level)Level.WARN);

当然,这是代码设置的方式。我们刚才提到过,可以使用配置文件的方式进行配置,那么我们后面会提到。

2.2 Appender

公共接口Appender,负责控制日志记录操作的输出。

下面是API中提供的输出方式(常用的见红字),也可以自己实现Appender接口,创建以自己的方式进行日志输出的Appender:

ConsoleAppender 使用用户指定的布局(layout)输出日志事件到System.out或者 System.err。默认的目标是System.out
FileAppender 把日志事件写入一个文件
DailyRollingFileAppender 扩展FileAppender,因此多个日志文件可以以一个用户选定的频率进行循环日志记录
RollingFileAppender 扩展FileAppender,备份容量达到一定大小的日志文件
WriterAppender 根据用户的选择把日志事件写入到Writer或者OutputStream
SMTPAppender 当特定的日志事件发生时,一般是指发生错误或者重大错误时,发送一封邮件
SocketAppender 给远程日志服务器(通常是网络套接字节点)发送日志事件(LoggingEvent)对象
SocketHubAppender 给远程日志服务器群组(通常是网络套接字节点)发送日志事件(LoggingEvent)对象
SyslogAppender 给远程异步日志记录的后台精灵程序(daemon)发送消息
TelnetAppender 一个专用于向只读网络套接字发送消息的log4j appender

2.3 Layout

公共抽象类,负责格式化Appender的输出。

Appender必须使用一个与之相关联的 Layout,这样它才能知道怎样格式化它的输出。

log4j常见的三种类型的Layout:

HTMLLayout 格式化日志输出为HTML表格
PatternLayout 根据指定的转换模式格式化日志输出,或者如果没有指定任何转换模式,就使用默认的转换模式
SimpleLayout 以一种非常简单的方式格式化日志输出,它打印级别 Level,然后跟着一个破折号“-“ ,最后才是日志消息

3、配置文件的设置

3.1 根 Logger

  1. log4j.rootLogger = [ level ] , appenderName, appenderName, ...
  • level  优先级,ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF
  • appenderName  指定日志信息输出到哪个地方。您可以同时指定多个输出目的地

3.2 某个包或类的 Logger

之前我们提到过,日志记录器(Logger)将只输出那些级别高于或等于它的级别的信息,如果没有设置日志记录器(Logger)的级别,那么它将会继承最近的祖先的级别。

假如你在配置文件中没有针对有些包或者类进行单独的级别设置,那么它会直接继承最近祖先的级别,依次往上如果都没有那么最终会继承 RootLogger 根日志记录器的级别。

配置语法如下:

  1. log4j.logger.xxx.xxx.xxx=level

这里的xxx.xxx可以是包,比如com.greejoy;也可以是具体的类,比如com.greejoy.action.LoginAction

示例:

  1. log4j.rootLogger=WARN,A
  2. log4j.logger.com.opensymphony.xwork2.interceptor.TimerInterceptor=DEBUG
  3. log4j.appender.A=org.apache.log4j.ConsoleAppender
  4. log4j.appender.A.layout=org.apache.log4j.PatternLayout
  5. log4j.appender.A.layout.ConversionPattern==%-d{yyyy-MM-dd HH:mm:ss} [%p]-[%c] %m%n

假如现在有类indiv.dulk.wechat.InitWechatServlet,此处没有配置level,默认继承到了根Logger的level,即WARN。此时如果类中有log输出语句如下:

  1. log.info("微信accessToken刷新 " + WechatAPI.getAccessToken());

最终在控制台是不会输出的,因为INFO的等级比WARN等级低,不会输出。如果我们改下配置文件:

  1. log4j.rootLogger=WARN,A
  2. log4j.logger.indiv.dulk=DEBUG
  3. log4j.logger.com.opensymphony.xwork2.interceptor.TimerInterceptor=DEBUG
  4. log4j.appender.A=org.apache.log4j.ConsoleAppender
  5. log4j.appender.A.layout=org.apache.log4j.PatternLayout
  6. log4j.appender.A.layout.ConversionPattern==%-d{yyyy-MM-dd HH:mm:ss} [%p]-[%c] %m%n

定义了indiv.dulk包level为DEBUG,indiv.dulk.wechat.InitWechatServlet没有单独设置level,往上找最终继承indiv.dulk的level,即DEBUG,此时刚才的log输出语句就会输出在控制台上。因为INFO的等级比DEBUG的等级高。

回顾下等级大小:

ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF

需要注意的是:单独配置的类或包,都是受全局管理的,意思就是说,除了满足单独配置Logger要求的日志会输出,同时满足根配置Logger的日志也会输出。

这就给我们带来了麻烦,假如都设置在控制台输出,只是单独配置的Logger格式设定不一样,那么在控制台你会看到内容相仿的两条日志输出。

也就是说,假如我们有如下配置文件,最终会出现如下的情况:

  1. log4j.rootLogger=WARN,A
  2. log4j.logger.indiv.dulk.wechat=DEBUG,wechat
  3. log4j.appender.A=org.apache.log4j.ConsoleAppender
  4. log4j.appender.A.layout=org.apache.log4j.PatternLayout
  5. log4j.appender.A.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]-[%c] %m%n
  6. log4j.appender.wechat=org.apache.log4j.ConsoleAppender
  7. log4j.appender.wechat.layout=org.apache.log4j.PatternLayout
  8. log4j.appender.wechat.layout.ConversionPattern=[%p]-[%c] %m%n

这显然不是我们想要的,所以需要改下配置,让指定的包不受全局管理:

  1. log4j.rootLogger=WARN,A
  2. log4j.logger.indiv.dulk.wechat=DEBUG,wechat
  3. #不受全局管理
  4. log4j.additivity.indiv.dulk.wechat=false
  5. log4j.appender.A=org.apache.log4j.ConsoleAppender
  6. log4j.appender.A.layout=org.apache.log4j.PatternLayout
  7. log4j.appender.A.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]-[%c] %m%n
  8. log4j.appender.wechat=org.apache.log4j.ConsoleAppender
  9. log4j.appender.wechat.layout=org.apache.log4j.PatternLayout
  10. log4j.appender.wechat.layout.ConversionPattern=[%p]-[%c] %m%n

这样,就得到了我们想要的结果。

3.3 日志输出地址 Appender

  1. log4j.appender.appenderName = fully.qualified.name.of.appender.class (有资格的appender类的全名)
  2. log4j.appender.appenderName.option1 = value1
  3. log4j.appender.appenderName.option = valueN

Log4j提供的appender有以下几种:

  • org.apache.log4j.ConsoleAppender(控制台)
  • org.apache.log4j.FileAppender(文件)
  • org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
  • org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
  • org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)

3.4 日志输出格式 Layout

  1. log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
  2. log4j.appender.appenderName.layout.option1 = value1
  3. log4j.appender.appenderName.layout.option = valueN

Log4j提供的layout有以下几种:

  • org.apache.log4j.HTMLLayout(以HTML表格形式布局)
  • org.apache.log4j.PatternLayout(可以灵活地指定布局模式)
  • org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)
  • org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)

打印的参数设置示例:

  1. log4j.appender.log.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t ] %m%n
  • %m   输出代码中指定的消息
  • %p   输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
  • %r   输出自应用启动到输出该log信息耗费的毫秒数
  • %c   输出所属的类目,通常就是所在类的全名
  • %t   输出产生该日志事件的线程名
  • %n   输出一个回车换行符,Windows平台为“/r/n”,Unix平台为“/n”
  • %d   输出日志时间点的日期或时间。默认格式为ISO8601,也可以在其后指定格式。比如:%d{yyy MMM dd HH:mm:ss , SSS},输出类似:2002年10月18日 22:10:28, 921
  • %l   输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数

3.5 配置示例

示例1:

  1. ### 设置###
  2. log4j.rootLogger = debug,stdout,D,E
  3. ### 输出信息到控制台 ###
  4. log4j.appender.stdout = org.apache.log4j.ConsoleAppender
  5. log4j.appender.stdout.Target = System.out
  6. log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
  7. log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
  8. ### 输出DEBUG 级别以上的日志到=E://logs/error.log ###
  9. log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
  10. log4j.appender.D.File = E://logs/log.log
  11. log4j.appender.D.Append = true
  12. log4j.appender.D.Threshold = DEBUG
  13. log4j.appender.D.layout = org.apache.log4j.PatternLayout
  14. log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
  15. ### 输出ERROR 级别以上的日志到=E://logs/error.log ###
  16. log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
  17. log4j.appender.E.File =E://logs/error.log
  18. log4j.appender.E.Append = true
  19. log4j.appender.E.Threshold = ERROR
  20. log4j.appender.E.layout = org.apache.log4j.PatternLayout
  21. log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

注意:例如 log4j.appender.log.Threshold = ERROR 表示在总控开关的前提,觉得精确,只有达到这个级别的日志才被记录到这个文件中

示例2:

  1. #指定目录下包下的日志信息都存放到数据库
  2. log4j.logger.database=DEBUG,oracledb
  3. log4j.appender.oracledb=org.apache.log4j.jdbc.JDBCAppender
  4. log4j.appender.oracledb.Driver=oracle.jdbc.driver.OracleDriver
  5. log4j.appender.oracledb.URL=jdbc:oracle:thin:@192.168.20.92:1521:chshsid(切忌此处为sid而不是数据库名)
  6. log4j.appender.oracledb.user=scott
  7. log4j.appender.oracledb.password=tiger
  8. #log4j.appender.encoding=utf-8
  9. log4j.appender.oracledb.sql=INSERT INTO enter_ora_log4j VALUES (‘%d{yyyy-MM-dd HH:mm:ss}‘, ‘%t‘, ‘%p‘, ‘%l‘, ‘%m‘)
  10. log4j.appender.oracledb.layout=org.apache.log4j.PatternLayout

示例3:

  1. #指定目录下的java类的日志信息都存放到该目录下
  2. log4j.logger.com.cuigq.TestError=DEBUG,R2
  3. log4j.appender.R2=org.apache.log4j.DailyRollingFileAppender
  4. log4j.appender.R2.File=d:/loginfo/html.html
  5. #log4j.appender.R2.MaxFileSize=500KB
  6. #log4j.appender.R2.MaxBackupIndex=1
  7. log4j.appender.R2.layout=org.apache.log4j.HTMLLayout
  8. #log4j.appender.R2.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c] [%p] - %m%n

示例4:

  1. #指定目录下包下的日志信息都存放到该目录下
  2. log4j.logger.cn.com.cuigq.Theard=DEBUG,R1
  3. log4j.appender.R1=org.apache.log4j.RollingFileAppender
  4. log4j.appender.R1.File=d:/loginfo/iamSystem1.log
  5. log4j.appender.R1.MaxFileSize=500KB
  6. log4j.appender.R1.MaxBackupIndex=1
  7. log4j.appender.R1.layout=org.apache.log4j.PatternLayout
  8. log4j.appender.R1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c] [%p] - %m%n

4、基本使用 和 Web下的使用

4.1 基本步骤流程

4.1.1 得到日志记录器Logger

使用Log4j,第一步就是获取日志记录器,这个记录器将负责控制日志信息。其语法为:

  1. public static Logger getLogger( String name)

通过指定的名字获得记录器,如果必要的话,则为这个名字创建一个新的记录器。Name一般取本类的名字,比如:

  1. static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName ())

4.1.2 读取配置文件

当获得了日志记录器之后,第二步将配置Log4j环境,其语法为:

  1. BasicConfigurator.configure (): 自动快速地使用缺省Log4j环境
  2. PropertyConfigurator.configure (String configFilename) :读取使用Java的特性文件编写的配置文件
  3. DOMConfigurator.configure ( String filename ) :读取XML形式的配置文件

4.1.3 插入记录信息

当上两个必要步骤执行完毕,您就可以轻松地使用不同优先级别的日志记录语句插入到您想记录日志的任何地方,其语法如下:

  1. Logger.debug ( Object message ) ;
  2. Logger.info ( Object message ) ;
  3. Logger.warn ( Object message ) ;
  4. Logger.error ( Object message ) ;

4.2 入门使用

不详细展开描述,详见参考:

4.3 Web使用

web应用的log4j使用基本上都采用:新建一个servlet,这个servlet在init函数中为log4j执行配置,一般就是读入配置文件。

1、在web.xml中配置servlet,同时设定load-on-startup为0。配置文件位置在web.xml中配置一个param即可,路径一般是相对于web的root目录。

  1. <servlet>
  2. <servlet-name>InitLog4jServlet</servlet-name>
  3. <servlet-class>indiv.dulk.wechat.init.InitLog4jServlet</servlet-class>
  4. <init-param>
  5. <param-name>propertiesLocation</param-name>
  6. <param-value>classpath:log4j.properties</param-value>
  7. </init-param>
  8. <load-on-startup>0</load-on-startup>
  9. </servlet>

2、这个servlet配置log4j就是读出配置文件,然后调用configure函数。这里有两个问题:一、需要知道文件在哪里;二、需要正确的文件类型(文件类型一般有两种,一个是Java的property文件,另一种是xml文件)

  1. public class InitLog4jServlet extends HttpServlet{
  2. /**
  3. * Servlet初始化的执行方法,用以加载log4j配置文件
  4. *
  5. * @throws ServletException
  6. */
  7. @Override
  8. public void init() throws ServletException {
  9. System.out.println("*** Log4jInitServlet正在初始化log4j日志设置信息 ***");
  10. String log4jLocation = getInitParameter("propertiesLocation");
  11. if (log4jLocation == null) {
  12. System.err.println("*** 没有找到log4j的properties配置文件,使用缺省log4j环境初始化 ***");
  13. BasicConfigurator.configure();
  14. } else {
  15. String webAppPath = getServletContext().getRealPath("/");
  16. String log4jRealLocation = webAppPath + log4jLocation;
  17. File log4jFile = new File(log4jRealLocation);
  18. if (log4jFile.exists()) {
  19. System.out.println("*** 使用" + log4jRealLocation + "进行log4j环境初始化 ***");
  20. PropertyConfigurator.configure(log4jRealLocation);
  21. } else {
  22. System.err.println("*** " + log4jRealLocation + "文件未找到,使用缺省log4j环境初始化 ***");
  23. BasicConfigurator.configure();
  24. }
  25. }
  26. }
  27. }

3、完成设置后在其他类中就可以获取Logger来进行日志打印

  1. public class InitWechatServlet extends HttpServlet{
  2. private static Logger log = Logger.getLogger(InitWechatServlet.class);
  3. /**
  4. * 刷新的间隔时间(单位:毫秒),默认为1h,可以在web.xml自定义配置
  5. */
  6. private long period = 3600000;
  7. /**
  8. * 时间间隔时需要执行的任务内容
  9. */
  10. private TimerTask timerTask = new TimerTask() {
  11. @Override
  12. public void run() {
  13. //获取最新的access_token并设定到WeChatAPI类中的静态属性中去
  14. WechatAPI.setAccessToken(WechatUtil.getNewAccessToken());
  15. log.info("微信accessToken刷新 " + WechatAPI.getAccessToken());
  16. }
  17. };
  18. }

5、参考链接

时间: 2024-10-12 05:34:09

log4j的基本使用和参数设定的相关文章

编写高质量代码改善C#程序的157个建议[优先考虑泛型、避免在泛型中声明静态成员、为泛型参数设定约束]

前言 泛型并不是C#语言一开始就带有的特性,而是在FCL2.0之后实现的新功能.基于泛型,我们得以将类型参数化,以便更大范围地进行代码复用.同时,它减少了泛型类及泛型方法中的转型,确保了类型安全.委托本身是一种引用类型,它保存的也是托管堆中对象的引用,只不过这个引用比较特殊,它是对方法的引用.事件本身也是委托,它是委托组,C#中提供了关键字event来对事件进行特别区分.一旦我们开始编写稍微复杂的C#代码,就肯定离不开泛型.委托和事件.本章将针对这三个方面进行说明. 这里也有一篇之前我对泛型的简

linux笔记 14课linux内核参数设定及内核编译安装

1.linux内核参数设定及initramfs的生成 2.linux内核编译安装 一.回顾启动流程 post--引导次序(BIOS)--bootloader(MBR)--Kernel+ramdisk--根切换(footfs)--/sbin/init(配置文件)配置文件:设置默认运行级别--制定系统初始化脚本进行系统初始化--启动服务(/etc/rc.d/re#.d,/etc/rc.d/init.d)--/etc/rc.d/rc.local--设置Ctrlaltdel组合键--启动终端(minge

解决JDeveloper运行慢的设置/BPM/SOA Server JVM参数设定

最近在使用 Jdeveloper 10.1.3.3 版本时发现速度奇慢无比,后经Google,发现如下解决方案:在 jdev.conf 文件的末尾加上如下两行,速度即可得到显着的提高, jdev.conf 文件位于 D:\jdev\jdevbin\jdev\bin 目录之下. AddVMOption -Dsun.java2d.noddraw=trueAddVMOption -Dsun.java2d.ddoffscreen=false [Oracle BPM/SOA 基础] BPM/SOA Ser

Unity3d之树木创建的参数设定

Unity3d之树木创建的参数设定 通常Unity3d创建树木经常会创建出很多奇葩的种类=_=,以下是创建出比较正常树木的基本参数 1:> 基本树干形状建立: 选择根?建立分枝干?设置分支干Distribution 为 Whorled ? 设置 Frequency 为 30. 2:> 提高主枝干开始长出分枝干的高度: 选择分枝干节点,打开Distribution 属性的曲线编辑器,设置曲线. 3:> 使得分枝干向上生长: 选择分枝干节点,调节Growth Angle 的值为0.6 4:&

编写高质量代码改善C#程序的157个建议——建议34:为泛型参数设定约束

建议34:为泛型参数设定约束 “约束”这个词可能会引起歧义,有些人肯能认为对泛型参数设定约束是限制参数的使用,实际情况正好相反.没有“约束”的泛型参数作用很有限,倒是“约束”让泛型参数具有了更多的行为和属性. 查看下面代码,我们会发现参数t1或参数t2仅仅具有object的属性和行为,所以几乎不能再方法中对它们进行任何操作: class SalaryComputer { public int Cpmpare<T>(T t1, T t2) { return 0; } } class Salary

Linux下实现视频读取(二)---camera参数设定

Camera的可设置项极多,V4L2 支持了不少.但Sam之前对这些设置的用法和涵义都是在看videodev2.h中边看边理解,感觉非常生涩.直到写这篇blog时,才发现v4l2有专门的SPEC来说明: http://www.linuxtv.org/downloads/legacy/video4linux/API/V4L2_API/spec-single/v4l2.html 但也基本没有时间仔细看了.先把自己看头文件看出的一些东西记录在这里吧.以实际设置过程为顺序谈谈V4L2 设置. 1. 查询

Spark配置参数

以下是整理的Spark中的一些配置参数,官方文档请参考Spark Configuration. Spark提供三个位置用来配置系统: Spark属性:控制大部分的应用程序参数,可以用SparkConf对象或者Java系统属性设置 环境变量:可以通过每个节点的conf/spark-env.sh脚本设置.例如IP地址.端口等信息 日志配置:可以通过log4j.properties配置 Spark属性 Spark属性控制大部分的应用程序设置,并且为每个应用程序分别配置它.这些属性可以直接在SparkC

深入理解JVM虚拟机10:JVM常用参数以及调优实践

微信公众号[Java技术江湖]一位阿里 Java 工程师的技术小站.作者黄小斜,专注 Java 相关技术:SSM.SpringBoot.MySQL.分布式.中间件.集群.Linux.网络.多线程,偶尔讲点Docker.ELK,同时也分享技术干货和学习经验,致力于Java全栈开发!(关注公众号后回复”Java“即可领取 Java基础.进阶.项目和架构师等免费学习资料,更有数据库.分布式.微服务等热门技术学习视频,内容丰富,兼顾原理和实践,另外也将赠送作者原创的Java学习指南.Java程序员面试指

log4j与log4j2

一 log4j log4j是Apache的一个开源项目,用于输出程序的运行状况. 相比于在程序内部添加System.out.println()做日志输出,log4j有如下优点: 可以设定信息输出的目的地,常用的有控制台.文件等. 根据日志的严重程度,将日志分为6级,从高到低依次是:fatal.error.warn.info.debug.trace. 可以设定日志的输出格式,包含动态的信息. 可以开启或者关闭信息输出. 在java代码获取日志对象并输出: Logger logger=Logger.