properties方式配置:
1. 配置根Logger
语法:log4j.rootLogger = [ level ] , appenderName, appenderName, …
解释:如果[level]缺少系统会出错,level 是日志记录的优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL,用来控制到应用程序
中相应级别的日志信息的开关;
appenderName为日志输出目的地,需要对appenderName进一步配置
示例1:log4j.rootLogger=debug,stdout, matrixInfo, matrixWarn, matrixError, matrixErrorDB
示例1中定义了系统的日志级别为debug,和5个日志输出目的地stdout, matrixInfo, matrixWarn, matrixError, matrixErrorDB
2. 配置日志信息输出目的地Appender
语法:log4j.appender.appenderName = fully.qualified.name.of.appender.class
…
log4j.appender.appenderName.optionN = valueN
解释: fully.qualified.name.of.appender.class 表示log4j支持的输出目的地,可选值有
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
log4j.appender.appenderName.optionN = valueN表示输出目的地的具体选项配置,不同的输出目的地有不同的选项配置
ConsoleAppender的选项:
Threshold=WARN ------指定日志消息的输出最低层次。
ImmediateFlush=true ------默认值是true,意谓着所有的消息都会被立即输出。
Target=System.err ------默认情况下是:System.out,指定输出控制台
FileAppender 的选项:
Threshold=WARN
ImmediateFlush=true
File=mylog.txt -------指定消息输出到mylog.txt文件
Append=false -------默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容
DailyRollingFileAppender的选项:
Threshold=WARN
ImmediateFlush=true
File=mylog.txt
Append=false
DatePattern=’.'yyyy-ww ------每周滚动一次文件,即每周产生一个新的文件。当然也可以指定按月、周、天、时和分。即对应的格式如下:
1) ’.'yyyy-MM: 每月
2) ’.'yyyy-ww: 每周
3) ’.'yyyy-MM-dd: 每天
4) ’.'yyyy-MM-dd-a: 每天两次
5) ’.'yyyy-MM-dd-HH: 每小时
6) ’.'yyyy-MM-dd-HH-mm: 每分钟
RollingFileAppender 的选项
Threshold=WARN
ImmediateFlush=true
File=mylog.txt
Append=false
MaxFileSize=100KB ------后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到mylog.log.1文件
MaxBackupIndex=2 ------指定可以产生的滚动文件的最大数
示例2:
log4j.appender.matrixInfo=org.apache.log4j.DailyRollingFileAppender
log4j.appender.matrixInfo.file=logs/console-info.log
log4j.appender.matrixInfo.Threshold = INFO
log4j.appender.matrixInfo.Append = true
log4j.appender.matrixInfo.maxFileSize=10M
log4j.appender.matrixInfo.DatePattern='.'yyyy-MM-dd
示例2定义了示例1中的matrixInfo输出目的地配置,matirxInfo的输出目的地为文件,该文件位于系统的logs下,系统中的INFO级别日志都会以追加形式记录在该文件里,该文件最大为10M,超出10M会产生新文件继续记录日志,同时每天会产生新文件用来记录当天日志,历史日志文件名为console-info.log.2012-03-23这种形式存在,当天的日志文件名不会追加日期,当天的滚动文件名会追加数字如console-info.log.1、console-info.log.2
3. 配置日志信息的布局
语法:log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
…
log4j.appender.appenderName.layout.optionN = valueN
解释: fully.qualified.name.of.layout.class 表示log4j支持的布局,可选项有:
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
log4j.appender.appenderName.layout.optionN = valueN表示布局具体选项配置,可选值有:
ConversionPattern=%d %p [%c] - %m%n ---------日志输出格式
参数:
%p: 输出日志信息优先级,即DEBUG,INFO,WARN,ERROR,FATAL,
%d: 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921
%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”输出日志信息换行
可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如:
1)%20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,默认的情况下右对齐。
2)%-20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,”-”号指定左对齐。
3)%.30c:指定输出category的名称,最大的宽度是30,如果category的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。
4)%20.30c:如果category的名称小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边交远销出的字符截掉
示例3:
log4j.appender.matrixInfo.layout=org.apache.log4j.PatternLayout
log4j.appender.matrixInfo.layout.ConversionPattern=%d{ABSOLUTE} [%t] %5p (%c.java:%L) - %m%n
示例3定义了示例2中matrixInfo输出目的地的布局方式和输出格式,布局方式为自定义
实例4:
# Global logging configuration
log4j.rootLogger=debug,stdout, matrixInfo, matrixWarn, matrixError, matrixErrorDB
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} [%t] %5p (%c.java:%L) - %m%n
#ecmarix-info
log4j.appender.matrixInfo=org.apache.log4j.DailyRollingFileAppender
log4j.appender.matrixInfo.layout=org.apache.log4j.PatternLayout
log4j.appender.matrixInfo.file=logs/console-info.log
log4j.appender.matrixInfo.Threshold = INFO
log4j.appender.matrixInfo.Append = true
log4j.appender.matrixInfo.maxFileSize=10M
log4j.appender.matrixInfo.DatePattern='.'yyyy-MM-dd
log4j.appender.matrixInfo.layout.ConversionPattern=%d{ABSOLUTE} [%t] %5p (%c.java:%L) - %m%n
#ecmarix-warn
log4j.appender.matrixWarn=org.apache.log4j.DailyRollingFileAppender
log4j.appender.matrixWarn.layout=org.apache.log4j.PatternLayout
log4j.appender.matrixWarn.file=logs/console-warn.log
log4j.appender.matrixWarn.Threshold = WARN
log4j.appender.matrixWarn.Append = true
log4j.appender.matrixWarn.maxFileSize=10M
log4j.appender.matrixWarn.DatePattern='.'yyyy-MM-dd
log4j.appender.matrixWarn.layout.ConversionPattern=%d{ABSOLUTE} [%t] %5p (%c.java:%L) - %m%n
#ecmarix-error
log4j.appender.matrixError=org.apache.log4j.DailyRollingFileAppender
log4j.appender.matrixError.layout=org.apache.log4j.PatternLayout
log4j.appender.matrixError.file=logs/console-error.log
log4j.appender.matrixError.Threshold = ERROR
log4j.appender.matrixError.Append = true
log4j.appender.matrixError.maxFileSize=10M
log4j.appender.matrixError.DatePattern='.'yyyy-MM-dd
log4j.appender.matrixError.layout.ConversionPattern=%d{ABSOLUTE} [%t] %5p (%c.java\:%L) - %m%n
示例4主要定义了示例1中各个输出目的地的配置,目的主要是为了将不同级别的日志信息分别记录在不同的日志文件中,方便追踪查看
除了上面的Appender外,还有以下的Appender
#应用于socket
log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender
log4j.appender.SOCKET.RemoteHost=localhost
log4j.appender.SOCKET.Port=5001
log4j.appender.SOCKET.LocationInfo=true
log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[thread]%n%c[CATEGORY]%n%m[MESSAGE]%n%n
# 发送日志给邮件
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold=FATAL
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=web@www.wuset.com
log4j.appender.MAIL.SMTPHost=www.wusetu.com
log4j.appender.MAIL.Subject=Log4J Message
log4j.appender.MAIL.To=web@www.wusetu.com
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
# 用于数据库
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=root
log4j.appender.DATABASE.password=123
log4j.appender.DATABASE.sql=INSERT INTO matrix_log_record(date,thread_name,level,class_info,message,host_address,sub_sys_name) VALUES ('%d{yyyy-MM-dd HH:mm:ss}', '%t', '%p', '%l', '%m','%X{hostAddress}','console') ;
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n