从零构建Sentry v10 进行异常上报

简介

Sentry 是一个开源的实时错误追踪系统，能够帮助开发者实时监控并修复异常问题。它主要专一于持续集成、提升效率而且提高用户体验。

下面是Sentry官网支持的产品

使用官网服务

做为大多数我的开发者和中小企业，能够直接使用Sentry官网)提供的云服务，你只须要注册一个Sentry帐号，就能够快速享受到集中处理异常日志的服务。

本地安装Sentry服务

官网支持docker与python安装两种方式，这里采用docker的方式
具体有什么疑问能够查看官网https://docs.sentry.io/server/installation/

安装docker

具体能够看以前记录的文章重头开始学Docker

安装docker-compose

• 安装wget

yum -y install wget

• 安装pip

# 若是使用 wget下载https开头的网址域名 时报错，你须要加上 --no-check-certificate (不检查证书)选项
wget https://bootstrap.pypa.io/get-pip.py --no-check-certificate  # 下载文件

python get-pip.py #执行安装

pip -V #查看pip版本

• 安装docker-compose

sudo pip install docker-compose # 安装 docker-compose
docker-compose -v #查看docker-compose 版本

注意这里我在安装docker-compose报了这个错误

执行以下命令

sudo pip install --ignore-installed requests

安装完成以后再安装docker-compose

参考至:https://blog.csdn.net/guoshaoliang789/article/details/96878731

构建Sentry

• 从github上拉取源码

git clone https://github.com/getsentry/onpremise.git

注意你须要保证你的Docker 17.05.0+ Compose 1.19.0+ 同时还须要拥有least 2400MB RAM

下载完成以后进入该目录。查看文件以下

• 开始构建镜像

docker-compose build --pull

可是出了个问题,问题描述说是仓库不存在或可能须要“docker登陆”:拒绝:请求访问的资源被拒绝

尝试解决问题：先执行登陆操做

docker login

登陆成功以后再次执行以前的命令，发现仍是报错，咱们搜索一下Docker网站上关于sentry-onpremise-local镜像，咱们手动去pull

执行以下命令

docker image pull viitanener/sentry-onpremise-local

拉取成功以后，再次执行以前的命令。

参考至https://www.cnblogs.com/meloncodezhang/p/11229778.html

最后发现仍是没用，可是在github issues中发现了一样的问题

这是问题连接https://github.com/getsentry/onpremise/issues/278

执行以下命令

docker-compose build --pull --force-rm web
docker-compose build --force-rm

发现build成功

• 生成秘钥

进入sentry文件夹，将默认的config.example.yml和sentry.conf.example.py重命名为config.yml和sentry.conf.py。执行以下命令

cp config.example.yml config.yml
cp sentry.conf.example.py sentry.conf.py

执行以下命令生成秘钥

docker-compose run --rm web config generate-secret-key

将生成的秘钥添加到config.yml的system.secret-key字段上

• 进行 Web 服务迁移

执行以下命令开始服务迁移

docker-compose run --rm web upgrade

正常状况下是会出现输入帐号密码的步骤的，若是不能够请详细查阅这个issue

执行如下命令

docker-compose run --rm web createuser

• 运行 sentry

docker-compose up -d

• 注意：错误解决

执行以后发现以下问题，判断多是docker没有启动的问题

执行以下命令

service docker status  # 查看docker服务是否启动
systemctl start docker # 启动docker

再次执行安装

又发生以下错误

执行以下命令

dig @114.114.114.114 registry-1.docker.io

将上诉几个地址写入hosts文件后再次安装

• 部署Sentry成功

打开浏览器输入ip:9000,以下图说明安装成功

注意，若是没有打开，请检查服务器防火墙与安全组是否开放9000端口

1. Root URL:默认为部署的地址，后面会用到，sentryclirc文件里的url属性
2. Admin Email 管理员邮箱
3. Email From 邮件的发送地址息，填邮箱服务商的地方好比smtp.qq.com
4. SMTP PORT Smtp服务的端口默认25,使用tls就是567
5. SMTP username 用户名 qq邮箱帐号
6. SMTP password 密码 qq邮箱受权码（不是密码）

• 修改邮箱设置

打开sentry/config.yml文件，编辑以下信息：

具体配置查看这里https://docs.sentry.io/server/config/#mail

注意要将服务器防火墙与服务器安全组的邮箱端口放开，

注意：若是使用Sentry10的话 使用tsl邮箱端口必须为567否则会报错

从新执行如下命令

docker-compose build --pull --force-rm web
docker-compose build --force-rm
docker-compose run --rm web upgrade
docker-compose up -d

能够看到邮箱信息已经修改掉了，下面咱们发送一封测试邮件，点击下方的Test Settings

至此，邮箱服务也修改完成

Sentry使用

建立项目

• 开始建立，选择Project->React->Create Project

• SDK的使用

• DSN地址

• org组织名称

• project项目名称

• Create Token建立token

务必勾选project:write

前端进行使用

安装webpack插件

npm install @sentry/webpack-plugin -S

添加.sentryclirc文件

[defaults]
url=sentry 服务的url #好比安装的是192.168.0.1:9000
project = 项目名字
org= 项目组织 上面有写在哪能够取到

[auth]
token=api token # 登陆控制台获取

• 关于url:就是你部署Sentry的地址
• 关于project:
• 关于org：
• 关于token：

修改.umirc.js文件

const SentryPlugin = require('@sentry/webpack-plugin');
export default {
  chainWebpack(config, { webpack }){
    // 拿不到process.env.RELEASE_VERSION
    if (process.env.UMI_ENV == 'prod'){
      config.plugin("sentry").use(SentryPlugin, [{
        ignore: ['node_modules'],
        include: './dist', //上传dist文件的js
        configFile: './sentryclirc', 
        release:release, // 版本号
        deleteAfterCompile: true,
        urlPrefix: '~/static/' //静态资源路径前缀
       }])
    }
  },
 }

• 关于urlPrefix若是你的静态资源是htps://cdn.xxx.com/static/那么该值就是~/static/，自动省去协议与主机地址

安装@sentry/browser

使用的时候须要结合这个包使用

npm i @sentry/browser -S

使用

• 在项目的根文件下使用

import * as Sentry from '@sentry/browser';

const SENTRYSDK = '就是Sentry配置的DSN'

Sentry.init({dsn:SENTRYSDK,release: process.env.RELEASE_VERSION,debug: true,});

• 结合React的生命周期使用

componentDidCatch(error, errorInfo) {
    Sentry.withScope((scope) => {
      scope.setExtras(errorInfo);
      const eventId = Sentry.captureException(error);
      this.setState({ eventId });
    });
}

• 主动上报

Sentry.captureMessage('Hello, world!'); // 上报信息
Sentry.captureException(new Error('Good bye')); // 上报异常
Sentry.captureEvent({ // 上报事件
  message: 'Manual',
  stacktrace: [
    // ...
  ],
});

关于

• 本文首发于使用Sentry进行异常上报
• 参考以下：Sentry 入门实战