关闭 x
IT技术网
    技 采 号
    ITJS.cn - 技术改变世界
    • 实用工具
    • 菜鸟教程
    IT采购网 中国存储网 科技号 CIO智库

    IT技术网

    IT采购网
    • 首页
    • 行业资讯
    • 系统运维
      • 操作系统
        • Windows
        • Linux
        • Mac OS
      • 数据库
        • MySQL
        • Oracle
        • SQL Server
      • 网站建设
    • 人工智能
    • 半导体芯片
    • 笔记本电脑
    • 智能手机
    • 智能汽车
    • 编程语言
    IT技术网 - ITJS.CN
    首页 » JAVA »Java日志记录的5条规则

    Java日志记录的5条规则

    2015-12-30 00:00:00 出处:oneapm
    分享

    微信扫一扫:分享

    Scan me!

    微信里点“发现”,扫一下

    二维码便可将本文分享至朋友圈。

    日志记录是在软件开发过程中常常需要考虑的关键因素。

    当产品运行出错时,日志文件通常是我们进行错误分析的首要选择。

    而且,在很多情况下,它们是我们手上唯一可以用来查明发生状况和问题根本原因的信息。

    可见,正确记录需要的信息是极其重要的。

    以下5条日志规则,让我们可以检查和改进在代码中操作日志记录的方式。

    同时也请注意,我们既不会讨论怎么配置一个日志引擎,也不会相互比较。

    规则1、日志是面向读者的

    日志消息不仅要对书写(日志)代码的人有意义,也应该对日志文件的读者有意义。

    这似乎是一条很明显但却经常违背的规则。

    ERROR: Save failure - SQLException .....

    举个例子吧,我们来看看下面这条日志信息:

    ERROR: Save failure - SQLException .....

    保存什么呢?这条消息在开发者看来是能说明一些问题的,但是对于正在苦苦查看产品问题的可怜家伙来说,却毫无用处。

    RROR: Save failure- Entity=Person, Data=[id=123 surname="Mario"] - SQLException....

    更合适的信息是这样的:

    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 在代码中添加日志消息,来更好地掌握应用程序在执行、调试期间发生的状况。

    void aMethod(String aParam) {
      LOGGER.debug(“Enter in aMethod”);
      if (“no”.equals(aParam)) {
      LOGGER.debug(“User says no”);
      ….

    比如这样的代码:

    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 消息。

    if ( LOGGER.isDebugEnabled((){
     LOGGER.debug (…….)
     }

    每次你想要 log 一个 DEBUG 消息时(在使用了规则3后的留下的所有消息),需要在前面添加一个检查来明确是否启用了 DEBUG 日志:

    if ( LOGGER.isDebugEnabled((){
     LOGGER.debug (…….)
     }

    这种做法可以阻止代码去创建日志消息和调用 logger,提高产品运行程序的效率。

    规则5、了解你的 logger

    我们使用 logger 方法的方式可能会带来巨大的开销:

    创建消息字符串 组织包含在消息字符串中的数据

    我们应该查阅所选择的日志管理工具、引擎的 javadoc 文档,了解使用它们 logger 的最有效的方法。

    LOGGER.info(“Person name is “ + person.getName());

    例如,我们可以创建一条这样的消息:

    LOGGER.info(“Person name is “ + person.getName());

    这就创建了不必要的字符串实例。

    LOGGER.info(“Person name is {}“, person.getName());

    使用SLF4J,正确的用法应该是:

    LOGGER.info(“Person name is {}“, person.getName());

    这里的格式化字符串是常量,不可变消息只有在允许 logging 的情况下才会被创建。

    上一篇返回首页 下一篇

    声明: 此文观点不代表本站立场;转载务必保留本文链接;版权疑问请联系我们。

    别人在看

    抖音安全与信任开放日:揭秘推荐算法,告别单一标签依赖

    ultraedit编辑器打开文件时,总是提示是否转换为DOS格式,如何关闭?

    Cornell大神Kleinberg的经典教材《算法设计》是最好入门的算法教材

    从 Microsoft 下载中心安装 Windows 7 SP1 和 Windows Server 2008 R2 SP1 之前要执行的步骤

    Llama 2基于UCloud UK8S的创新应用

    火山引擎DataTester:如何使用A/B测试优化全域营销效果

    腾讯云、移动云继阿里云降价后宣布大幅度降价

    字节跳动数据平台论文被ICDE2023国际顶会收录,将通过火山引擎开放相关成果

    这个话题被围观超10000次,火山引擎VeDI如此解答

    误删库怎么办?火山引擎DataLeap“3招”守护数据安全

    IT头条

    平替CUDA!摩尔线程发布MUSA 4性能分析工具

    00:43

    三起案件揭开侵犯个人信息犯罪的黑灰产业链

    13:59

    百度三年开放2.1万实习岗,全力培育AI领域未来领袖

    00:36

    工信部:一季度,电信业务总量同比增长7.7%,业务收入累计完成4469亿元

    23:42

    Gartner:2024年全球半导体营收6559亿美元,AI助力英伟达首登榜首

    18:04

    技术热点

    iOS 8 中如何集成 Touch ID 功能

    windows7系统中鼠标滑轮键(中键)的快捷应用

    MySQL数据库的23个特别注意的安全事项

    Kruskal 最小生成树算法

    Ubuntu 14.10上安装新的字体图文教程

    Ubuntu14更新后无法进入系统卡在光标界面解怎么办?

      友情链接:
    • IT采购网
    • 科技号
    • 中国存储网
    • 存储网
    • 半导体联盟
    • 医疗软件网
    • 软件中国
    • ITbrand
    • 采购中国
    • CIO智库
    • 考研题库
    • 法务网
    • AI工具网
    • 电子芯片网
    • 安全库
    • 隐私保护
    • 版权申明
    • 联系我们
    IT技术网 版权所有 © 2020-2025,京ICP备14047533号-20,Power by OK设计网

    在上方输入关键词后,回车键 开始搜索。Esc键 取消该搜索窗口。