一个针对异常信息通知的springboot starter

作为后端开发者,项目上线之后难免会遇到各种问题,一个良好且及时的异常通知机制可以让我们在项目的维护上避免很多不必要的麻烦。

本项目的开发愿景是为了给使用者在线上项目的问题排查方面能够带来帮助,简单配置,做到真正的开箱即用,同时异常信息尽量详细,帮助开发者快速定位问题。

目前支持基于钉钉和邮箱的异常通知,以后有时间还会扩展其他通知方式,同时也欢迎有兴趣的开发者能够参与进来,共同完善

使用方式

pom.xml中增加项目依赖

本项目现已发布到maven中央仓库,可以直接通过以下坐标引入依赖

<dependency>
     <groupId>com.github.kongchong</groupId>
     <artifactId>exception-notice-spring-boot-starter</artifactId>
     <version>版本号</version>
  </dependency>
复制代码

钉钉配置

第一步:创建钉钉群 并在群中添加自定义机器人 对于不太了解钉钉机器人配置的同学可以参考:钉钉机器人

第二步:增加配置文件

以下以yml配置文件的配置方式为例

exception:
  notice:
    enable: 启用开关 false或不配置的话本项目不会生效
    projectName: 指定异常信息中的项目名,不填的话默认取 spring.application.name的值
    included-trace-package: 追踪信息的包含的包名,配置之后只通知此包下的异常信息
    period: 异常信息发送的时间周期 以秒为单位 默认值5,异常信息通知并不是立即发送的,默认设置了5s的周期,主要为了防止异常过多通知刷屏,同时钉钉针对异常通知刷屏的情况也增加了限流措施,建议不要修改
    exclude-exceptions:
      - 需要排除的异常通知,注意 这里是异常类的全路径,可多选
    ## 钉钉配置
    ding-talk:
      web-hook: 钉钉机器人的webHook地址,可依次点击钉钉软件的头像,机器人管理,选中机器人来查看
      at-phones: 
        - 钉钉机器人发送通知时 需要@的钉钉用户账户,可多选

复制代码

邮箱配置

这里以qq邮箱为例

第一步:项目中引入邮箱相关依赖

<dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-mail</artifactId>
  </dependency>
复制代码

第二步:增加配置文件

exception:
  notice:
    enable: 启用开关 false或不配置的话本项目不会生效
    projectName: 指定异常信息中的项目名,不填的话默认取 spring.application.name的值
    included-trace-package: 追踪信息的包含的包名,配置之后只通知此包下的异常信息
    period: 异常信息发送的时间周期 以秒为单位 默认值5,异常信息通知并不是立即发送的,默认设置了5s的周期,主要为了防止异常过多通知刷屏,同时钉钉针对异常通知刷屏的情况也增加了限流措施,建议不要修改
    exclude-exceptions:
      - 需要排除的异常通知,注意 这里是异常类的全路径,可多选
    ## 邮箱配置
    mail:
      from: 发送人地址
      to: 接收人地址
      cc: 抄送人地址
spring:
 mail:
   host: smtp.qq.com  邮箱server地址 
   username: 1182701220@qq.com  server端发送人邮箱地址
   password: 邮箱授权码

复制代码

邮箱授权码可以按以下方法获取

打开QQ邮箱网页→设置→账户→POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务→开启POP3/SMTP服务,然后就能看到授权码了

注意:钉钉和邮箱配置支持单独和同时启用

配置好了配置文件,接下来可以写个例子测试一下了

一个针对异常信息通知的springboot starter

如上图所示,在一个测试方法中手动抛出了一个参数错误异常,接下来运行一下看一下效果

钉钉效果:

一个针对异常信息通知的springboot starter

邮箱效果:

一个针对异常信息通知的springboot starter

由于报错太多没有全部截图下来,感兴趣的同学可以自行测试一下

原文 

https://juejin.im/post/5d66388be51d453b8b5fa604

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » 一个针对异常信息通知的springboot starter

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址