关闭

log4j.properties参数

标签: javalog4j
58人阅读 评论(0) 收藏 举报
分类:

在程序的开发过程中,我们通常以日志的形式程序的运行信息。最简单可以直接使用程序语言中支持的文件操作语句进行输出。但是,这样的输出方式不便于控制输出的格式,也不便于周期性地保存日志到文件中,更不便于滚动日志文件。而log4j一款可以帮助我们高效处理日志的工具,可以很方便的帮我们完成以上任务。

下面我们介绍下log4j中的重要参数:

0. Log的级别和配置文件格式

log的级别可以分为五种:
debug(调试信息)、
info(一般信息)、
warn(警告信息)、
error(错误信息)、
fatal(致命错误信息)。
从上往下,级别越来预高。

Log4j支持两种配置文件格式:
一种是XML格式的文件,一种是java属性文件log4j.properties。

后文的内容以我常用的log4j.properties形式为例进行说明。

1. 配置根Logger

Logger 负责处理日志记录的大部分操作,其语法为:

  log4j.rootLogger = [ level ] , appenderName1, appenderName2, …  

level : 是日志记录的优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者我们自定义的级别。 可以理解成这个参数配置了日志输出的阈值,当需要输出的日志级别高于当前这个level时,才会真正的输出到对应的appenderName

appenderName:就是指定日志信息输出目的地的名称, 这些名字可以根据自己的喜好来命名

举个例子:
假设我们有如下跟Logger

log4j.rootLogger=info,A1,B2,C3   

它表示当前的日志阈值时info级别,将不小于当前级别的日志输出到三个appender中即A1,B2,C3中

2. 配置日志信息输出目的地 Appender

Appender 负责控制日志记录操作的输出,其语法为:

log4j.appender.appenderName = fully.qualified.name.of.appender.class    

其中 fully.qualified.name.of.appender.class 有以下几种:

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

我们下面来详细讲讲这4中Appender:

2.1 org.apache.log4j.ConsoleAppender(控制台)

该选项有如下几个参数可以设置:

Threshold=WARN : 指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
Target=System.err: 默认情况下是:System.out,指定输出控制台

2.2 org.apache.log4j.FileAppender(文件)

该选项有如下几个参数可以设置:

Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意味着着所有的消息都会被立即输出。
File=mylog.txt:指定消息输出到mylog.txt文件。
Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。

2.3 org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)

该选项有如下几个参数可以设置:
Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
File=a.log:指定消息输出到a.log文件,默认是从web服务器的根路径开始。
Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
DatePattern=.yyyy-ww:每周滚动一次文件,即每周产生一个新的文件。

当然也可以指定按月、周、天、时和分。即对应的格式如下:
.yyyy-MM: 每月
.yyyy-ww: 每周
.yyyy-MM-dd: 每天
.yyyy-MM-dd-a: 每天两次
.yyyy-MM-dd-HH: 每小时
.yyyy-MM-dd-HH-mm: 每分钟

2.4 org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)

可通过log4j.appender.appenderName.MaxFileSize=200KB设置文件大小
该选项有如下几个参数可以设置:

Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意味着所有的消息都会被立即输出。
File=test.log:指定消息输出到test.log文件,默认是当前目录的根路径开始。
Append=false:默认值是true,即将消息追加到指定文件中,false指将消息覆盖指定的文件内容。
MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到test.log.1文件的形式。
MaxBackupIndex=2:指定可以产生的滚动文件的最大数。

2.5 org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)

举个例子

log4j.appender.A=org.apache.log4j.DailyRollingFileAppender  log4j.appender.A.File=/home/jacknichao/logs/test.log 

3. 配置日志信息的格式(布局)Layout

Layout参数主要负责格式化Appender的输出,控制内容的格式,其语法为:

log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class  

其中”fully.qualified.name.of.layout.class” 有以下几种形式可选:

3.1 org.apache.log4j.HTMLLayout(以HTML表格形式布局)

该选项有如下几个参数可以设置
LocationInfo=true:默认值是false,输出java文件名称和行号
Title=myProdctfile: 默认值是 Log4J Log Messages.

3.2 org.apache.log4j.PatternLayout(可以灵活地指定布局模式)

该选项有如下几个参数可以设置

可以一般化的写成如下的模式:
ConversionPattern=%m%n :指定怎样格式化指定的消息

其中%m%n等符号所代表的含义如下:
%p: 输出日志信息优先级,即DEBUG,INFO,WARN,ERROR,FATAL,
%d: 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,
比如:%d{yyyy-MM-dd HH:mm:ss,SSS},输出类似:2017-10-10 10:10:10,100
%r: 输出自应用启动到输出该log信息耗费的毫秒数
%c: 输出日志信息所属的类目,通常就是所在类的全名
%t: 输出产生该日志事件的线程名
%l: 输出日志事件的发生位置,相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java:10)
%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
%%: 输出一个”%”字符
%F: 输出日志消息产生时所在的文件名称
%L: 输出代码中的行号
%m: 输出代码中指定的消息,产生的日志具体信息
%n: 输出一个回车换行符,Windows平台为”\r\n”,Unix平台为”\n”输出日志信息换行
可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如:
%20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,默认的情况下右对齐。
%-20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,”-“号指定左对齐。
%.30c:指定输出category的名称,最大的宽度是30,如果category的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。
%20.30c:如果category的名称小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边交远销出的字符截掉。

3.3 org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)

3.4 org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)

4. 其他

log4j.logger.com.nichao =DEBUG
指定com.nichao包下的所有类的等级为DEBUG。

log4j.logger.com.nichao.jmetal=ERROR
log4j.logger.com.nichao.tools=ERROR
这两句是把这两个包下出现的错误的等级设为ERROR

0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:8412次
    • 积分:326
    • 等级:
    • 排名:千里之外
    • 原创:24篇
    • 转载:1篇
    • 译文:0篇
    • 评论:2条
    文章分类