如何使用Sentry 监控你的Spring Boot应用
Sentry是一个应用监控系统,可以用于前后端各种技术栈的线上监控和错误分析,这次我们用它来进行Spring Boot项目的线上日志分析实践。
创建项目
首先需要根据提示在Sentry中创建好项目,项目平台(platform)可以选择Spring Boot或者Java。
引入依赖&配置
Sentry提供了官方的Spring Boot Starter。
<dependency> <groupId>io.sentry</groupId> <artifactId>sentry-spring-boot-starter</artifactId> <version>3.1.1</version> </dependency>
除此之外,我们还需要配置application.properties,将我们在Sentry中创建的项目密钥(DSN)导入:
sentry.dsn=https://key@host/id
第一个错误
编写我们的Controller,尝试抛出一个简单的异常。
@RestController public class HelloController { @RequestMapping("/") public void test() { throw new IllegalArgumentException("hello world"); } }
如果之前的配置没有问题,那么我们就可以在Sentry的「Issue」面板上面看到这个异常信息。
点击这个异常即可查看详细信息。可以看到这个异常的一些基本信息,比如说「用户信息(这里未设置)」、「用户环境」、「标签(Tag)」、「调用栈跟踪(StackTrace)」、「日志片(Breadcrumbs)」、「请求Headers」,以及一些用户可以自定义的内容(叫做Context)。
这里要介绍一下Sentry中的一个概念,首先,在相同地方产生的异常会被归纳为一个「Issue」,每次在这个地方产生的异常叫做「Event」。所以在同一个地方触发两次异常,仍然只有一个Issue,但是可以在Event页面看到两个事件。
自定义用户信息
既然已经知道了这个异常,我们也是希望了解是哪位用户触发的异常。Sentry SDK提供了SentryUserProvider,可以用于异常时用户信息的提供,我们只需要配置一个Bean。
@Bean public SentryUserProvider sentryUserProvider(){ return () -> { // 实际的用户信息,可能要通过其他方式获得 User user = new User(); user.setId("userId"); user.setUsername("张三"); user.setEmail("zhangsan@gmail.com"); return user; }; }
再次触发异常,我们得到了用户信息。
自定义Tag以便利用Tag筛选异常
随着异常信息的增多,我们希望能够筛选出一些特定的异常信息,Sentry提供了「标签(Tag)」功能,可以根据标签进行筛选。虽然自带的Tags已经够多,但是我们还是希望能够根据业务需求自定义一些,当然Sentry SDK提供了BeforeSendCallback,我们可以借此添加一些Tag。
@Bean public SentryOptions.BeforeSendCallback beforeSendCallback(){ return (event, hint) -> { event.setTag("name","zhangsan"); return event; }; }
可以看到我们的Tag已经成功地添加了,点击这个Tag可以找到所有含有这个Tag的Event。
整合Logback
我们现有的Spring Boot业务中可能涵盖了异常处理,大部分异常可能直接作为一个日志的形式记录下来了。当然Sentry也提供了Logback/Log4j2这类日志框架的支持。只需要导入对应的依赖即可,我们这里使用Logback作为例子。
<dependency> <groupId>io.sentry</groupId> <artifactId>sentry-logback</artifactId> <version>3.1.1</version> </dependency>
Sentry Spring Boot Starter会自动监测依赖并为我们配置好相应的配置,我们直接就可以用log代替原有的异常抛出了。
@RestController public class HelloController { private static Logger logger = LoggerFactory.getLogger(HelloController.class); @RequestMapping("/") public void test(){ logger.error("Logback error!"); } }
这里比较有意思的一点是,对于未处理的野异常,Sentry会给他一个fatal的等级,而引入Logback后,会采用logger的日志等级。
通过在配置文件中配置minimum-event-level和minimum-breadcrumb-level,我们可以指定哪些log级别会产生一次「Event」,哪些log级别会记录下一个「日志片(Breadcrumbs)」,注意前提是logger的级别低于或等于这个级别(否则也收集不到)。
sentry.logging.minimum-event-level=info sentry.logging.minimum-breadcrumb-level=debug
自建Sentry
Sentry除了官方版以外,也可以自建自托管版本的Sentry。官方版存在用量限制,可能需要付费;自托管版没有用量限制,但是官方不提供技术支持。自建Sentry也非常简单,需要Docker和Docker Compose,硬件上需要至少2.4G空闲内存。
git clone https://github.com/getsentry/onpremise.git cd onpremise ./install.sh
之后就可以在localhost:9000上看到自建的Sentry了,可以配合Nginx反向代理调整端口到80/443使用。
官方文档
本文仅介绍了一些常用的功能,有关Sentry的更多功能建议参考官方文档: docs.sentry.io
到此这篇关于如何使用Sentry 监控你的Spring Boot应用的文章就介绍到这了,更多相关Sentry 监控Spring Boot应用内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞!
相关文章
- 这篇文章主要介绍了Spring AOP 对象内部方法间的嵌套调用方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-08-29
解决springboot使用logback日志出现LOG_PATH_IS_UNDEFINED文件夹的问题
这篇文章主要介绍了解决springboot使用logback日志出现LOG_PATH_IS_UNDEFINED文件夹的问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-04-28Spring Cloud 中@FeignClient注解中的contextId属性详解
这篇文章主要介绍了Spring Cloud 中@FeignClient注解中的contextId属性详解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-25Springboot如何实现Web系统License授权认证
这篇文章主要介绍了Springboot如何实现Web系统License授权认证,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-05-28- 这篇文章主要为大家详细介绍了SpringBoot实现excel文件生成和下载,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...2021-02-09
如何在Spring WebFlux的任何地方获取Request对象
这篇文章主要介绍了如何在Spring WebFlux的任何地方获取Request对象,帮助大家更好的理解和使用springboot框架,感兴趣的朋友可以了解下...2021-01-26- 这篇文章主要介绍了详解springBoot启动时找不到或无法加载主类解决办法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-09-16
- 这篇文章主要介绍了详解SpringCloudGateway内存泄漏问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-07-16
- 这篇文章主要介绍了SpringBoot集成Redis实现消息队列的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-02-10
- 这篇文章主要介绍了解决Springboot get请求是参数过长的情况,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-09-17
- @Autowired 注解的主要功能就是完成自动注入,使用也非常简单,但这篇文章主要给大家介绍了关于Spring为什么不推荐使用@Autowired注解的相关资料,需要的朋友可以参考下...2021-11-03
Spring Boot项目@RestController使用重定向redirect方式
这篇文章主要介绍了Spring Boot项目@RestController使用重定向redirect方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-02- 这篇文章主要介绍了Springboot+TCP监听服务器搭建过程,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2020-10-28
- 这篇文章主要介绍了springBoot 项目排除数据库启动方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-10
Springboot如何使用mybatis实现拦截SQL分页
这篇文章主要介绍了Springboot使用mybatis实现拦截SQL分页,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-06-19springboot中使用@Transactional注解事物不生效的坑
这篇文章主要介绍了springboot中使用@Transactional注解事物不生效的原因,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-01-26- 这篇文章主要介绍了SpringBoot接口接收json参数解析,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-10-19
详解SpringBoot之访问静态资源(webapp...)
这篇文章主要介绍了详解SpringBoot之访问静态资源(webapp...),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-09-14C#使用FileSystemWatcher控件实现的文件监控功能示例
这篇文章主要介绍了C#使用FileSystemWatcher控件实现的文件监控功能,结合实例形式分析了C# FileSystemWatcher组件的功能及监控文件更改情况的具体使用技巧,需要的朋友可以参考下...2020-06-25- 这篇文章主要介绍了SpringMVC文件上传原理及实现过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-07-15