log4j简介
Log4j是Apache的一个开源项目,它允许开发者以任意间隔输出日志信息。Log4j主要由三大类组件构成:
1)Logger-负责输出日志信息,并能够对日志信息进行分类筛选,即决定哪些日志信息应该被输出,哪些该被忽略。Loggers组件输出日志信息时分为5个级别:DEBUG、INFO、WARN、ERROR、FATAL。这五个级别的顺序是:DEBUG<INFO<WARN<ERROR<FATAL。如果设置某个Logger组件的级别是P,则只有级别比P高的日志信息才能输出。Logger是有继承关系的,最上层是rootLogger,定义的其他Logger都会继承rootLogger。
2)Appender-定义了日志输出目的地,指定日志信息应该被输出到什么地方。输出的目的地可以是控制台、文件或网络设备。
3)Layout-通过在Appender的后面附加Layout来实现格式化输出。一个Logger可以有多个Appender,每个Appender对应一个Layout。loggers
Appenders
Appender类名 作用 org.apache.log4j.ConsoleAppender 将日志输出到控制台 org.apache.log4j.FileAppender 将日志输出到文件 org.apache.log4j.DailyRollingFileAppender 每天产生一个日志文件 org.apache.log4j.RollingFileAppender 文件大小到达指定尺寸时产生一个新的文件 org.apache.log4j. WriterAppender 将日志信息以流格式发送到任意指定的地方
1)ConsoleAppender选项-Threshold=WARN:指定日志消息的输出最低层次。-ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。-Target=System.err:默认情况下是:System.out,指定输出控制台。2)FileAppender 选项-Threshold=WARN:指定日志消息的输出最低层次。-ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。-File=mylog.txt:指定消息输出到mylog.txt文件。- Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。3)DailyRollingFileAppender 选项-Threshold=WARN:指定日志消息的输出最低层次。-ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。-File=mylog.txt:指定消息输出到mylog.txt文件。-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: 每分钟4)RollingFileAppender 选项-Threshold=WARN:指定日志消息的输出最低层次。-ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。-File=mylog.txt:指定消息输出到mylog.txt文件。- Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。-MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到mylog.log.1文件。-MaxBackupIndex=2:指定可以产生的滚动文件的最大数。Layouts
Layout的定义格式:部分一log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class//"fully.qualified.name.of.layout.class" 可以指定下面4个格式中的一个:Layout类及其作用列表
Layout类名 作 用 org.apache.log4j.HTMLLayout 以HTML表格形式布局 org.apache.log4j.PatternLayout 可以灵活地指定布局模式 org.apache.log4j.SimpleLayout 包含日志信息的级别和信息字符串 org.apache.log4j.TTCCLayout 包含日志产生的时间、线程、类别等等信息1)HTMLLayout 选项-LocationInfo=true:默认值是false,输出java文件名称和行号。-Title=my app file: 默认值是 Log4J Log Messages。2)PatternLayout 选项- ConversionPattern=%m%n :指定怎样格式化指定的消息。3)XMLLayout 选项-LocationInfo=true:默认值是false,输出java文件和行号。部分二 log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n这里需要说明的就是日志信息格式中几个符号所代表的含义:1)-X号: X信息输出时左对齐。2)%p: 输出日志信息优先级,即DEBUG,INFO,WARN,ERROR,FATAL。3)%d: 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921。4)%r: 输出自应用启动到输出该log信息耗费的毫秒数。5)%c: 输出日志信息所属的类目,通常就是所在类的全名。6)%t: 输出产生该日志事件的线程名。7)%l: 输出日志事件的发生位置,相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java:10)。8)%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。9)%%: 输出一个"%"字符。10)%F: 输出日志消息产生时所在的文件名称。11) %L: 输出代码中的行号。12)%m: 输出代码中指定的消息,产生的日志具体信息。13)%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字符,就从左边交远销出的字符截掉。
-
log4j.properties
#这里可以定义自己的log,解释(将rootCategory log 的INFO信息输出到inforappender,debugappenderl的等appender中)
log4j.rootCategory=INFO,inforappender,debugappenderlog4j.rootCategory=DEBUG,debugappender
#log4j.rootCategory=WARN,inforappender
#log4j.rootCategory=ERROR,inforappender
#log4j.rootCategory=FATAL,inforappender
#output system-infor to mylog.log file 定义inforappender 信息输出目标
log4j.appender.inforappender=org.apache.log4j.DailyRollingFileAppender
log4j.appender.inforappender.layout=org.apache.log4j.PatternLayout
log4j.appender.inforappender.Threshold=DEBUG
log4j.appender.inforappender.ImmediateFlush=true
log4j.appender.inforappender.File=../logs/mylog.log
log4j.appender.inforappender.ImmediateFlush=true
log4j.appender.inforappender.Append=true
log4j.appender.inforappender.DatePattern='_'yyyy-MM-dd'.log'
log4j.appender.inforappender.layout.ConversionPattern=[%-5p] %-d{yyyy-MM-dd HH\:mm\:ss} [%c.%M\:%L] %m%n
#output message to console定义debugappender 信息输出目标
log4j.appender.debugappender=org.apache.log4j.ConsoleAppender
log4j.appender.debugappender.Threshold=DEBUG
log4j.appender.debugappender.ImmediateFlush=true
log4j.appender.debugappender.layout=org.apache.log4j.PatternLayout
log4j.appender.debugappender.layout.ConversionPattern=[%-5p] %-d{yyyy-MM-dd HH\:mm\:ss} [%c.%M\:%L] %m%n#例如 log4j.logger.com.cx中的信息级别为INFO
log4j.logger.com.cx=INFO
log4j.logger.com.opensymphony.xwork2=INFO
log4j.logger.org.apache.struts2=INFO