log4j配置文件详解

一.Log4j的配置文件分类

Log4j支持两种配置文件格式,一种是XML格式的文件,一种是properties(key=value)文件,其中properties格式的配置文件最为常用,其有一个固定的文件名log4j.properties,下面我们介绍使用properties文件做为配置文件的方法:

二.Log4j.properties配置文件详解

Log4j框架主要的工作内容围绕着三个功能:

    产生日志信息

    将日志信息输出到指定位置

    调整输出样式

而Log4j的配置文件主要就是对这三种功能的实现方式进行设置

1.配置rootLogger

rootLogger的配置方式:

log4j.rootLogger = level,appenderName1,appenderName2, .....

rootLogger的配置详解

    level是日志记录的优先级,一般日志级别包括:ALL,DEBUG, INFO, WARN, ERROR,FATAL,OFF

    Log4J推荐使用:DEBUG, INFO, WARN, ERROR

    appenderName是日志信息输出位置,可以同时指定多个输出目的地

输出级别的种类:

    OFF         为最高等级 关闭了日志信息  

    FATAL  为可能导致应用中止的严重事件错误  

    ERROR 为严重错误 主要是程序的错误  

    WARN 为一般警告,比如session丢失  

    INFO         为一般要显示的信息,比如登录登出  

    DEBUG 为程序的调试信息  

    TRACE 为比DEBUG更细粒度的事件信息  

    ALL         为最低等级,将打开所有级别的日志

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

Appender的配置方式:

log4j.appender.appenderName = Log4j提供的appender类
log4j.appender.appenderName.属性名 = 属性值
.....
log4j.appender.appenderName.属性名 = 属性值

log4j提供的appender有如下几种:

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

    org.apache.log4j.FileAppender(文件)  

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

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

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

ConsoleAppender控制台选项

    Threshold=DEBUG:指定日志消息的输出最低层次。

    ImmediateFlush=true:默认值是true,意味着所有的消息都会被立即输出。

    Target=System.err:默认情况下是:System.out,指定输出控制台

FileAppender 文件选项

    Threshold=DEBUG:指定日志消息的输出最低层次。

    ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。

    File=mylog.txt:指定消息输出到mylog.txt文件。

    Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。

RollingFileAppender 每天生成一个文件选项

    Threshold=DEBUG:指定日志消息的输出最低层次。

    ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。

    File=mylog.txt:指定消息输出到mylog.txt文件。

    Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。

    MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到mylog.log.1文件。

    MaxBackupIndex=2:指定可以产生的滚动文件的最大数

DailyRollingFileAppender

    Threshold=WARN:指定日志消息的输出最低层次。 

    ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。 

    File=mylog.txt:指定消息输出到mylog.txt文件。 

    Append=false:默认值是true,即将消息增加到指定文件中,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: 每分钟

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

日志信息格式的配置方式:

log4j.appender.appenderName.layout = Log4j提供的layout类
log4j.appender.appenderName.layout.属性 = 值
.....
log4j.appender.appenderName.layout.属性 = 值

Log4j提供的layout有以下几种:

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

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

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

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

HTMLLayout

    LocationInfo=true:默认值是false,输出java文件名称和行号 

    Title=my app file:默认值是 Log4J Log Messages

PatternLayout

    ConversionPattern=%m%n:指定怎样格式化指定的消息。

XMLLayout

    LocationInfo=true:默认值是false,输出java文件和行号 

ConversionPattern 日志信息,符号所代表的含义:

 -X号: X信息输出时左对齐;
 %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字符,就从左边较远输出的字符截掉。

三.Log4j常见配置

### 配置根 ###
log4j.rootLogger = debug,console,fileAppender,dailyRollingFile,rollingFile,MAIL,DATABASE,SOCKET,IM

### 设置输出sql的级别,其中logger后面的内容全部为jar包中所包含的包名 ###
log4j.logger.org.springframework=OFF
log4j.logger.java.sql.Connection=dubug
log4j.logger.java.sql.Statement=dubug
log4j.logger.java.sql.PreparedStatement=dubug
log4j.logger.java.sql.ResultSet=dubug
#log4j.addivity.org.apache=true

### 配置输出到控制台 ###
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.Threshold = DEBUG 
log4j.appender.console.Target = System.out
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern = %d{yyyy/MM/dd HH:mm:ss} [%5p] %X{userName} - (%F:%L) - %m%n

### 配置输出到文件 ###
log4j.appender.fileAppender = org.apache.log4j.FileAppender
log4j.appender.fileAppender.File = logs/log.log
log4j.appender.fileAppender.Append = true
log4j.appender.fileAppender.Threshold = DEBUG
log4j.appender.fileAppender.layout = org.apache.log4j.PatternLayout
log4j.appender.fileAppender.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出到文件,并且每天都创建一个文件 ###
log4j.appender.dailyRollingFile = org.apache.log4j.DailyRollingFileAppender
log4j.appender.dailyRollingFile.File = logs/log.log
log4j.appender.dailyRollingFile.Append = true
log4j.appender.dailyRollingFile.Threshold = DEBUG
log4j.appender.dailyRollingFile.DatePattern = '_'yyyy-MM-dd
log4j.appender.dailyRollingFile.layout = org.apache.log4j.PatternLayout
log4j.appender.dailyRollingFile.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 配置输出到文件,且大小到达指定尺寸的时候产生一个新的文件 ###
log4j.appender.rollingFile=org.apache.log4j.RollingFileAppender 
log4j.appender.rollingFile.Threshold=ERROR 
log4j.appender.rollingFile.File=rolling.log 
log4j.appender.rollingFile.Append=true 
log4j.appender.rollingFile.MaxFileSize=10KB 
log4j.appender.rollingFile.MaxBackupIndex=10 
log4j.appender.rollingFile.layout=org.apache.log4j.PatternLayout 
log4j.appender.rollingFile.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

### 配置输出到邮件 ###
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold=ERROR
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=from@xxx.com
log4j.appender.MAIL.SMTPHost=mail.xxx.com
log4j.appender.MAIL.Subject=Log4J Message
log4j.appender.MAIL.To=to@xxx.com
log4j.appender.MAIL.SMTPUsername=
log4j.appender.MAIL.SMTPPassword=
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
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=root
log4j.appender.DATABASE.password=
log4j.appender.db.BufferSize=1
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.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

#应用于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.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender 
log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000 

#自定义Appender 
log4j.appender.IM = net.cybercorlin.util.logger.appender.IMAppender 
log4j.appender.IM.host = mail.cybercorlin.net 
log4j.appender.IM.username = username 
log4j.appender.IM.password = password 
log4j.appender.IM.recipient = corlin@cybercorlin.net
log4j.appender.IM.layout=org.apache.log4j.PatternLayout 
log4j.appender.IM.layout.ConversionPattern =[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

下面是xml配置

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">

    <!-- 将日志信息输出到控制台 -->
    <appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
		<param name="Target" value="System.out" />
        <!-- 设置日志输出的样式 -->
        <layout class="org.apache.log4j.PatternLayout">
            <!-- 设置日志输出的格式 -->
            <param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss:SSS}] [%-5p] [method:%l]%n%m%n%n" />
        </layout>
		<!--过滤器设置输出的级别-->     
        <filter class="org.apache.log4j.varia.LevelRangeFilter">     
            <param name="levelMin" value="debug" />     
            <param name="levelMax" value="error" />     
            <param name="AcceptOnMatch" value="true" />     
        </filter> 
    </appender>

    <!-- 将日志信息输出到文件,但是当文件的大小达到某个阈值的时候,日志文件会自动回滚 -->
    <appender name="RollingFileAppender" class="org.apache.log4j.RollingFileAppender">
        <!-- 设置日志信息输出文件全路径名 -->
        <param name="File" value="D:/log4j/RollingFileAppender.log" />
        <!-- 设置是否在重新启动服务时,在原有日志的基础添加新日志 -->
        <param name="Append" value="true" />
        <!-- 设置保存备份回滚日志的最大个数 -->
        <param name="MaxBackupIndex" value="10" />
        <!-- 设置当日志文件达到此阈值的时候自动回滚,单位可以是KB,MB,GB,默认单位是KB -->
        <param name="MaxFileSize" value="10MB" />
        <!-- 设置日志输出的样式 -->
        <layout class="org.apache.log4j.PatternLayout">
            <!-- 设置日志输出的格式 -->
            <param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss:SSS}] [%-5p] [method:%l]%n%m%n%n" />
        </layout>
    </appender>

    <!-- 将日志信息输出到文件,可以配置多久产生一个新的日志信息文件 -->
    <appender name="DailyRollingFileAppender" class="org.apache.log4j.DailyRollingFileAppender">
        <!-- 设置日志信息输出文件全路径名 -->
        <param name="File" value="D:/log4j/DailyRollingFileAppender.log" />
        <!-- 设置日志每分钟回滚一次,即产生一个新的日志文件 -->
        <param name="DatePattern" value="'.'yyyy-MM-dd-HH-mm'.log'" />
        <!-- 设置日志输出的样式 -->
        <layout class="org.apache.log4j.PatternLayout">
            <!-- 设置日志输出的格式 -->
            <param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss:SSS}] [%-5p] [method:%l]%n%m%n%n" />
        </layout>
    </appender>
	
	<!-- 下面这些就是根据 这些路径来控制对应包下的文件的日志输出级别-->
	<logger name="org.springframework.core">
		<level value="error" />
	</logger>
	
	<!-- 这个就是自定义的一个logger -->
	<!-- additivity 这个默认是true,即继承父类 root logger -->
	<!-- 也就是说,你的这个日志也会在root的logger里面输出的,我这里配置false,就是不继承,各走各的。 -->
	<logger name="test.log4j" additivity="false">
		<level value="debug" />
		<appender-ref ref="ConsoleAppender" />
	</logger>
	
	<!-- 传说中的根logger -->
	<!-- 输出级别是info级别及以上的日志 -->
	<root>
		<priority value="info" />
		<appender-ref ref="RollingFileAppender" />
		<appender-ref ref="DailyRollingFileAppender" />
	</root>

</log4j:configuration>

四.Log4j项目配置

在web.xml中添加log4j.xml配置

<context-param> 
    <param-name>log4jConfigLocation</param-name> 
    <param-value>/WEB-INF/log4j.xml</param-value> 
</context-param> 
<!-- 动态刷新,非必要 -->
<context-param> 
    <param-name>log4jRefreshInterval</param-name>
    <param-value>5000</param-value>
</context-param>
<listener> 
    <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class> 
</listener>

也可以手动配置,类似这样

org.springframework.util.Log4jConfigurer.initLogging(location, refreshInterval);


打赏

您看完此文章的心情是

  • 0人

  • 鼓掌

    0人

  • 草泥马

    0人

  • 愤怒

    0人

  • 鄙视

    0人

评论

    暂无评论...