log4jproperties配置文件基本语法.docx

1、log4jproperties配置文件基本语法log4j.properties配置文件基本语法以下是配置文件的语法。1. 配置日志级别及输出日志目的地log4j.rootLogger = level,appenderName,appenderName.其中：（1）level是日志记录的优先级，从高到低分别为FATAL，ERROR，WARN，INFO，DEBUG。当你定义一个级别，只有等于或者高于这个基本的才进行处理。可选的All打印所有日志，OFF关闭所有日志输出。（2）appenderName用于指定日志信息输出目的地，可以指定多个【例1】日志配置文件级别设置为debug，目的地有两个，分别

2、是：target01，tartet02。log4j.rootLogger=debug, target01, target022.配置目的地appender 设置目的地类型有以下几种：（1） org.apache.log4j.jdbc.JDBCAppender -存入数据库；（2） .SMTPAppender -发送到指定邮箱；（3） net.cybercorlin.util.logger.appender.IMAppender-自定义类型；（4） org.apache.log4j.ConsoleAppender-控制台；（5） org.apache.log4j.FileAppender-文件；

3、（6） org.apache.log4j.DailyRollingFileAppender-每天产生一个日志文件；（7） org.apache.log4j.RollingFileAppender-文件达到指定大小的时候产生一个新的文件；（8） org.apache.log4j.WriterAppender-将日志信息以流格式发送到任意指定的地方。【例2】将例1中的目的地target01配置成在文件中输出，且每天产生一个日志文件；target02配置成在控制台输出。log4j.appender.target01=org.apache.log4j.DailyRollingFileAppenderl

4、og4j.appender.target02=org.apache.log4j.ConsoleAppender 各类型目的地相关属性说明（1）ConsoleAppender类型目的地属性说明Threshold=WARN：指定日志消息的输出最低层次。ImmediateFlush=true：默认值是 true，意谓着所有的消息都会被立即输出。Target=System.err：默认情况下是：System.out,指定输出控制台【例3】配置例2中目的地target02的Target属性值为System.err。log4j.appender.target02.Target=System.err（2）F

5、ileAppender类型目的地属性说明Threshold=WARN：指定日志消息的输出最低层次。ImmediateFlush=true：默认值是 true,意谓着所有的消息都会被立即输出。File=mylog.txt：指定消息输出到 mylog.txt 文件。Append=false：默认值是 true，即将消息增加到指定文件中，false 指将消息覆盖指定的文件内容。【例4】配置例2中目的地target01的输出文件为D盘根目录下的log.txt。log4j.appender.target01.File=d:/log.txt（3）DailyRollingFileAppender类型目的地属

6、性说明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： 每天两

7、次. 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. 在日志文件到达该大小时，将会自动滚动，

8、即将原来的内容移到 mylog.log.1 文件。MaxBackupIndex=2：指定可以产生的滚动文件的最大数。3.配置日志信息格式Layout 设置日志信息格式类型有以下几种：（1） org.apache.log4j.HTMLLayout-HTML表格形式；（2） org.apache.log4j.PatternLayout-自定义的布局（下面将见到这么自定义配置)；（3） org.apache.log4j.SimpleLayout-只包含日志信息基本和信息的字符信息；（4） org.apache.log4j.TTCCLayout-包括日志产生时间、线程、类别等信息。【例5】将例1中的目

9、的地target01输出格式配置成自定义布局，target02输出格式配置成HTMLLayout格式。log4j.appender.target01.layout=org.apache.log4j.PatternLayoutlog4j.appender.target02.layout= org.apache.log4j.HTMLLayout 各格式类型相关属性说明（1）HTMLLayout输出格式属性说明LocationInfo=true：默认值是 false，输出 java 文件名称和行号。Title=my app file： 默认值是 Log4J Log Messages。（2）Patte

10、rnLayout 选项ConversionPattern=%m%n :指定怎样格式化指定的消息。【例6】将例1中的目的地target01输出格式为显示输出信息的时间、所在的文件的行数。log4j.appender.target01.layout.conversionPattern=%dyyyy-MM-dd HH:mm:ss,SSS%l%m%nLog4J 采用类似 C 语言中的 printf 函数的打印格式格式化日志信息，打印参数如表所示。表1 格式化信息参数含义说明表符号含义-XX 信息输出时左对齐%p输出日志信息优先级，即 DEBUG，INFO，WARN，ERROR，FATAL，%d输出日志

11、时间点的日期或时间，默认格式为 ISO8601，也可以在其后指定格式。例如，%dyyy MMM dd HH:mm:ss，SSS，输出类似：2002 年 10 月 18 日 22:10:28，921%r输出自应用启动到输出该 log 信息耗费的毫秒数%c输出日志信息所属的类目，配置文件中的名字，通常就是所在类的全名（若使用 rootLogger）%t输出产生该日志事件的线程名%l输出日志事件的发生位置，相当于%C.%M(%F:%L)的组合，包括类目名、发生的线程，以及行数。举例：Testlog4.main(TestLog4.java：10)%x输出和当前线程相关联的 NDC(嵌套诊断环境)，尤其

12、用到像 java servlets 这样的多客户多线程的应用中%输出一个%字符%F输出日志消息产生时所在的文件名称%L输出代码中的行号%m输出代码中指定的消息，产生的日志具体信息%n输出一个回车换行符，Windows 平台为rn，Unix 平台为n输出日志信息换行%M输出日志信息所属的方法可以在% 与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如：（1）%20c：指定输出 category 的名称，最小的宽度是 20，如果 category 的名称小于 20 的话，默认的情况下右对齐。（2）%-20c:指定输出 category 的名称，最小的宽度是 20，如果 cat

13、egory 的名称小于 20 的话，-号指定左对齐。（3）%.30c:指定输出 category 的名称，最大的宽度是 30，如果 category 的名称大于 30 的话，就会将左边多出的字符截掉，但小于 30 的话也不会有空格。（4）%20.30c:如果 category 的名称小于 20 就补空格，并且右对齐，如果其名称长于 30 字符，就从左边交远销出的字符截掉。4.在程序中使用log4j（1）得到记录器使用 Log4j ，第一步就是获取日志记录器，这个记录器将负责控制日志信息。其语法为：public static Logger getLogger( String name)通过指定的

14、名字获得记录器，如果必要的话，则为这个名字创建一个新的记录器。 Name 一般取本类的名字。【例7】创建一个记录器，名称为ServerWithLog4j类类名。Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () )（2）读取配置文件当获得了日志记录器之后，第二步将配置 Log4j 环境，其语法为：BasicConfigurator.configure () ： 自动快速地使用缺省 Log4j 环境。PropertyConfigurator.configure ( String configFilename) ：

15、读取使用 Java 的特性文件编写的配置文件。DOMConfigurator.configure ( String filename ) ：读取 XML 形式的配置文件。（3）记录信息（格式化日志信息）当以上必要步骤执行完毕，您就可以轻松地使用不同优先级别的日志记录语句插入到您想记录日志的任何地方，其语法如下： Logger.debug ( Object message ) ; Logger.info ( Object message ) ; Logger.warn ( Object message ) ; Logger.error ( Object message );*从网上摘抄的一些配置

16、实例* log4j.rootLogger=DEBUG,CONSOLE,A1,im #DEBUG,CONSOLE,FILE,ROLLING_FILE,MAIL,DATABASE log4j.addivity.org.apache=true # # Console Appender # log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender log4j.appender.Threshold=DEBUG log4j.appender.CONSOLE.Target=System.out log4j.appender.CONSOLE.layout=

17、org.apache.log4j.PatternLayout log4j.appender.CONSOLE.layout.ConversionPattern=framework %d - %c -%-4r %t %-5p %c %x - %m%n #log4j.appender.CONSOLE.layout.ConversionPattern=start%dDATEDATE%n%pPRIORITY%n%xNDC%n%tTHREAD n%cCATEGORY%n%mMESSAGE%n%n # # File Appender # log4j.appender.FILE=org.apache.log4

18、j.FileAppender log4j.appender.FILE.File=file.log log4j.appender.FILE.Append=false log4j.appender.FILE.layout=org.apache.log4j.PatternLayout log4j.appender.FILE.layout.ConversionPattern=framework %d - %c -%-4r %t %-5p %c %x - %m%n # Use this layout for LogFactor 5 analysis # # Rolling File # log4j.ap

19、pender.ROLLING_FILE=org.apache.log4j.RollingFileAppender log4j.appender.ROLLING_FILE.Threshold=ERROR log4j.appender.ROLLING_FILE.File=rolling.log log4j.appender.ROLLING_FILE.Append=true log4j.appender.ROLLING_FILE.MaxFileSize=10KB log4j.appender.ROLLING_FILE.MaxBackupIndex=1 log4j.appender.ROLLING_F

20、ILE.layout=org.apache.log4j.PatternLayout log4j.appender.ROLLING_FILE.layout.ConversionPattern=framework %d - %c -%-4r %t %-5p %c %x - %m%n # # Socket Appender # log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender log4j.appender.SOCKET.RemoteHost=localhost log4j.appender.SOCKET.Port=5001 log4

21、j.appender.SOCKET.LocationInfo=true # Set up for Log Facter 5 log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout log4j.appender.SOCET.layout.ConversionPattern=start%dDATEDATE%n%pPRIORITY%n%xNDC%n%tTHREAD%n%cCATEGORY%n%mMESSAGE%n%n # # Log Factor 5 Appender # log4j.appender.LF5_APPENDER=org.

22、apache.log4j.lf5.LF5Appender log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000 # # SMTP Appender # log4j.appender.MAIL=.SMTPAppender log4j.appender.MAIL.Threshold=FATAL log4j.appender.MAIL.BufferSize=10 log4j.appender.MAIL.From=chenyl log4j.appender.MAIL.SMTPHost= log4j.appender.MAIL.Subject=Log4J

23、 Message log4j.appender.MAIL.To=chenyl log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout log4j.appender.MAIL.layout.ConversionPattern=framework %d - %c -%-4r %t %-5p %c %x - %m%n # # JDBC Appender # log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender log4j.appender.DATABASE.URL=jdbc:m

24、ysql:/localhost:3306/test log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver log4j.appender.DATABASE.user=root log4j.appender.DATABASE.password= log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES (framework %d - %c -%-4r %t %-5p %c %x - %m%n) log4j.appender.DATABASE.layout=org.apache.l

25、og4j.PatternLayout log4j.appender.DATABASE.layout.ConversionPattern=framework %d - %c -%-4r %t %-5p %c %x - %m%n log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender log4j.appender.A1.File=SampleMessages.log4j log4j.appender.A1.DatePattern=yyyyMMdd-HH.log4j log4j.appender.A1.layout=org.apache

26、.log4j.xml.XMLLayout # #自定义Appender # log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender log4j.appender.im.host = log4j.appender.im.username = username log4j.appender.im.password = password log4j.appender.im.recipient = corlin log4j.appender.im.layout=org.apache.log4j.PatternLayout

27、log4j.appender.im.layout.ConversionPattern =framework %d - %c -%-4r %t %-5p %c %x - %m%n log4j.properties配置文件讲解如下： # Set root logger level to DEBUG and its only appender to A1 #log4j中有五级logger #FATAL 0 #ERROR 3 #WARN 4 #INFO 6 #DEBUG 7 配置根Logger，其语法为： #log4j.rootLogger = level , appenderName, append

28、erName, log4j.rootLogger=INFO, A1 ,R #这一句设置以为着所有的log都输出 #如果为log4j.rootLogger=WARN, 则意味着只有WARN,ERROR,FATAL #被输出，DEBUG,INFO将被屏蔽掉. # A1 is set to be a ConsoleAppender. #log4j中Appender有几层如控制台、文件、GUI组件、甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等 #ConsoleAppender输出到控制台 log4j.appender.A1=org.apache.log4j.ConsoleAppender # A1 使用的输出布局，其中log4j提供4种布局. #org.apache.log4j.HTMLLayout（以HTML表格形式布局） #org.apache.log4j.PatternLayout（可以灵活地指定布局模式）， #org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串）， #org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息） log4j.appender.A1