ESFramework介绍之(24)―― 日志记录IEsbLogger

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介: 框架,从另外一个角度说,就是一个半成品的应用程序,既然如此,框架在运行的过程中也会遇到诸多的异常、错误情况,我们需要将这些情况记录下来,以便在发生问题时为我们的诊断提供必要的帮助。    最最开始,那还是在ESFramework的前身即EnterpriseServerBase的时候,由于当时只是将EnterpriseServerBase作为一个类库,而并没有提升到一个框架的高度,所以是没有必要为之配备一个日志记录器(Logger),就像你从来不曾看到在使用.NET类库时还必须传个日志记录器给它,以使.NET类库中的API碰到额外情况时能够记录下错误信息。
    框架,从另外一个角度说,就是一个半成品的应用程序,既然如此,框架在运行的过程中也会遇到诸多的异常、错误情况,我们需要将这些情况记录下来,以便在发生问题时为我们的诊断提供必要的帮助。
    最最开始,那还是在ESFramework的前身即EnterpriseServerBase的时候,由于当时只是将EnterpriseServerBase作为一个类库,而并没有提升到一个框架的高度,所以是没有必要为之配备一个日志记录器(Logger),就像你从来不曾看到在使用.NET类库时还必须传个日志记录器给它,以使.NET类库中的API碰到额外情况时能够记录下错误信息。类库中的API遇到额外情况时通常是抛出异常或返回错误码(C API的常用方式)。
    到了框架这一层,就不能仅仅只是抛出异常、或返回错误码这么简单了。原因在于,几乎所有的框架都有IOC的能力(正是这种IOC能力才能称之为框架,才能称之为半成品的应用),即,不是由你去调用框架的API,而是框架调用你写好的方法或接口。在这种情况下,控制权发生了转移,框架成了主动的角色。既然如此,如果框架运行抛出异常的话,这个异常该由谁去截获了?所以,框架中具有IOC能力的那些类/组件(言外之意,一个框架中并非所有的组件/类都有IOC能力,很多组件/类都类似于普通类库中的API)在遇到异常情况时不能简单的抛出异常了事,更好的办法当然是主动地记录异常日志。
    从EnterpriseServerBase上升到ESFramework一个很重要的变化就是为之配备一个日志记录器,即我们这里将要讲到的IEsbLogger。IEsbLogger接口非常简单:
    public   interface  IEsbLogger
    {
        
void  Log( string  msg , string  location ,ErrorLevel level) ;
        
bool  Enabled{ set  ;}
    }

    [EnumDescription(
" 异常/错误严重级别 " )]
    
public   enum  ErrorLevel
    {
        [EnumDescription(
" 致命的 " )]
        Fatal,
        [EnumDescription(
" " )]
        High ,
        [EnumDescription(
" 普通 " )]
        Standard ,
        [EnumDescription(
" " )]
        Low
    } 
    
      ESFramework并没有给出IEsbLogger的任何实现,这个实现由应用来完成,你可以选择将日志信息记录到数据库、也可以记录到文本文件、甚至可以通过消息队列发送到专门分析处理异常日志的服务器上。而且,你还可以对不同ErrorLevel的信息进行不同的分类处理等等。IEsbLogger.Log方法中的location参数表明了该异常发生的位置,通常是类似于“ESFramework.NetWork.SomeClass.SomeMethod”等字符串。
   
ESFramework并不记录所有异常,因为有些异常,框架能够自行处理。比如,Tcp用户突然断开连接,此时对应连接上的读写操作将会抛出异常,而ESFramework会将此异常理解为用户掉线而触发相应的事件来通知相关的关注者(比如,ITcpUserManager)。ESFramework记录那些重要的、不可忽略的、对应用程序的稳定可能产生影响的异常,比如,FS和AS之间的Tcp连接池中断等。

    最后,简单说明一下ErrorLevel枚举上的EnumDescription特性的作用,该特性用于在枚举和枚举的描述之间能够互相解释和转换,比如我们实现IEsbLogger.Log方法,将日志写入数据库,可是第三个参数level是个枚举值,该如何记录了?我们可以通过EnumDescription.GetFieldText()方法将其转换成对应的描述,比如,ErrorLevel.Fatal枚举值转换为“致命的”这样一个字符串,这样就可以方便的存入数据库或写入文本了。EnumDescription的定义位于ESFramework的BaseElement目录下,主要参考并简化了“大尾巴狼”朋友的EnumDescription实现,感谢“大尾巴狼”的好点子。
    感谢关注!

转到  :ESFramework 可复用的通信框架(序) 
  



相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
目录
相关文章
|
Java 容器 Spring
ESFramework使用技巧(1)-- ESFramework 日志记录器的自动装配
ESFramework中很多重要的组件都配备了日志记录器IEsbLogger,用于记录框架运行时的错误和异常。这些重要组件都暴露了一个名为“EsbLogger”的属性,用于设值法注入日志记录器。
963 0
|
3天前
|
XML 安全 Java
【日志框架整合】Slf4j、Log4j、Log4j2、Logback配置模板
本文介绍了Java日志框架的基本概念和使用方法,重点讨论了SLF4J、Log4j、Logback和Log4j2之间的关系及其性能对比。SLF4J作为一个日志抽象层,允许开发者使用统一的日志接口,而Log4j、Logback和Log4j2则是具体的日志实现框架。Log4j2在性能上优于Logback,推荐在新项目中使用。文章还详细说明了如何在Spring Boot项目中配置Log4j2和Logback,以及如何使用Lombok简化日志记录。最后,提供了一些日志配置的最佳实践,包括滚动日志、统一日志格式和提高日志性能的方法。
76 30
【日志框架整合】Slf4j、Log4j、Log4j2、Logback配置模板
|
30天前
|
XML JSON Java
Logback 与 log4j2 性能对比:谁才是日志框架的性能王者?
【10月更文挑战第5天】在Java开发中,日志框架是不可或缺的工具,它们帮助我们记录系统运行时的信息、警告和错误,对于开发人员来说至关重要。在众多日志框架中,Logback和log4j2以其卓越的性能和丰富的功能脱颖而出,成为开发者们的首选。本文将深入探讨Logback与log4j2在性能方面的对比,通过详细的分析和实例,帮助大家理解两者之间的性能差异,以便在实际项目中做出更明智的选择。
182 3
|
3月前
|
Kubernetes Ubuntu Windows
【Azure K8S | AKS】分享从AKS集群的Node中查看日志的方法(/var/log)
【Azure K8S | AKS】分享从AKS集群的Node中查看日志的方法(/var/log)
129 3
|
30天前
|
存储 缓存 关系型数据库
MySQL事务日志-Redo Log工作原理分析
事务的隔离性和原子性分别通过锁和事务日志实现,而持久性则依赖于事务日志中的`Redo Log`。在MySQL中,`Redo Log`确保已提交事务的数据能持久保存,即使系统崩溃也能通过重做日志恢复数据。其工作原理是记录数据在内存中的更改,待事务提交时写入磁盘。此外,`Redo Log`采用简单的物理日志格式和高效的顺序IO,确保快速提交。通过不同的落盘策略,可在性能和安全性之间做出权衡。
1610 14
|
25天前
|
Python
log日志学习
【10月更文挑战第9天】 python处理log打印模块log的使用和介绍
25 0
|
27天前
|
数据可视化
Tensorboard可视化学习笔记(一):如何可视化通过网页查看log日志
关于如何使用TensorBoard进行数据可视化的教程,包括TensorBoard的安装、配置环境变量、将数据写入TensorBoard、启动TensorBoard以及如何通过网页查看日志文件。
147 0
|
30天前
|
存储 分布式计算 NoSQL
大数据-136 - ClickHouse 集群 表引擎详解1 - 日志、Log、Memory、Merge
大数据-136 - ClickHouse 集群 表引擎详解1 - 日志、Log、Memory、Merge
35 0
|
1月前
|
缓存 Linux 编译器
【C++】CentOS环境搭建-安装log4cplus日志组件包及报错解决方案
通过上述步骤,您应该能够在CentOS环境中成功安装并使用log4cplus日志组件。面对任何安装或使用过程中出现的问题,仔细检查错误信息,对照提供的解决方案进行调整,通常都能找到合适的解决之道。log4cplus的强大功能将为您的项目提供灵活、高效的日志管理方案,助力软件开发与维护。
49 0
|
2月前
|
Java
日志框架log4j打印异常堆栈信息携带traceId,方便接口异常排查
日常项目运行日志,异常栈打印是不带traceId,导致排查问题查找异常栈很麻烦。