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 可复用的通信框架(序) 
  



相关实践学习
通过日志服务实现云资源OSS的安全审计
本实验介绍如何通过日志服务实现云资源OSS的安全审计。
目录
相关文章
|
Java 容器 Spring
ESFramework使用技巧(1)-- ESFramework 日志记录器的自动装配
ESFramework中很多重要的组件都配备了日志记录器IEsbLogger,用于记录框架运行时的错误和异常。这些重要组件都暴露了一个名为“EsbLogger”的属性,用于设值法注入日志记录器。
992 0
|
5月前
|
监控 容灾 算法
阿里云 SLS 多云日志接入最佳实践:链路、成本与高可用性优化
本文探讨了如何高效、经济且可靠地将海外应用与基础设施日志统一采集至阿里云日志服务(SLS),解决全球化业务扩展中的关键挑战。重点介绍了高性能日志采集Agent(iLogtail/LoongCollector)在海外场景的应用,推荐使用LoongCollector以获得更优的稳定性和网络容错能力。同时分析了多种网络接入方案,包括公网直连、全球加速优化、阿里云内网及专线/CEN/VPN接入等,并提供了成本优化策略和多目标发送配置指导,帮助企业构建稳定、低成本、高可用的全球日志系统。
625 54
|
11月前
|
XML 安全 Java
【日志框架整合】Slf4j、Log4j、Log4j2、Logback配置模板
本文介绍了Java日志框架的基本概念和使用方法,重点讨论了SLF4J、Log4j、Logback和Log4j2之间的关系及其性能对比。SLF4J作为一个日志抽象层,允许开发者使用统一的日志接口,而Log4j、Logback和Log4j2则是具体的日志实现框架。Log4j2在性能上优于Logback,推荐在新项目中使用。文章还详细说明了如何在Spring Boot项目中配置Log4j2和Logback,以及如何使用Lombok简化日志记录。最后,提供了一些日志配置的最佳实践,包括滚动日志、统一日志格式和提高日志性能的方法。
2976 31
【日志框架整合】Slf4j、Log4j、Log4j2、Logback配置模板
|
10月前
|
监控 安全 Apache
什么是Apache日志?为什么Apache日志分析很重要?
Apache是全球广泛使用的Web服务器软件,支持超过30%的活跃网站。它通过接收和处理HTTP请求,与后端服务器通信,返回响应并记录日志,确保网页请求的快速准确处理。Apache日志分为访问日志和错误日志,对提升用户体验、保障安全及优化性能至关重要。EventLog Analyzer等工具可有效管理和分析这些日志,增强Web服务的安全性和可靠性。
259 9
|
8月前
|
存储 SQL 关系型数据库
MySQL日志详解——日志分类、二进制日志bin log、回滚日志undo log、重做日志redo log
MySQL日志详解——日志分类、二进制日志bin log、回滚日志undo log、重做日志redo log、原理、写入过程;binlog与redolog区别、update语句的执行流程、两阶段提交、主从复制、三种日志的使用场景;查询日志、慢查询日志、错误日志等其他几类日志
638 35
MySQL日志详解——日志分类、二进制日志bin log、回滚日志undo log、重做日志redo log
|
12月前
|
XML JSON Java
Logback 与 log4j2 性能对比:谁才是日志框架的性能王者?
【10月更文挑战第5天】在Java开发中,日志框架是不可或缺的工具,它们帮助我们记录系统运行时的信息、警告和错误,对于开发人员来说至关重要。在众多日志框架中,Logback和log4j2以其卓越的性能和丰富的功能脱颖而出,成为开发者们的首选。本文将深入探讨Logback与log4j2在性能方面的对比,通过详细的分析和实例,帮助大家理解两者之间的性能差异,以便在实际项目中做出更明智的选择。
1075 3
|
7月前
|
监控 Java 应用服务中间件
Tomcat log日志解析
理解和解析Tomcat日志文件对于诊断和解决Web应用中的问题至关重要。通过分析 `catalina.out`、`localhost.log`、`localhost_access_log.*.txt`、`manager.log`和 `host-manager.log`等日志文件,可以快速定位和解决问题,确保Tomcat服务器的稳定运行。掌握这些日志解析技巧,可以显著提高运维和开发效率。
547 13
|
7月前
|
缓存 Java 编译器
|
8月前
|
存储 缓存 关系型数据库
图解MySQL【日志】——Redo Log
Redo Log(重做日志)是数据库中用于记录数据页修改的物理日志,确保事务的持久性和一致性。其主要作用包括崩溃恢复、提高性能和保证事务一致性。Redo Log 通过先写日志的方式,在内存中缓存修改操作,并在适当时候刷入磁盘,减少随机写入带来的性能损耗。WAL(Write-Ahead Logging)技术的核心思想是先将修改操作记录到日志文件中,再择机写入磁盘,从而实现高效且安全的数据持久化。Redo Log 的持久化过程涉及 Redo Log Buffer 和不同刷盘时机的控制参数(如 `innodb_flush_log_at_trx_commit`),以平衡性能与数据安全性。
279 5
图解MySQL【日志】——Redo Log

热门文章

最新文章