log4j.properties参数

原创 2017年09月13日 16:27:53

在程序的开发过程中,我们通常以日志的形式程序的运行信息。最简单可以直接使用程序语言中支持的文件操作语句进行输出。但是,这样的输出方式不便于控制输出的格式,也不便于周期性地保存日志到文件中,更不便于滚动日志文件。而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

版权声明:本文为博主原创文章,未经博主允许不得转载。

相关文章推荐

VC++课程设计:动漫新番信息管理系统(MFC+数据库ODBC接口)+外加两个副作品

C++ MFC和SQL server实现,还有两个副作品,用HTML引擎写的拼图游戏和cocos2d写的界面管理系统 文档非常详细 非常个性化的信息管理系统,不止于增删改查,很多细节的处理,符合动漫宅...

c++结构体struct的一些例子

这篇博客为个人笔记,没有任何参考价值,只是为了方便自己日后复习,所写代码比较杂乱,甚至有错误的地方,如果你想获取什么知识,防止误导,请移步 #include using namespace std;...

log4j.properties参数详解word

  • 2009年07月20日 08:50
  • 38KB
  • 下载

log4j.properties配置详解.rtf

  • 2012年08月08日 11:29
  • 21KB
  • 下载

log4j.properties配置详解与实例-全部测试通过

最近使用log4j写log时候发现网上的写的都是千篇一律,写的好的嘛不全,写的全一点的嘛没有一点格式,看着累。这里把网上收集到的整理了一下,并且全部都在机器上测试成功了。这么好的文档估计没有了吧?  ...

log4j.properties

  • 2017年04月05日 17:18
  • 2KB
  • 下载

log4j.properties日志配置文件

  • 2017年06月21日 10:53
  • 215B
  • 下载

简单log4j.properties配置示例

### set log levels ### log4j.rootLogger = INFO , console , debug , error ### console ### log4j.appe...
  • zqbx7
  • zqbx7
  • 2017年01月16日 18:25
  • 17331

log4j.properties配置

  • 2017年04月25日 23:04
  • 5KB
  • 下载

log4j.properties

  • 2011年12月06日 16:52
  • 373B
  • 下载
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:log4j.properties参数
举报原因:
原因补充:

(最多只允许输入30个字)