Log4j主要由三大组件组成:loggers、appenders和layouts,通过这三大组件协同工作来控制日志的级别,输出形式和日志输出格式
1)Loggers
Logger负责日志的采集工作,且根据配置文件中的等级来采集相应等级的日志。
级别 | 描述 |
ALL | 所有级别,包括定制级别 |
DEBUG | 指明细致的事件信息,对调试最有用 |
ERROR | 指明错误事件,但应用可能还能运行 |
FATAL | 指明非常严重的错误事件,可能导致程序终止运行 |
INFO | 指明描述信息,粗粒度上描述应用程序运行 |
OFF | 最高级别,关闭日志 |
TRACE | 比DEBUG级别的粒度更细 |
WARN | 指明所有潜在的有害状况 |
Logger等级由高到低的顺序如下:
OFF>FATAL>ERROR>WARN>INFO>DEBUG>TRACE>ALL
常用输出日志等级包括如下:ERROR>WARN>INFO>DEBUG
日志输出规则:只输出级别不低于设定级别的日志信息,假设Loggers级别设定为INFO,则INFO、WARN、ERROR级别的日志信息都会输出,而级别比INFO低的DEBUG则不会输出。
2)Appenders
Appender主要控制日志的输出地方,如控制台(Console)、文件(Files)等,可以根据天数或者文件大小产生新的文件,可以以流的形式发送到其它地方等等,常用appendrs如下。
常用APPENDER
Appender | 输出方式 |
org.apache.log4j.ConsoleAppender | 输出到控制台 |
org.apache.log4j.FileAppender | 输出到文件中 |
org.apache.log4j.DailyRollingFileAppende | 按时间控制输出文件 |
org.apache.log4j.RollingFileAppender | 按文件大下产生新的日志文件 |
org.apache.log4j.WriterAppender | 将日志信息以流格式发送到任意指定的地方 |
layout输出布局方式
Layout | 描述 |
org.apache.log4j.HTMLLayout | 以HTML表格形式布局 |
org.apache.log4j.PatternLayout | 可以灵活地指定布局模式 |
org.apache.log4j.SimpleLayout | 包含日志信息的级别和信息字符串 |
org.apache.log4j.TTCCLayout | 包含日志产生的时间、线程、类别等信息 |
日志格式化
%p:输出日志信息的优先级,即DEBUG,INFO,WARN,ERROR,FATAL。
%d:输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,如:%d{yyyy/MM/ddHH:mm:ss,SSS}。
%r:输出自应用程序启动到输出该log信息耗费的毫秒数。
%t:输出产生该日志事件的线程名。
%l:输出日志事件的发生位置,相当于%c.%M(%F:%L)的组合,包括类全名、方法、文件名以及在代码中的行数。例如:test.TestLog4j.main(TestLog4j.java:10)。
%c:输出日志信息所属的类目,通常就是所在类的全名。
%M:输出产生日志信息的方法名。
%F:输出日志消息产生时所在的文件名称。
%L::输出代码中的行号。
%m::输出代码中指定的具体日志信息。
%n:输出一个回车换行符,Windows平台为"rn",Unix平台为"n"。
%x:输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
%%:输出一个"%"字符。
另外,还可以在%与格式字符之间加上修饰符来控制其最小长度、最大长度、和文本的对齐方式。如:
1) c:指定输出category的名称,最小的长度是20,如果category的名称长度小于20的话,默认的情况下右对齐。
2)%-20c:"-"号表示左对齐。
3)%.30c:指定输出category的名称,最大的长度是30,如果category的名称长度大于30的话,就会将左边多出的字符截掉,但小于30的话也不会补空格。