日志规范(初稿)

《日志规范(初稿)》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、日志规范一．什么时候打日志原则：一般来说日志分为两种：业务日志和异常日志，使用日志我们希望能达到以下目标：1.对程序运行情况的记录和监控；2.在必要时可详细了解程序内部的运行状态；3.对系统性能的影响尽量小通常情况下在程序日志里记录一些比较有意义的状态数据：程序启动，退出的时间点；程序运行消耗时间；耗时程序的执行进度；重要变量的状态变化。除此之外，在公共的日志里规避打印程序的调试或者提示信息。日志等级：1.成品阶段：我的代码是INFO等级，第三方库是WARN。2.测试、集成阶段：我的代码是DEBUG等级，第三方库是WARN（或者如果需要的话是I

2、NFO）。3.开发阶段：任何有意义的信息。注意：不建议使用TRACE/FINEST等级二．怎么打日志（日志最佳实践）编码规范：1.在一个对象中通常只使用一个Logger对象，Logger应该是staticfinal的，只有在少数需要在构造函数中传递logger的情况下才使用privatefinal。staticfinallogger_LOG=loggerFactory.getLogger(Main.class);1.输出Exceptions的全部Throwable信息，因为logger.error(msg)和logger.error(msg,e

3、.getMessage())这样的日志输出方法会丢失掉最重要的StackTrace信息。例子：voidfoo(){try{//dosomething...}catch(Exceptione){_LOG.error(e.getMessage());//错误_LOG.error("Badthings:",e.getMessage());//错误_LOG.error("Badthings:",e);//正确}}2.不允许记录日志后又抛出异常，因为这样会多次记录日志，只允许记录一次日志。例子：voidfoo()throwsLogException{tr

4、y{//dosomething...}catch(Exceptione){_LOG.error("Badthings:",e);thrownewLogException("Badthings:",e);}}1.不允许出现Systemprint(包括System.out.println和System.error.println)语句。例子：voidfoo(){try{//dosomething...}catch(Exceptione){System.out.println(e.getMessage());//错误System.err.printl

5、n(e.getMessage());//错误_LOG.error("Badthings:",e);//正确}}2.不允许出现printStackTrace。例子：voidfoo(){try{//dosomething...}catch(Exceptione){e.printStackTrace();//错误_LOG.error("Badthings:",e);//正确}}3.日志性能的考虑，如果代码为核心代码，执行频率非常高，则输出日志建议增加判断，尤其是低级别的输出。debug日志太多后可能会影响性能，有一种

6、改进方法是：if(LOGGER.isDebugEnabled()){LOGGER.debug("returningcontent:"+content);}1.但更好的方法是Slf4j提供的最佳实践:LOGGER.debug("returningcontent:{}",content);一方面可以减少参数构造的开销，另一方面也不用多写两行代码。2.日志可读性，不仅仅面向开发举个例子吧，我们来看看下面这条日志信息：ERROR:Savefailure-SQLException.....保存什么呢？这条消息在开发者看来是能说明一些问题的，但是对于正在苦

7、苦查看产品问题的可怜家伙来说，却毫无用处。更合适的信息是这样的：RROR:Savefailure-Entity=Person,Data=[id=123surname="Mario"]-SQLException....3.提交前去除编码帮助日志编程时用的debug，需要发布时去掉：如：voidaMethod(StringaParam){LOGGER.debug(“EnterinaMethod”);if(“no”.equals(aParam)){LOGGER.debug(“Usersaysno”);发布时，去除帮助日志。1.减少应使用debug导致

8、性能开销增加如果是Slf4j，可以将LOGGER.info(“Personnameis“+person.getName());改为：LOGGER.in