`
- 浏览:
185201 次
-
转载地址:http://www.iteye.com/news/31284
日志记录是在软件开发过程中常常需要考虑的关键因素。
当产品运行出错时,日志文件通常是我们进行错误分析的首要选择。
而且,在很多情况下,它们是我们手上唯一可以用来查明发生状况和问题根本原因的信息。
可见,正确记录需要的信息是极其重要的。
以下5条日志规则,让我们可以检查和改进在代码中操作日志记录的方式。
同时也请注意,我们既不会讨论怎么配置一个日志引擎,也不会相互比较。
规则1、日志是面向读者的
日志消息不仅要对书写(日志)代码的人有意义,也应该对日志文件的读者有意义。
这似乎是一条很明显但却经常违背的规则。
举个例子吧,我们来看看下面这条日志信息:
Java代码
ERROR: Save failure - SQLException .....
保存什么呢?这条消息在开发者看来是能说明一些问题的,但是对于正在苦苦查看产品问题的可怜家伙来说,却毫无用处。
更合适的信息是这样的:
Java代码
RROR: Save failure- Entity=Person, Data=[id=123 surname="Mario"] - SQLException....
这就解释了你想要存储的东西(这里是一个 Person,是一个 JPA 实体)以及这个 Person 实例相关的内容。
请注意相关这个单词,并不是指泛泛的全体:我们不应该让无价值的信息使日志文件变得乱糟糟,比如说完整打印所有的实体字段。
通常,实体名字和其逻辑关键字足以识别在表格中的一条记录了。
规则2、匹配日志等级和执行环境
在 Java 系统中提供的所有日志管理工具和引擎都有日志等级(ERROR、INFO……)的概念,这将有可能过滤掉等级过低的消息。
例如,Java util logging 使用如下的等级:SEVERE、WARN、INFO、FINE、FINER、FINEST(+ CONFIG 和 OFF)。相反,两个最受欢迎的日志管理工具, Apache Commons Logging 和 SLFJ 更倾向于如下的等级:FATAL、ERROR、WARN、INFO、DEBUG、TRACE。
日志过滤等级则需要取决于代码的开发阶段:成品与仍处在测试、集成环境下的代码日志等级就不能相同。
更具体的来说,日志等级也应该参考代码的归属情况。
一般而言,我们自己的应用程序代码应该比使用的任何第三方开发库拥有更详细的日志记录。
比如说,Apache 的通用调试消息出现在我们的日志文件中,就没有多大意义。
我通常像这样配置日志记录:
成品阶段: 我的代码是 INFO 等级,第三方库是 WARN。
测试、集成阶段:我的代码是 DEBUG 等级,第三方库是 WARN(或者如果需要的话是 INFO)。
开发阶段:任何有意义的信息。
注意:个人而言,我不建议使用 TRACE/FINEST 等级(我并不是唯一持这种观点的人,可以参考 这里 的例子)。
我并没有发现 DEBUG 和 TRACE 有多大的区别,而年轻团队的成员常常苦恼于到底是使用 DEBUG 还是 TRACE 。
根据KISS原则,我建议只使用RROR、WARN、INFO和DEBUG等级。
规则3、提交前去除编码帮助日志
编码时,我们常常会使用 logger 或是 System.out 在代码中添加日志消息,来更好地掌握应用程序在执行、调试期间发生的状况。
Java代码
void aMethod(String aParam) {
LOGGER.debug(“Enter in aMethod”);
if (“no”.equals(aParam)) {
LOGGER.debug(“User says no”);
….
比如这样的代码:
Java代码
void aMethod(String aParam) {
LOGGER.debug(“Enter in aMethod”);
if (“no”.equals(aParam)) {
LOGGER.debug(“User says no”);
….
这些消息显示被调用的方法并且备份内部变量及方法参数值,主要是为了追踪应用程序的行为。这在非测试驱动开发中相当受欢迎。
但糟糕的是,一旦代码发布(测试之后成为成品)这些消息通常就无用武之地了。
所以,这条规则简单来说就是:一旦你已经完成开发工作,在将代码提交到使用中的 SCM 系统(git、svn……)之前,要去除所有临时的和不必要的日志消息。
这条规则并不是要求去除所有的 DEBUG 消息,只是针对那些在应用程序完成和发布后就没有意义的消息,或者是说当我们有理由相信应用程序能正确运行时就失去意义的那些消息。
规则4、log DEBUG消息之前检查日志等级
根据第2条规则,在产品日志中,我们只会显示ERROR、WARN、INFO 等级的消息,但是在代码中我们也可以使用一些不会影响产品运行的DEBUG消息。
Java代码
if ( LOGGER.isDebugEnabled((){
LOGGER.debug (…….)
}
每次你想要 log 一个 DEBUG 消息时(在使用了规则3后的留下的所有消息),需要在前面添加一个检查来明确是否启用了 DEBUG 日志:
Java代码
if ( LOGGER.isDebugEnabled((){
LOGGER.debug (…….)
}
这种做法可以阻止代码去创建日志消息和调用 logger,提高产品运行程序的效率。
规则5、了解你的 logger
我们使用 logger 方法的方式可能会带来巨大的开销:
创建消息字符串
组织包含在消息字符串中的数据
我们应该查阅所选择的日志管理工具、引擎的 javadoc 文档,了解使用它们 logger 的最有效的方法。
Java代码
LOGGER.info(“Person name is “ + person.getName());
例如,我们可以创建一条这样的消息:
Java代码
LOGGER.info(“Person name is “ + person.getName());
这就创建了不必要的字符串实例。
Java代码
LOGGER.info(“Person name is {}“, person.getName());
使用SLF4J,正确的用法应该是:
Java代码
LOGGER.info(“Person name is {}“, person.getName());
这里的格式化字符串是常量,不可变消息只有在允许 logging 的情况下才会被创建。
分享到:
Global site tag (gtag.js) - Google Analytics
相关推荐
Java日志记录的5条规则Java开发Java经验技巧共5页.pdf.zip
调用方法:IndexDataLog.print(入参),可以设置文件大小,文件写满以后自动创建新的日志文件。一般用来记录用户的搜索词,或操作记录。目前以json格式保存日志,入参稍作修改,可以传入对象,linux和windows都支持。
本压缩包内附带log4j-1.2.14和commons-logging-1.1.1,Java日志记录行业标准组件。不要分啦。鄙视开源组件还收费的猥琐鬼。
#是否在日志记录前加日期时间字符串,取值0或1(立即生效) isAddDateTimeStringToHead=1 #当isAddDateTimeStringToHead为1时有效,表示时间串的格式,必须为java认识的时间格式;特别的,如果为“UNIX_TIMESTAMP”...
java已经有很多的logger jar,但是使用和配置起来都存在一定复杂性,不适合程序的调试和开发 本人在实际的工作根据实际需要提供以下简便的logger日志系统。 希望和同道中人进行交流。 这个jar很小,也很方便使用...
您可以使用三种主要的Java日志记录框架: , 和 。 Java的Splunk日志记录也启用了Java的 。 Java的Splunk日志记录提供: 将事件打包成适合您所使用输入类型(HTTP事件收集器或TCP)的正确格式的Appender类。 ...
NULL 博文链接:https://janeky.iteye.com/blog/455298
Java EE 和 Jakarta EE 版本 鉴于下游用户可能在其项目中依赖 Java EE(在 javax 命名空间中)或 Jakarta EE(在 jakarta 命名空间中),因此 logback 支持这两种 EE 替代方案被认为很重要。 版本 1.3.x 支持 Java ...
Logger类和LoggerFactory类没有的话,下载这个包
本篇文章主要介绍了JAVA实现通用日志记录方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
clogg-java:轻量级的Java日志记录库
Java日志记录是数十年来积累的相互竞争和不兼容的框架的烂摊子。 很为这个可悲的复杂世界添加另一个变体。 与更流行的SLF4J API相比,Log5j的API实际上要好用得多。 例如,它具有printf样式的格式,比{}样式的格式...
1996年初,欧洲安全电子市场(EU SEMPER)项目组决定编写...Log4j是一个开放源码项目,一个非常流行的Java日志记录包。它允许开发者向代码中插入日志记录语句,还允许在不修改应用程序源码的情况下修改记录日志的行为。
自定义过滤器,过滤请求接口的请求,认证用户并记录日志
日志记录是在软件开发过程中常常需要考虑的关键因素。 当产品运行出错时,日志文件通常是我们进行错误分析的首要选择。 而且,在很多情况下,它们是我们手上可以用来查明发生状况和问题根本原因的信息。 ...
记录器实例会将消息的日志记录级别与其日志记录级别进行比较。 如果消息的日志级别达到或超过记录器的日志级别,则日志消息将传递给其注册的处理程序。 默认情况下,日志消息也将传递给其父级的处理程序。 处理...
不管我们使用何种语言开发,一旦程序发生异常,日志是一个很重要的数据。但是并不是意味着打印的日志越多越好,我们需要的是有用的日志。下面小编来和大家一起学习以下知识
java 写日志记录到指定目录下(一天一个文档)
java swing用Logger输出错误日志
详细介绍了log4j的使用方法,介绍了java中日志记录如何写入数据库,对于初学者来说很不错的一个文档