官方文档
参考
log4j中3个重要的概念——Logger Appender Layout
1.Logger
1.1 Logger
Logger是我们打印日志之前去的的控制日志打印的对象
Logger具有自己的名称,根据名称的可包含关系具有继承性
例如: 名字为com.foo的Logger是com.foo.Bar的Logger的祖先,因为它们2个之间只相差一个.后面的字符,因此com.foo的Logger是com.foo.Bar的Logger的父亲
root是所有Logger的祖先,除了root之外,所有Logger获取的方式都是通过名称获取
1.2日志的等级
获取Logger打印日志的时候,需要指定日志的Level,log4j中日志的等级有
FATAL>ERROR>WARN>INFO>DEBUG>TRACE>ALL
每一个和Logger上都会预定义一个defaultLevel,只有>=defaultLevel的日志才会输出,如果该Logger上没有指定defaultlevel,那么它会继承自它的父Logger的defaultLevel,以此类推,直到root
2. Appender
2.1 appender
appender是控制输出日志的位置,可以是控制台,也可以是文件,也可以是远程的一个IO流
Logger需要与appedner继续关联,这样Logger就直到自己的日志内容应该输出到什么地方。需要指出的是,一个Logger可以关联多个appender,而且这种关联关系式具有继承性的,也就是说子Logger会继承父Logger关联的appender,如果不加控制的话,叶子appedner会继承自它上层的每一级Logger关联的所有appender,为了避免这种事情的发生,额可以在一个Logger上指定additivity="false",这样,它以及它的子Logger不会继承它祖先Logger的appender了。
2.2 appender的输出方式
org.apache.log4j.RollingFileAppender(滚动文件,自动记录最新日志)
org.apache.log4j.ConsoleAppender (控制台)
org.apache.log4j.FileAppender (文件)
org.apache.log4j.DailyRollingFileAppender (每天产生一个日志文件)
org.apache.log4j.WriterAppender (将日志信息以流格式发送到任意指定的地方)
3. Layouts
3.1 layout
appender用来控制输出日志的格式,每个appedner关联一个appender。
3.2 输出格式定义
appender输出的格式的参数必须以%开头,
%c 输出所属类的全名,可在修改为 %d{Num} ,Num类名输出的维(如:"org.apache.elathen.ClassName",%C{2}将输出 elathen.ClassName)
%d 输出日志时间其格式为 %d{yyyy-MM-dd HH:mm:ss,SSS},可指定格式 如 %d{HH:mm:ss}
%l 输出日志事件发生位置,包括类目名、发生线程,在代码中的行数
%n 换行符
%m 输出代码指定信息,如info(“message”),输出message
%p 输出优先级,即 FATAL ,ERROR 等
%r 输出从启动到显示该log信息所耗费的毫秒数
%t 输出产生该日志事件的线程名
4.配置和使用
log4j的初始化需要读取一个配置文件,这个配置文件的名称存放在log4j.configuration 系统属性当中。
如果没有的话,默认会先寻找 classapth下的 log4j.xml ,如果找不到再寻找classpath下的 log4j.properties
4.1 log4j.properties配置文件示例
log4j.rootLogger=DEBUG, stdout, R
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L %M) %m%n
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=example.log
log4j.appender.R.MaxFileSize=100KB
log4j.appender.R.MaxBackupIndex=1
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n
4.2 log4j.xml配置文件示例
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j='http://jakarta.apache.org/log4j/'>
<appender name="myConsole" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d{dd HH:mm:ss,SSS\} %-5p] [%t] %c{2\} - %m%n" />
</layout>
<!--过滤器设置输出的级别 -->
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="levelMin" value="debug" />
<param name="levelMax" value="warn" />
<param name="AcceptOnMatch" value="true" />
</filter>
</appender>
<appender name="myFile" class="org.apache.log4j.RollingFileAppender">
<param name="File" value="D:/output.log" /><!-- 设置日志输出文件名 -->
<!-- 设置是否在重新启动服务时,在原有日志的基础添加新日志 -->
<param name="Append" value="true" />
<param name="MaxBackupIndex" value="10" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%p (%c:%L)- %m%n" />
</layout>
</appender>
<appender name="activexAppender" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="E:/activex.log" />
<param name="DatePattern" value="'.'yyyy-MM-dd'.log'" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d{MMdd HH:mm:ss SSS\} %-5p] [%t] %c{3\} - %m%n" />
</layout>
</appender>
<!-- 指定logger的设置,additivity指示是否遵循缺省的继承机制 -->
<logger name="com.mytest" additivity="false">
<level value="info"></level>
<appender-ref ref="activexAppender" />
</logger>
<!-- 根logger的设置 -->
<root>
<priority value="debug" />
<appender-ref ref="myConsole" />
<appender-ref ref="myFile" />
</root>
</log4j:configuration>
4.3 使用
log4j的使用是非常简单的
public class BasicTest {
// 获取到Logger对象
static Logger logger = Logger.getLogger(BasicTest.class);
public static void main(String[] args) {
//打印日志
logger.info("Entering application.");
logger.info("Entering application.");
}
}
5. 关于日志使用的几点建议
5.1 对于异常的日志最好打印堆栈
故障排查是,查看线上日志时一个最直接的途径,我们希望在日志中打印出来一场堆栈
例如 logger.error("error msg", e);
5.2 打印的日志消息内容最好可以有业务场景信息
打印出来的日志最好有业务场景的上下文内容
例如 logger.error("消息推送过程中发生异常, message:" + mesage.toString() , e);
5.3 最好在输出日志的方法上进行判断
只有输出日志的级别>=Logger预定级别的时候,这条日志才会被输出
看下面一行代码:
logger.debug("Entry number: " + i + " is " + String.valueOf(entry[i]));
如果 输出日志的级别<Logger预定级别,日志不会输出,但是却进行了输入字符串的拼接,应该将上面的代码修改为
if(logger.isDebugEnabled() {
logger.debug("Entry number: " + i + " is " + String.valueOf(entry[i]));
}
进一步修改,可以使用StringBuilder替代String的直接拼接
分享到:
相关推荐
log4j学习笔记log4j学习笔记log4j学习笔记log4j学习笔记log4j学习笔记log4j学习笔记log4j学习笔记log4j学习笔记log4j学习笔记
Log4j 学习笔记
Log4j 学习笔记. 1. Log4j的类图 2. Logger:日志写出器 1. Logger的输出方法 2. Logger的命名规则 3. Log level 4. 示例代码 5. 关于logger的两点说明 3. Appender:日志目的地 1. ConsoleAppender 2. ...
Log4j学习笔记和一套完整定义实例 精辟
log4j 学习笔记 自己整理出来的 网上写的很杂乱。其实在java企业级中开发 我们更重视的是如何做日志记录。本笔记快速入门使用 log4j 节省了企业开发的学习成本
Log4J学习笔记 1、配置文件 2、数据库 3、封装
log4j的详细学习笔记,最适合初级、中级学员
log4j学习笔记.
*Log4j 学习笔记,自己的一点学习经验
log4j学习笔记及写入数据库配置,一份log4j学习资料。还包含log4j写入数据库的配置方法。
供初学人员学习,包括log4J的文件配置以及代码示例
log4j的学习笔记,网上找到的,写的很不错
Log4j 是 Apache 的一个开放源代码项目,通过使用 Log4j ,我们可以控制日志信 送的目的地是控制台、文件、 GUI 组件、甚至是套接口服务器、 NT 的事件记录器、 X Syslog 守护进程等;我们也可以控制每一条日志的...
log4j学习笔记.培训架构的学习资料,分享给大家,希望对大家有用!
Log4j2学习笔记,引入log4j2的依赖-log4j2.xml配置模板-application.properties文件配置-使用
在应用程序中添加日志记录总的来说基于三个目的:监视代码中变量的变化情况,周期性的记录到文件中供其他应用进行统计分析工作;跟踪代码运行时轨迹,作为日后审计的依据;担当集成开发环境中的调试器的作用,向文件...
Log4j log for java(java的日志) 是java主流的日志框架,提供各种类型,各种存储,各种格式,多样化的日志服务。Log4j是Apache的一个开放源代码项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、...
pptx格式。Log4j详细讲解。Logger--日志写出器,供程序员输出日志信息 。Log4j 允许开发人员定义多个Logger,每个Logger拥有自己的名字,Logger之间通过名字来表明隶属关系。