Sentry 是一个实时事件日志记录和汇集的平台。其专注于错误监控以及提取一切事后处理所需信息而不依赖于麻烦的用户反馈。
Sentry是一个日志平台, 它分为客户端和服务端,客户端(目前客户端有Python, PHP,C#, Ruby等多种语言)就嵌入在你的应用程序中间,程序出现异常就向服务端发送消息,服务端将消息记录到数据库中并提供一个web节目方便查看。Sentry由python编写,源码开放,性能卓越,易于扩展,目前著名的用户有Disqus, Path, mozilla, Pinterest等。
通过docker安装
官方提供了 On-Premise 安装方式
git clone https://github.com/getsentry/onpremise
cd onpremise
然后创建volume,持久化存储
docker volume create --name=sentry-data && docker volume create --name=sentry-postgres
创建环境变量配置文件:
cp -n .env.example .env - create env config file
docker-compose build镜像,这一步会拉取官方镜像和redis等依赖,耐心等待:
docker-compose build - Build and tag the Docker services
创建secret-key,执行后得到一个key,添加到.env中的SENTRY_SECRET_KEY
docker-compose run --rm web config generate-secret-key
创建DB和初始化用户,等待创建数据库和
docker-compose run --rm web upgrade
Created internal Sentry project (slug=internal, id=1)
Would you like to create a user account now? [Y/n]: y
Email:
Password:
Repeat for confirmation:
Should this user be a superuser? [y/N]: y
User created: [email protected]
Added to organization: sentry
Running migrations for sentry.nodestore:
- Migrating forwards to 0001_initial.
最后-d启动,启动成功后可以访问http://server-ip:9000
docker-compose up -d
访问:
创建项目并集成
先创建一个project,支持多种语言,我们创建一个java的
DSN(Client Keys)
DSN格式为:
DSN="https://public:private@host:port/project_id"
可以在项目的setting-Client Keys(DSN)里查看。
然后根据格式拼成DSN即可。
java项目集成
有多种集成方式:
基本集成方式
添加maven引用:
<dependency>
<groupId>io.sentry</groupId>
<artifactId>sentry</artifactId>
<version>1.7.16</version>
</dependency>
然后在全局异常处理里集成:
String dsn = "http://<SENTRY_PUBLIC_KEY>:<SENTRY_PRIVATE_KEY>@host:port/<PROJECT_ID>";
Sentry.init(dsn);
在有异常的地方:
try {
unsafeMethod();
} catch (Exception e) {
// This sends an exception event to Sentry using the statically stored instance
// that was created in the ``main`` method.
Sentry.capture(e);
}
logback集成
logback配置:
<configuration>
<appender name="Console" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<appender name="Sentry" class="io.sentry.logback.SentryAppender">
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>WARN</level>
</filter>
</appender>
<root level="DEBUG">
<appender-ref ref="Console" />
<appender-ref ref="Sentry"/>
</root>
</configuration>
spring-boot集成
先添加引用:
<dependency>
<groupId>io.sentry</groupId>
<artifactId>sentry-spring</artifactId>
<version>1.7.16</version>
</dependency>
在Application里集成:
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletContextInitializer;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.HandlerExceptionResolver;
@Controller
@EnableAutoConfiguration
@SpringBootApplication
public class Application {
/*
Register a HandlerExceptionResolver that sends all exceptions to Sentry
and then defers all handling to the other HandlerExceptionResolvers.
You should only register this is you are not using a logging integration,
otherwise you may double report exceptions.
*/
@Bean
public HandlerExceptionResolver sentryExceptionResolver() {
return new io.sentry.spring.SentryExceptionResolver();
}
/*
Register a ServletContextInitializer that installs the SentryServletRequestListener
so that Sentry events contain HTTP request information.
This should only be necessary in Spring Boot applications. "Classic" Spring
should automatically load the `io.sentry.servlet.SentryServletContainerInitializer`.
*/
@Bean
public ServletContextInitializer sentryServletContextInitializer() {
return new io.sentry.spring.SentryServletContextInitializer();
}
@RequestMapping("/")
@ResponseBody
String home() {
int x = 1 / 0;
return "Hello World!";
}
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
前端项目集成
前端集成更简单,引用sentry的js,然后init即可
<script src="https://browser.sentry-cdn.com/5.1.0/bundle.min.js" crossorigin="anonymous"></script>
Sentry.init({ dsn: 'dsn' });