在java中记录日志的十个小建议(代码片段)

lilinwei340 lilinwei340     2023-01-02     714

关键词:

JAVA日志管理既是一门科学,又是一门艺术。科学的部分是指了解写日志的工具以及其API,而选择日志的格式,消息的格式,日志记录的内容,哪种消息对应于哪一种日志级别,则完全是基于经验。从过去的实践证明,JAVA的日志记录会严重的影响性能。我也曾多次亲眼见到在DEBUG模式下运行的在线股票交易程序,比在WARN或是其它更高层次模式下运行时延时要严重的多。延时和速度是任何电子交易平台或是股票交易平台的一个重大关注点,所以我们必须了解并掌握JAVA日志及其最佳实践。这不仅仅只是为了用在金融或是投资银行领域,它适用于所有既追求速度又需要日志功能的应用。

为何需要日志

这是一个很基本的争议,人们会争辩说,我们可以使用System.out.println()来打印消息,为何还需要日志呢?每个人刚开始接触JAVA时,都使用System.out.println()在控制台打印消息。但是它的功能远远没有日志记录API如log4j或是java.util.logging强大。如果你正在写一个java服务器应用,那么你只有通过日志文件才能知道你的服务器在做什么。如果你没有记录任何日志,那么没有人知道你的服务器在干啥。而如果你的服务器作为一个中间件连接到应用中时,比如从股票交易系统或是电子交易系统获得输入流,将其转换并标准化后发送到输出流,这时日志就更为重要。没有日志你根本不知道究竟哪里出了问题。因此,日志在JAVA中是必不可少的。

JAVA中有哪些不同的日志级别

使用过JAVA日志的童鞋一定知道这些基础的日志级别比如DEBUG, INFO, WARN和ERROR

DEBUG是最低的限制级别。这个级别只能用于开发和测试环境中,不可以用于生产环境。

INFO略高于DEBUG的限制级别,我们应该用这个级别记录一些信息型消息比如服务器启动成功,输入的数据,输出的数据等等。

WARN的限制级别高于INFO,它用来记录警告信息比如客户端和服务器之间的连接中断,数据库连接丢失,Socket达到上限。这些信息是最为重要的,因为你可以在这些信息出现时发出警告,从而让运维团队管理应用程序的运行,并及时处理这些报错。

ERRORWARN的限制级别还高,用于记录ERRORException。你可以在该日志级别上设置警报装置,并且提醒运维团队对之做出处理。ERROR非常重要,你必须将其记录下来。

FATAL是指可能导致程序终止的非常严重的时间。在这种事件之后你的应用很可能会崩溃。

OFF具有最高的级别,旨在关闭JAVA中的日志功能。

这些日志级别是根据slf4j整理的,和java.util.loggingAPI中定义的级别不太一样。java.util.logging还提供了其它的基于问题严重性进行划分的日志级别如SEVERE, FINER, FINEST, FATAL 等。

使用log4j还是java.util.logging

 

我会推荐使用log4j,你可能会对此持有异议。我也同意java.util.logging的功能很强大,但是我发现log4j更易于使用。你已经了解了log4j的各个日志级别,这里每个级别都非常恰当的描述了其功能。log4j还提供了额外的灵活性,你无需重新启动应用来改变日志的级别。当然,你也可以在java.util.logging中通过JMX实现这个功能。

log4j还允许我们在配置文件log4j.xml中设置每个类的日志级别。你既可以使用XML文件也可以使用properties文件进行配置。而且log4j是线程安全的。它被设计用于高并发的系统中。在另一方面,我发现java.util.logging中的FormatterAppender功能非常棒。

为何在JAVA中使用日志会影响性能

通常来说,记录日志越频繁,所需的IO操作就越多,从而影响了应用的性能。因此为每一个消息选择一个合适的日志级别是非常重要的。既然我们不能不使用JAVA日志,那么我们只能控制日志的级别以及在那个级别上记录的日志内容。所以,一定要在isDebugEnabled()代码块中记录DEBUG消息,如下所示:

if(logger.isDebugEnabled())
    logger.debug("java logging level is DEBUG Enabled")

在生产环境中一定要使用WARN或是更高级别的日志记录等级,一定不要使用DEBUG。它很可能成为性能下降的罪魁祸首。

JAVA日志的10个小建议

1.将DEBUG日志访日isDebugEnabled代码块

它能显著的减少因为字符串拼接而带来的性能的影响。

2.谨慎的消息的等级

当你在编写服务器端应用时,这一点显得格外的重要,因为它是你观察服务器运行情况的唯一途径。如果你记录了太多的日志,则会影响服务器的性能,但是如果你不记录重要的信息如输入数据和输出数据,那么就很难识别究竟发生了什么问题。

3.使用slf4j或是java.util.loggin

我推荐slf4j因为它的灵活性非常高。它允许在不重启应用的前提下更改日志级别。你可以通过log4j的看门狗来不停的寻找目录中的log4j.xml配置文件,并且在找到后重置日志配置。

4.log4j可以为不同的类配置不同的日志级别

你可以将一些类设置为INFO级别,再将另一些类设置为WARN级别或是ERROR级别。

5.日志的格式化

不要忘了记录线程的名称和完整的JAVA类名,因为如果有多个线程同时在执行这段代码,你可能根本找不出事件序列。在我看来,这一条建议最为重要

6.从日志中生成报告

在记录日志时要保证一致性和信息性,从而可以分析日志。

7.使用前缀来说明哪一部分代码在打印日志

前缀是指如客户端,数据库或是Session等等。之后你可以使用grep或是find来找到和这些关键字相关的日志。我在进行了这种实践后发现它非常有助于debug或是调查事件,尤其是当日志文件很庞大的时候。你可以将所有数据库级别的日志加上前缀DB_LOG,再将所有SESSION级别的日志加上前缀SESSION_LOG

8.如果某个日志没有分配等级,则将其继承最近级别的等级

这也是为什么我们总是将日志等级分配到根日志上log4j.rootLogger=DEBUG.

9.没有日志和过度日志都是不好的

原因前面已经说明

10.自检日志并调整日志

最好用英文记录日志,而且要有良好的可读性,从而在查阅时能够快速理解日志。

11.使用标准化格式而不要自行拼接

logger.debug("No of Orders " + noOfOrder + " for client: " + client);//不好
logger.debug("No of Orders  for client: ", noOfOrder, client);

补充:记录哪些信息以及各个信息对应什么级别的日志

1.不要记录敏感信息

不要记录敏感信息如密码,身份证号,信用卡号或账户号。

2.尽量记录决策性信息

比如,一个JAVA应用需要从偏好文件或是环境中加载配置,如果没有找到就使用默认的配置。如果你在使用默认配置,那么你应当记录如下信息:

logger.info("Not able to load personal settings, default Setting selected for user : ", user);

这个日志丢失了一个关键性信息,为什么无法加载到个人配置?因此如果出现异常的话,还应当记录异常。当然,这条日志也提供了有用的信息,比如究竟是哪个用户遇到了这个问题。

3.一致性

一致性在日志和编码中都很重要。无论你采用哪种格式,你都应当坚持一致性。你应当花些时间仔细考虑日志的格式,从而用它来捕获有用的信息。

4.记录一切出现问题时辅助debug的信息

举个例子,我们经常在应用中将String转化为Date,如果String的格式不正确的话,我们通常会抛出ParseException。但是我经常看到有的代码里捕获了这个异常之后,将Date赋值为null并打印如下日志:

logger.info("failed to convert String to date")

看到这行日志的时候,你根本不知道那个date传入了不合法的值。它也没有打印出不合法的String的内容究竟是什么。你需要这些信息来解决这个问题。一个更好的日志信息如下:

logger.info("invalid startDate: ", startDate);

5.异常信息应该包括两类信息:案发现场信息和异常堆栈信息。如果不处理,那么通过 关键字 throws 往上抛出。

logger.error(各类参数或者对象 toString + "_" + e.getMessage(), e); 

6.谨慎地记录日志。

生产环境禁止输出 debug 日志;有选择地输出 info 日志;如果使 用 warn 来记录刚上线时的业务行为信息,一定要注意日志输出量的问题,避免把服务器磁盘 撑爆,并记得及时删除这些观察日志。

转自 https://segmentfault.com/a/1190000013366405

给java初学者的十条小建议,快来收藏吧

就当前的IT环境来看,招聘Java程序员的公司多,学习Java技术的也多。对于Java初学者而言,技术学习是我们首要考虑的问题。对此,小千总结了以下十条小建议,希望对大家学习Java有帮助。1、与其反复阅读... 查看详情

java异常处理的十个建议(代码片段)

前言Java异常处理的十个建议,希望对大家有帮助~本文已上传github:https://github.com/whx123/JavaHome公众号:捡田螺的小男孩一、尽量不要使用e.printStackTrace(),而是使用log打印。反例:try//dowhatyouwantcatch(Exceptione)e.printStackTrace();正例:try//do... 查看详情

2021-06-02hive课后实验5(一些小建议)(代码片段)

把课后实验写了一下,总结一下自己遇到的问题及解决方法。安装完hive后操作遇到错误可以参考一下启动hive遇到这个的话一般没啥大问题,忽略)创建数据库:createdatabaseifnotexistshive;这句代码可以理解为这样ÿ... 查看详情

爬虫00-给刚接触编程的童鞋的一点小建议(代码片段)

个人公众号yk坤帝获取更多学习资料,学习建议我们刚去接触一个新的领域的时候,绝大多数人都会有很多疑惑,毕竟天才只占极小的一部分。我们遇到问题的时候,不假思索,第一惯性就是去寻求周边人的帮... 查看详情

日常管理的五条小建议

...自己一些喘息的机会,停下来。思考一会儿。这里有一些小建议,能够帮助你处理好日常管理工作。计划并安排一对一会谈。做管理意味着你要分神去处理人的问题:与人单独谈话。并在过程中给予指导和反馈。或者教他们如何... 查看详情

提高代码可读性的一点小建议

3.UI工厂类与代码块UI工厂类: 其实代码很简单,就是把对Label,Button等控件的属性赋值封装一下,做到一行代码就能创建一个VIew,如下图,虽然这一句代码有点长,但是习惯之后写个View是真心快UI工厂类.h 查看详情

「?八点工作中的小建议」?写出我心(七十二)

?八点工作中的小建议首发 |微信公众号「编程随想曲」1.时刻清楚本职工作的关键问题;2.不断积累所在领域的专业知识;3.定期与相关同事请教知识和工作心得;4.主动承担责任边界不明确,但必须做的事;5.与同事沟通时少... 查看详情

juc并发编程--wait和sleep的区别&加锁对象的小建议&waitnotify的正确姿势&虚假唤醒(代码片段)

1.wait和sleep的区别sleep是Thread方法,而wait是Object的方法sleep不需要强制和synchronized配合使用,但wait需要和synchronized一起用(只有获取到了锁才可以调用wait方法)。sleep在睡眠的同时,不会释放对象锁的,但w... 查看详情

2021-06-02hive课后实验5(一些小建议)(代码片段)

把课后实验写了一下,总结一下自己遇到的问题及解决方法。安装完hive后操作遇到错误可以参考一下启动hive遇到这个的话一般没啥大问题,忽略)创建数据库:createdatabaseifnotexistshive;这句代码可以理解为这样ÿ... 查看详情

2020年精心收集的十个java开发网站

不管谁手里都藏着些许自己觉得好用的网站,今天专门找大厂出来的同学同事觉得好用的网站分享给大家,如果这里有你没收藏还不知道觉得还蛮有用的网站可以给我点个赞,大家一起进步,一起学习,同时也可以分享你觉得好... 查看详情

aop和castle的一些小建议

 https://www.cnblogs.com/zhaogaojian/p/8360363.html 查看详情

新学期的一些安排|以及一些小建议

大家好,我是K同学啊!不知不觉中,新的一学期又开始了,是不是还有点意犹未尽呢抱歉,开学了!Ta们都已经开始“卷”了!今天和大家分享一下我的新学期计划(立flag)主要还是围绕《深... 查看详情

网页搜索(百度谷歌)你不得不知道的十个小技巧(代码片段)

网页搜索(百度谷歌)你不得不知道的十个小技巧百度搜索广告多,谷歌搜索搜不到东西,这时候,你得问问自己——你,用对姿势了么?文章目录网页搜索(百度谷歌)你不得不知道的十个小... 查看详情

值得收藏面试会用到的十个常用的数组方法js实现(代码片段)

【手撕代码系列】之十个常用的数组方法JS实现(一)🚀通俗易懂的实现方式,帮助我们认识相应的方法📚收藏本系列,基础进阶两不误🎉本系列持续更新,欢迎查看线上地址写在前面代码实现系... 查看详情

不要慌,我有亿点小建议!万字长文

Part1关于本文由于近两年互联网寒冬,整个就业市场哀鸿遍野,有关于当前形势下计算机硕士如何找工作的问题。有一些还在学校的小朋友也是比较发愁。故尝试从个人经验出发,分享一些自己在找工作方面的认知。... 查看详情

在文件系统linux命令中查找最大的十个文件

from:http://www.cyberciti.biz/faq/how-do-i-find-the-largest-filesdirectories-on-a-linuxunixbsd-filesystem/du-a/var|sort-n-r|head-n10 查看详情

给初入职场的码农的一些小建议

 1)请热爱你的工作,用认真的态度去做好每一件小事。2)三人行必有我师,多向你身边的人请教学习,对待技术要诚实,不会就一定要有“不要脸”的精神去问清楚,搞明白。3)高效工作。如果是技术不够熟练,就多投入... 查看详情

预处理器less的十个语法(代码片段)

Less是一门CSS预处理语言,它扩充了CSS语言,增加了诸如变量、混合(mixin)、函数等功能,让CSS更易维护、方便制作主题、扩充。不过浏览器只能识别CSS语言,所以Less语言直接运行在浏览器端是不被识别... 查看详情