Conversion Pattern	Logger Name	Result
%c{1}	org.apache.commons.Foo	Foo
%c{2}	org.apache.commons.Foo	commons.Foo
%c{10}	org.apache.commons.Foo	org.apache.commons.Foo
%c{-1}	org.apache.commons.Foo	apache.commons.Foo
%c{-2}	org.apache.commons.Foo	commons.Foo
%c{-10}	org.apache.commons.Foo	org.apache.commons.Foo
%c{1.}	org.apache.commons.Foo	o.a.c.Foo
%c{1.1.~.~}	org.apache.commons.test.Foo	o.a.~.~.Foo
%c{.}	org.apache.commons.test.Foo	....Foo

p|level{level=label,level=label, ...} p|level{length=n} p|level{lowerCase=true|false}à you can define the length of the levellabel:

m{nolookups}{ansi}|msg{nolookups}{ansi}|message{nolookups}{ansi}àsupplied message

xEx|xException|xThrowableàsuppress printing of the exception

五、配置使用

1. 配置文件命名与存储位置（Log4J没有默认的配置文件）

系统选择configuration文件的优先级如下（放在src文件夹）：

classpath下名为 log4j-test.json 或者log4j-test.jsn文件

classpath下名为 log4j2-test.xml

classpath下名为 log4j.json 或者log4j.jsn文件

classpath下名为 log4j2.xml

很多人认为src就是classpath，java项目中Classpath路径到底指的是哪里？

1） src不是classpath,而WEB-INF/classes,lib才是classpath，WEB-INF/是资源目录, 客户端不能直接访问。

2） WEB-INF/classes目录存放src目录java文件编译之后的class文件，xml、properties等资源配置文件，这是一个定位资源的入口。

3） lib和classes同属classpath，两者的访问优先级为: lib>classes。

配置主要是两方面内容：一是logger，二是appender；将两者关联起来

简单的配置文件

<?xml version="1.0" encoding="UTF-8"?>
     <configuration status="OFF">
       <appenders>
         <Console name="Console" target="SYSTEM_OUT">
           <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
         </Console>
       </appenders>
       <loggers>
         <root level="trace">
           <appender-ref ref="Console"/>
         </root>
       </loggers>
     </configuration>

稍微复杂的配置

<?xml version="1.0" encoding="UTF-8"?>
<configuration status="error">

    <appenders>

        <Console name="Console" target="SYSTEM_OUT">

            <ThresholdFilter level="trace" onMatch="ACCEPT" onMismatch="DENY"/>

            <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>
        </Console>



        <File name="log" fileName="log/test.log" append="false">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/>
        </File>


       <File name="ERROR" fileName="logs/error.log">
            <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="%d{yyyy.MM.dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
        </File>


        <RollingFile name="RollingFile" fileName="logs/web.log"
                     filePattern="logs/$${date:yyyy-MM}/web-%d{MM-dd-yyyy}-%i.log.gz">
            <PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
            <SizeBasedTriggeringPolicy size="2MB"/>
        </RollingFile>
    </appenders>


    <loggers>

        <root level="info">
            <appender-ref ref="RollingFile"/>
            <appender-ref ref="Console"/>
           <appender-ref ref="ERROR" />
           <appender-ref ref="log"/>
        </root>

    </loggers>
</configuration>

最后说明，

使用Console类型的appender，日志会输出到控制台，windows为控制台，linux为catalina.out文件

使用File,RollingFile为文件类型的appender，日志会输出到指定位置的文件中

如果logger包含控制台和文件类型的appender,且程序中记录日志的logger的级别大于等于配置文件中logger的级别，则日志会在各个类型的文件中记录。

如果logger只包含控制台的appender,且程序中记录日志的logger的级别大于等于配置文件中logger的级别，则日志只会记录在控制台类型的文件中记录。

如果logger只包含文件类型的appender,且程序中记录日志的logger的级别大于等于配置文件中logger的级别，则日志只会在文件类型的文件中记录。

也就是说logger引用了多少个append配置，记录日志时，引用的append都会起作用。

当然，如果程序中的logger调用方法的级别小于配置文件中logger配置的level，则不会记录日志。

下面Java类中使用了slf4j的接口来实现日志记录。这将会使用我们配置文件中Root根节点指定的Appender，如果我们没有自己配置Logger，则会使用Root根节点的默认配置。

private static final Logger logger=LoggerFactory.getLogger(My.class);

下面使用自定义的Logger作为日志记录器,为此加一个自定义Logger，name为myLearningLog

<Loggers>
<Logger name="myLearningLog" level="trace" additivity="false">
<AppenderRef ref="RollingFile"/>
</Logger>
<Root level="trace">
<AppenderRef ref="Console"/>
</Root>
</Loggers>

private static final Logger logger = LoggerFactory.getLogger("myLearningLog");

记录日志

　　 public static void main(String[] args) {
         logger.trace("learning1 log4j trace"); //如果配置文件中logger的level为info，则trace,和debug不会记录
         logger.debug("learning1 log4j debug");
         logger.info("learning1 log4j info");
       logger.warn("learning1 log4j warn");
         logger.error("learning1 log4j error");
       }

扩展

Log4j用法

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

log4j.properties配置文件详解

配置主要是两方面内容：一是logger，二是appender；将两者关联起来

1.配置根Logger，其语法为：

log4j.rootLogger = [ level ] , appenderName, appenderName, …

其中，level 是日志记录的优先级，分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定义的级别。Log4j建议只使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别，您可以控制到应用程序中相应级别的日志信息的开关。比如在这里定义了INFO级别，则应用程序中所有DEBUG级别的日志信息将不被打印出来。 appenderName就是指日志信息输出到哪个地方。您可以同时指定多个输出目的地。

2.配置日志信息输出目的地Appender，其语法为：

log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
…
log4j.appender.appenderName.option = valueN

2.1配置Appender类型，Log4j提供的appender有以下几种：

org.apache.log4j.ConsoleAppender（控制台），
org.apache.log4j.FileAppender（文件），
org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），
org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），
org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

ConsoleAppender
Threshold=WARN：指定日志消息的输出最低层次。
ImmediateFlush=true：默认值是true,意谓着所有的消息都会被立即输出。
Target=System.err：默认情况下是：System.out,指定输出控制台，linux就是输出到catalina.out文件中。

FileAppender
Threshold=WARN：指定日志消息的输出最低层次。
ImmediateFlush=true：默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt：指定消息输出到mylog.txt文件。
Append=false：默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。

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: 每分钟

RollingFileAppender
Threshold=WARN：指定日志消息的输出最低层次。
ImmediateFlush=true：默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt：指定消息输出到mylog.txt文件。
Append=false：默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
MaxFileSize=100KB：后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时，将会自动滚动，即将原来的内容移到mylog.log.1文件。
MaxBackupIndex=5：指定可以产生的滚动文件的最大数。

2.2.配置appender的日志信息的格式（布局），其语法为：

log4j.appender.appenderName.layout = 例如org.apache.log4j.PatternLayout
log4j.appender.appenderName.layout.option1 = value1
…
log4j.appender.appenderName.layout.option = valueN

其中，Log4j提供的layout有以下几种：

org.apache.log4j.HTMLLayout（以HTML表格形式布局），

org.apache.log4j.PatternLayout（可以灵活地指定布局模式），

org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），

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

 
　　其中指定PatternLayout时，需要配合设置日志格式ConversionPattern才行，下面详解。

2.3配置具体的自定义格式

日志信息格式中几个符号所代表的含义：

-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.properties配置文件实战

//配置Logger,这里配置的是跟rootLogger,指定日志级别及用的的Appender

log4j.rootLogger = INFO, stdout , D , R //指定输出级别为INFO,Appender有stdout , D , R

//下面具体配置三个Appender：stdout , D , R

//输出到控制台，即catalina.out文件
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n

　　产生文件如图：

//每天产生一个日志文件catalinacustomer，且每小时分隔出一个文件catalinacustomer.yyyy-MM-dd-HH.log，

log4j.appender.D=org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File=${catalina.base}/logs/catalinacustomer
log4j.appender.D.DatePattern ='.'yyyy-MM-dd-HH'.log'
log4j.appender.D.layout = org.apache.log4j.PatternLayout //自定义布局PatternLayout
log4j.appender.D.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss,SSS} [%c]-[%p] %m%n //定义布局格式
log4j.appender.D.Append=true //默认为true

产生文件如图：

//按照指定的文件大小尺寸产生文件机制

log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=${catalina.base}/logs/catalinacustomerfile //文件名
log4j.appender.R.MaxFileSize=10KB //后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时，将会自动滚动，即将原来的内容移到catalinacustomerfile .1文件,依次类推，数字越小内容越新。
log4j.appender.R.MaxBackupIndex=10 //指定可以产生的滚动文件的最大数
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n

产生文件如图：

如上配置，则会产生这些文件，分别是catalina.out，catalinacustomer，catalinacustomer.yyyy-MM-dd-HH.log，catalinacustomerfile ，catalinacustomerfile.1 ，……

之所以是catalina.2019-10-10.log而非catalina.out，是因为用了cronolog做日志分隔。

posted on 2017-10-12 16:22 邹阳阅读(736) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

导航

扩展

Log4j用法

log4j.properties配置文件详解

其中指定PatternLayout时，需要配合设置日志格式ConversionPattern才行，下面详解。

日志信息格式中几个符号所代表的含义：

log4j.properties配置文件 实战

　　其中指定PatternLayout时，需要配合设置日志格式ConversionPattern才行，下面详解。

log4j.properties配置文件实战