如何使用Sentry 监控你的Spring Boot应用

 更新时间:2020年11月09日 09:58:22   作者:Nosa  
这篇文章主要介绍了如何使用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应用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • SpringBoot 枚举类型的自动转换的实现

    SpringBoot 枚举类型的自动转换的实现

    一般我们在数据库都会定义数值型的枚举常量,不管是序列化还是反序列化都是需要我们手动去转换成枚举类型的,本文主要介绍了Spring Boot 枚举类型的自动转换,感兴趣的可以了解一下
    2022-03-03
  • ApiOperation和ApiParam注解依赖的安装和使用以及注意事项说明

    ApiOperation和ApiParam注解依赖的安装和使用以及注意事项说明

    这篇文章主要介绍了ApiOperation和ApiParam注解依赖的安装和使用以及注意事项说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-09-09
  • Java继承的实现与继承限制分析

    Java继承的实现与继承限制分析

    这篇文章主要介绍了Java继承的实现与继承限制,结合具体实例形式分析了Java继承的定义、实现以及继承的相关限制,需要的朋友可以参考下
    2019-01-01
  • Java 图片压缩实现思路及代码

    Java 图片压缩实现思路及代码

    本文为大家详细介绍下图片压缩的具体实现思路及java代码,想学习的各位可以参考下哈,希望对大家有所帮助
    2013-07-07
  • Java并发编程Lock Condition和ReentrantLock基本原理

    Java并发编程Lock Condition和ReentrantLock基本原理

    这篇文章主要介绍了Java并发编程Lock Condition和ReentrantLock基本原理,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-09-09
  • Java中Boolean与字符串或者数字1和0的转换实例

    Java中Boolean与字符串或者数字1和0的转换实例

    下面小编就为大家带来一篇Java中Boolean与字符串或者数字1和0的转换实例。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-07-07
  • 七个Spring核心模块详解

    七个Spring核心模块详解

    这篇文章主要为大家详细介绍了七个Spring的核心模块,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-03-03
  • spring应用中多次读取http post方法中的流遇到的问题

    spring应用中多次读取http post方法中的流遇到的问题

    这篇文章主要介绍了spring应用中多次读取http post方法中的流,文中给大家列举处理问题描述及解决方法,需要的朋友可以参考下
    2018-11-11
  • 带你入门Java的集合

    带你入门Java的集合

    Java的集合类型都是对java.util包中Collection接口的继承,这里我们主要介绍依赖于collection的一些主分支,一起来看一下Java中的collection集合类型总结
    2021-07-07
  • 浅谈Java父子类加载顺序

    浅谈Java父子类加载顺序

    本文主要介绍了Java父子类加载顺序,那么这么长怎么记呀?本文就帮大家总结一下,更有利于记忆,感兴趣的可以了解一下
    2021-08-08

最新评论